telegram/
channel-posts

The Telegram Channel Scraper API collects a public Telegram channel's posts from the latest backwards, up to 1,000 per task, with text, publish time, views, total reactions and attached photos and videos.

Telegram Channel Scraper API

Up to 1,000 posts
Newest first
Views and reactions
Photos and videos
0.3 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Telegram Channel Scraper

Telegram Channel Scraper reads the feed of a public broadcast channel, where each post carries its text, publish time, view count, reaction total and any photos or videos. Views and reactions across a run of posts show what a channel's audience actually reads and responds to, which feeds daily digests, content benchmarking and historical archives.

Telegram Channel Scraper API Features

  • Newest posts first, up to 1,000results_limit sets how many posts to collect, from 1 to 1000 with a default of 20, and the feed is read backwards from the most recent post.
  • Views as whole numbersmetrics.views_count converts Telegram's short counters such as 661K into integers, so posts can be compared and summed directly.
  • Reaction totals including Starsmetrics.likes_count adds up every reaction on the post, emoji and paid Star reactions alike, as one engagement figure.
  • Photos and videos per postmedia lists each attached item with its type, image or video, and a direct file URL.
  • Stable post IDsEach row's id combines the channel and post number, such as durov/564, and url links straight to the post.

Telegram Channel Scraper API Parameters

ParametersRequiredDescription
urlRequiredOne public Telegram channel link, such as https://t.me/durov; the t.me/s/, telegram.me and telegram.dog forms work too.
results_limitOptionalNumber of posts to collect, newest first. Integer from 1 to 1000, default 20.

How to Use the Telegram Channel Scraper API

Send one channel link and a post limit to the Telegram Channel Scraper API, then read the posts newest first.

  1. POST {"url": "https://t.me/durov", "results_limit": 20} to /v1/telegram/channel-posts.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read the posts from results.items, and while has_more is true pass results.next_cursor to load the next page.
curl -X POST "https://api.socq.ai/v1/telegram/channel-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://t.me/durov","results_limit":20}'

Telegram Channel Scraper API Use Cases

  • Daily channel digest: Pull the last 20 to 50 posts each morning with the Telegram Channel Scraper API and summarize what a set of news or market channels published overnight.
  • Benchmarking content by views: Rank a channel's recent posts by views_count and likes_count to see which formats and topics hold its readers.
  • Back-filling a channel archive: Set a large results_limit once to capture a channel's history, then collect only recent posts on later runs.
  • Monitoring announcement channels: Watch project or brand channels for new posts and route their text and links into alerts or a research database.

Telegram Channel Scraper API Pro Tips

  • Compare published_at with your previous run and stop storing once you reach posts you already have, which keeps scheduled Telegram Channel Scraper API runs small and cheap.
  • Download any photos or videos you want to keep soon after collection, because Telegram's file links expire after a while.
  • Views and reactions are the counts at collection time, so save collected_at with every snapshot and benchmark posts of similar age.

Beyond the Telegram Channel Scraper API, use these APIs when you need a different type of public Telegram data.

  • Telegram Channel Info API — Look up up to 50 public Telegram channels by link for title, description, avatar, verification badge and subscriber count as a whole number.
  • Telegram Post Detail API — Fetch up to 50 specific Telegram posts by link, from any mix of public channels, with full text, publish time, views, reactions and media.
  • Telegram Comments API — Collect up to 100 comments under a Telegram channel post from its discussion group, with author name, text, time, reactions and reply target.
  • Telegram Similar Channels API — Find the channels Telegram recommends next to a public channel, usually around ten, each with title, verification badge and exact subscriber count.
  • Telegram Channel Search API — Search a public Telegram channel's full post history for a word or phrase and get up to 100 matching posts with text, date, views and reactions.

Explore other platforms

Combine Telegram data with public data from other supported social platforms.

Telegram Channel Scraper API — FAQ

Telegram Channel Scraper API is a programmatic interface for collecting the posts of a public Telegram channel, newest first, up to 1,000 per task. Each post includes its text, publish time, view count, reaction total and attached media.

Between 1 and 1,000, set with results_limit; the default is 20. Posts are returned newest first, so a small limit gives you the latest activity.

On Telegram, likes_count holds the total of every reaction on the post, combining emoji reactions and paid Star reactions in one number.

Public channels, given as a t.me/name, t.me/s/name, telegram.me or telegram.dog link. When a channel cannot be read, for example because it is private, the task fails and the credits are refunded.

Photo and video URLs point to Telegram's file servers and expire after some time. Download the files you need soon after the task finishes.

The Telegram Channel Scraper API charges 0.3 credits for each post returned, so the default 20 posts cost 6 credits and 1,000 posts cost 300 credits.