subimpact WhatsApp us

Telegram Channel Scraper: Posts, Views & Media

The Telegram Channel Scraper reads public channels through their t.me web preview and returns one row per post with text, postedAt, views as an integer plus the printed viewsText, mediaType, photo and video thumbnail URLs, document names, link previews, polls with percentages, reactions, hashtags, mentions and outgoing links, plus an optional channel row with subscribers and media counters. Posts cost $0.30 per 1,000. Run it from Apify Console or the API.

from $0.0003 per post, $0.3 per 1,000 Ā· Updated Nov 2026, version 0.1.4

Key facts

Price
from $0.0003 per post, $0.3 per 1,000
Pricing model
Pay per event
Output
JSON, CSV, Excel, XML, RSS via Apify datasets
Access
Apify Console, REST API, Python and JS clients, MCP tool telegram_channel
Version
Updated Nov 2026, version 0.1.4
Usage
100.0% successful runs (30 days)
Actor
subimpact/telegram-channel-scraper

Who it is for

  • Brands monitoring public Telegram channels in their market
  • OSINT and research teams collecting public channel timelines
  • Content analysts tracking view counts and reaction mix per post
  • Crypto and news desks watching announcement channels for new posts

Use cases

Collect a channel timeline

Put handles or links in channels, as durov, @durov or https://t.me/s/durov, and set maxPostsPerChannel to 100. Rows arrive newest first with postId, postUrl, postedAt, text and views, where views is an integer parsed from the printed figure such as 5.84M. Use maxTotalPosts as a global cap across several channels.

Monitor for new posts on a schedule

Set onlyNew true and the actor delivers only posts newer than the highest post id it already delivered for that channel, storing the cursor in stateStoreName. A scheduled hourly run then returns a handful of new posts instead of the whole timeline, and the cursor does not move backwards after a failed page.

Search inside a channel

Set searchQuery to a phrase and the actor uses Telegram's own in-channel search, paging the same way and combining with postedAfter and postedBefore. Results come back oldest to newest, so add postedAfter 2026-10-18 to keep one week. Search applies to channel timelines only, and a single post URL returns just that post.

Read engagement beyond view counts

reactions is a list of emoji and count pairs, with paid star reactions reported as stars and custom emoji as an emoji id. polls come back with the question and each option's percentage, and viewsText keeps Telegram's own formatting. Together they show what a channel's audience actually engages with, not only how many scrolled past.

Track a channel's growth profile

Turn on includeChannelInfo to get one channel row per channel with description, subscribers as an integer, photosCount, videosCount, linksCount, avatarUrl and isVerified. Re-running weekly on the same list shows subscriber movement against posting volume, which is a cheap read on whether a channel is growing organically or by promotion.

Output fields

FieldTypeDescription
recordType string post for a message row, channel for a channel-info row
channel string Channel username without the @, e.g. durov
channelTitle string/null Channel display name, e.g. Pavel Durov
postId integer/null Telegram message id inside the channel (post rows only)
postUrl string/null Canonical public link, https://t.me/<channel>/<postId> (post rows only)
postedAt string/null Publication time from the post's <time datetime> attribute, ISO 8601 UTC (post rows only)
isEdited boolean/null True when Telegram marks the post as edited (post rows only)
editedAt string/null Edit timestamp. The t.me web preview does not publish one, so this stays null; use isEdited to filter edited posts (post rows only)
text string/null Plain-text post body, line breaks kept, emoji kept, HTML stripped (post rows only)
views integer/null View count as an integer: 5.84M becomes 5840000 (post rows only)
viewsText string/null View count exactly as Telegram printed it, e.g. 5.84M (post rows only)
authorSignature string/null Signature shown under the post when the channel signs messages, e.g. Pavel Durov (post rows only)
Show all 36 fields
FieldTypeDescription
isForwarded boolean/null True when the post is a forward (post rows only)
forwardedFrom object/null Source of a forwarded post: {name, url}. Null when not forwarded or when Telegram hides the source name (post rows only)
replyToPostId integer/null Post id this message replies to, or null (post rows only)
mediaType string/null photo, video, document, audio, voice, sticker, poll, gif, mixed or none (post rows only)
photoUrls array/null Photo URLs taken from the message's background-image styles (post rows only)
videoThumbUrls array/null Video poster image URLs (post rows only)
videoDurationSec integer/null Video length in seconds when Telegram prints it, e.g. 0:08 becomes 8 (post rows only)
documentNames array/null File names of attached documents or audio tracks (post rows only)
linkPreview object/null Attached link preview: {url, siteName, title, description, imageUrl} (post rows only)
poll object/null Poll question and options with percentages: {question, options:[{text, percent}]} (post rows only)
reactions array/null Reactions as [{emoji, count}], emoji as the glyph when Telegram prints it, otherwise the emoji id or stars for paid reactions (post rows only)
hashtags array/null Hashtags found in the post text, without the # (post rows only)
mentions array/null Usernames mentioned in the post text, without the @ (post rows only)
links array/null Outgoing http(s) links found in the post text (not hashtags, mentions or the post's own link) (post rows only)
description string/null Channel bio shown in the web preview (channel rows only)
subscribers integer/null Subscriber count as an integer: 10.3M becomes 10300000 (channel rows only)
photosCount integer/null Photo counter from the channel page (channel rows only)
videosCount integer/null Video counter from the channel page (channel rows only)
linksCount integer/null Link counter from the channel page (channel rows only)
filesCount integer/null File counter from the channel page when Telegram shows one (channel rows only)
avatarUrl string/null Channel avatar image URL (channel rows only)
isVerified boolean/null True when the channel page carries Telegram's verified badge (channel rows only)
channelUrl string/null https://t.me/<channel> (channel rows only)
scrapedAt string/null When this row was scraped, ISO 8601 UTC

Sample output

From one of our own test runs on 20 Nov 2026, trimmed. Personal data is redacted.

2 rows, first 3 shown

[
  {
    "recordType": "post",
    "channel": "durov",
    "channelTitle": "Pavel Durov",
    "postId": 545,
    "postUrl": "https://t.me/durov/545",
    "postedAt": "2026-08-30T09:10:19.000Z",
    "isEdited": true,
    "editedAt": null,
    "text": "A high-school student just made $20,000 from a Telegram Gift.\n\nJonathan He, an IOI gold medalist ranked #7 in the world, sold his Algorithm Cup — an NFT we gave to the top young coders this month — for šŸ’Ž 15,000 Grams.\n\nHappy for him. It'...",
    "views": 3800000,
    "viewsText": "3.8M",
    "authorSignature": "Pavel Durov",
    "isForwarded": false,
    "forwardedFrom": null,
    "replyToPostId": null,
    "mediaType": "none",
    "photoUrls": [],
    "videoThumbUrls": [],
    "videoDurationSec": null,
    "documentNames": [],
    "linkPreview": null,
    "poll": null,
    "reactions": [
      {
        "emoji": "stars",
        "count": 4680
      },
      {
        "emoji": "emoji-id:5399847211989246390",
        "count": 44000
      },
      {
        "emoji": "emoji-id:5373223594484587136",
        "count": 13000
      },
      "..."
    ],
    "hashtags": [],
    "mentions": [],
    "links": [
      "https://stats.ioinformatics.org/people/9089",
      "https://t.me/nft/algorithmcup-7",
      "https://t.me/durov/540"
    ],
    "scrapedAt": "2026-11-20T02:44:54.298Z"
  },
  {
    "recordType": "post",
    "channel": "durov",
    "channelTitle": "Pavel Durov",
    "postId": 546,
    "postUrl": "https://t.me/durov/546",
    "postedAt": "2026-08-31T16:30:15.000Z",
    "isEdited": false,
    "editedAt": null,
    "text": "šŸ³ļø Gram Wallet in Telegram is ready and is now accessible to a select group of users.\n\n🤩 We'll be gradually rolling it out to our billion+ users over the next couple of weeks.\n\nāš”ļø Thanks to the validators who approved the smart contract ...",
    "views": 4920000,
    "viewsText": "4.92M",
    "authorSignature": "Pavel Durov",
    "isForwarded": false,
    "forwardedFrom": null,
    "replyToPostId": null,
    "mediaType": "video",
    "photoUrls": [],
    "videoThumbUrls": [
      "https://cdn4.telesco.pe/file/K8jvSnLU4oGGPbR-YQOHFJdkaMZYiERxF5XbGSAR5S2slYhCfzKaOQSUWSK5tK1DYkNzBSoqMPQ33ea_I4BjlZCL0UZFlpo4fm51msXCmePMTodMvNUif3zBPp1OWz1_tAORgpzoDNqop0YllgN63U9fC7ZIe_VIdbGoUL6pP1UGXPifjjWXTZYAjoY8RrpLCYgusNaPmSyYOuyB..."
    ],
    "videoDurationSec": 20,
    "documentNames": [],
    "linkPreview": null,
    "poll": null,
    "reactions": [
      {
        "emoji": "stars",
        "count": 35800
      },
      {
        "emoji": "emoji-id:5399847211989246390",
        "count": 29000
      },
      {
        "emoji": "emoji-id:5373223594484587136",
        "count": 9570
      },
      "..."
    ],
    "hashtags": [],
    "mentions": [],
    "links": [],
    "scrapedAt": "2026-11-20T02:44:54.298Z"
  }
]

Input

FieldTypeRequiredDescriptionDefault
channels array No Public channels to read. Any of these forms works: durov, @durov, t.me/durov, t.me/s/durov, https://t.me/durov, or a single post URL such as https://t.me/durov/531 (that post only). Private groups, invite links (t.me/+hash) and channels ... -
maxPostsPerChannel integer No How many posts to collect from each channel, newest first (1 to 10000). Telegram serves 20 posts per page, so this also decides how many pages are fetched. 50
maxTotalPosts integer No Hard cap on post rows across all channels in one run (1 to 1000000). The run stops cleanly when it is reached. 500
searchQuery string No Only posts matching this text, using Telegram's own in-channel search (t.me/s/?q=...). Works with paging and with every other option. Leave empty to read the channel timeline. -
postedAfter string No ISO date or date-time. Posts older than this are skipped, and paging stops as soon as a page reaches older posts. Example: 2026-08-01 or 2026-08-01T09:00:00Z. -
postedBefore string No ISO date or date-time. Newer posts are skipped (paging still starts from the newest page). Example: 2026-10-01. -
includeChannelInfo boolean No Push a channel row (title, description, subscriber count, media counters, avatar, verified flag) before that channel's posts. Costs one channel-info event per channel. true
onlyNew boolean No Deliver only posts newer than the highest post id already delivered for that channel. The cursor is kept in the named key-value store below, so scheduled runs return just the new posts. false
stateStoreName string No Name of the key-value store in your Apify account that keeps the per-channel post-id cursors. Leave the default unless you run several configurations of this actor and want separate cursors. telegram-channel-scraper-state
maxConcurrency integer No How many channels are fetched at the same time (1 to 10). Pages inside a channel are always fetched one after another with a short delay. 3
proxyConfiguration object No Direct requests are the default: t.me answered 10 of 10 parallel direct requests when this actor was built. Enable Apify proxy only if your runs are rate limited. A proxy failure fails the request; it never falls back to a direct request. {"useApifyProxy":false}

Example input

{
  "channels": [
    "durov",
    "telegram"
  ],
  "maxPostsPerChannel": 50,
  "maxTotalPosts": 500,
  "includeChannelInfo": true,
  "onlyNew": false,
  "stateStoreName": "telegram-channel-scraper-state",
  "maxConcurrency": 3,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Pricing

EventWhat it meansPriceLowest tier
post One public channel post delivered to the dataset. $0.0003 $0.0003
apify-actor-start Charged when the Actor starts running. Number of events charged depends on Actor memory (one event per GB, minimum one event). $0.00005 $0.00005
channel-info One channel information row delivered to the dataset. $0.001 $0.001

$0.3 for 1,000 posts at the listed price.

Prices from the Apify Store on 20 November 2026. Apify shows the final price before each run.

How it compares with other Apify actors

Price per 1,000 posts at Apify Store list prices. Every row is a live listing on the Store, read on 20 Nov 2026, so a buyer can check each number at the source.

Actor Price per 1,000 posts (Free plan) Higher plans (Gold) Start fee per run Platform usage Users Rating Last build
Telegram Channel Scraper: Public Posts, Views & Media This API Pay per event $0.3 $0.3 $0.00005 Included 1 No reviews yet 18 Nov 2026
Telegram Scraper Direct match, pay per event $5.00 $1.25 $0.0001 Included 5,127 2.8 (17 reviews) 29 Oct 2026
Telegram Keyword Search Scraper Direct match, pay per event $2.50 $2.50 $0.00005 Included 3,389 5.0 (1 review) 6 Nov 2026
Telegram Scraper: Channels, Messages, Comments & Profiles Direct match, pay per event $1.00 $0.522 $0.005 Included 1,477 5.0 (2 reviews) 12 Nov 2026
Telegram Channels Scraper: Messages, Contacts & Leads Direct match, pay per event $2.00 $1.50 $0.003 Included 508 No reviews yet 10 Nov 2026
Telegram Channel Scraper & Keyword Search — No Login Direct match, pay per event $2.00 $1.20 $0.00005 Included 186 No reviews yet 12 Nov 2026
Where Telegram Scraper is stronger

Where Telegram Scraper is stronger

  • Largest user base among the Telegram actors listed here
  • Handles profiles as well as channel messages
  • Message age can be set in days rather than with exact dates

Where this API is stronger

  • Rows carry reaction lists, polls, link previews and media file lists
  • Only new mode keeps a per channel cursor so scheduled runs skip seen posts
  • Caps on posts per channel and total posts per run
Where Telegram Keyword Search Scraper is stronger

Where Telegram Keyword Search Scraper is stronger

  • Most monthly runs among the Telegram actors listed here
  • Keyword search spans all public channels, not just the ones you name
  • Country and language filters narrow a keyword search

Where this API is stronger

  • Post rows carry media lists, polls and link preview data
  • Channel info records include subscriber and media counts
  • Plain HTTP preview reading, with no browser in the container
Where Telegram Scraper: Channels, Messages, Comments & Profiles is stronger

Where Telegram Scraper: Channels, Messages, Comments & Profiles is stronger

  • Comments on messages can be collected as an optional output
  • Filters for media type, keywords and message id
  • Runs without channel info pay only for messages

Where this API is stronger

  • Poll, reaction and link preview objects sit inside each post row
  • Only new state keeps repeat scheduled runs to fresh posts
  • A per channel status record says ok, empty, not found or preview disabled
Where Telegram Channels Scraper: Messages, Contacts & Leads is stronger

Where Telegram Channels Scraper: Messages, Contacts & Leads is stronger

  • Pulls every email and link out of each post for lead work
  • Incremental mode collects only messages new since the last run
  • Can discover related channels from a seed channel

Where this API is stronger

  • Reaction breakdowns, polls and media lists are part of every post row
  • A per channel status record explains empty or blocked channels
  • A global cap stops a run at a set number of posts
Where Telegram Channel Scraper & Keyword Search — No Login is stronger

Where Telegram Channel Scraper & Keyword Search — No Login is stronger

  • Keyword matching inside listed channels, with the matched keyword kept
  • Minimum views filter and post id pagination for deep reads
  • Markdown output per post for downstream text work

Where this API is stronger

  • Reactions, polls and media file lists are carried in the post row
  • Channel info records add subscriber and media counts
  • Both a per channel cap and a total post cap apply to a run

Telegram channel scraping is competitive and nearly every actor bills per message or post. tri_angle and lofomachines have the largest audiences and add keyword search across public channels, automation-lab adds comments, khadinakbar focuses on emails and links, and tugelbay filters by views. Ours keeps reaction, poll and media detail in each post row.

Prices are Apify Store list prices, checked 20 Nov 2026. Platform usage 'Paid separately' means Apify bills compute on top of the event price. Check each listing before you buy.

How to run it

  1. List channels in the channels array, as durov, @durov, t.me/durov or a full https://t.me/durov link.
  2. Set maxPostsPerChannel, for example 50, and maxTotalPosts if you are covering several channels in one run.
  3. Optionally add searchQuery, postedAfter or postedBefore to narrow what is collected.
  4. Turn on includeChannelInfo for a subscribers and description row, and onlyNew for scheduled delta runs.
  5. Run the actor, then read post and channel rows in the dataset or export them as JSON, CSV or Excel.

cURL

curl -X POST "https://api.apify.com/v2/acts/subimpact~telegram-channel-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"channels":["durov","telegram"],"maxPostsPerChannel":50,"maxTotalPosts":500,"includeChannelInfo":true,"onlyNew":false,"stateStoreName":"telegram-channel-scraper-state","maxConcurrency":3,"proxyConfiguration":{"useApifyProxy":false}}'

Python

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("subimpact/telegram-channel-scraper").call(run_input={"channels":["durov","telegram"],"maxPostsPerChannel":50,"maxTotalPosts":500,"includeChannelInfo":true,"onlyNew":false,"stateStoreName":"telegram-channel-scraper-state","maxConcurrency":3,"proxyConfiguration":{"useApifyProxy":false}})

for item in client.dataset(run["default_dataset_id"]).iterate_items():
    print(item)

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('subimpact/telegram-channel-scraper').call({"channels":["durov","telegram"],"maxPostsPerChannel":50,"maxTotalPosts":500,"includeChannelInfo":true,"onlyNew":false,"stateStoreName":"telegram-channel-scraper-state","maxConcurrency":3,"proxyConfiguration":{"useApifyProxy":false}});
const { items } = await client.dataset(run.defaultDatasetId).listItems();

console.log(items);

MCP

claude mcp add subimpact-data -e APIFY_TOKEN=<YOUR_APIFY_TOKEN> -- npx -y @subimpact/data-mcp

# Then ask your agent to use the telegram_channel tool.

n8n

Use the Apify node (Run an Actor).
Actor ID: subimpact/telegram-channel-scraper
Input JSON: paste the example input above.

MCP users: @subimpact/data-mcp exposes these actors as tools, so an agent can call telegram_channel directly.

Limits

  • Public channels with the web preview enabled only, with no private channels or groups.
  • Telegram serves 20 posts per page, so deep timelines take several requests.
  • Media arrive as CDN links that can expire, with no file download.
  • editedAt is never published on the public preview.

Questions people ask

What does a post cost?

Each post row costs $0.0003, which is $0.30 per 1,000 posts. A channel-info row costs $0.001, or $1.00 per 1,000, and there is a small start charge of $0.00005 per run. Channels that are empty, preview-disabled or not found cost nothing, since no row is delivered.

Do I need a Telegram account or API key?

No. The actor reads the public t.me web preview over plain HTTP, with no login, no API key and no Telegram app. That also defines the limit: only public channels with the web preview enabled can be read, while private channels, invite links and groups cannot.

How many posts can I get from a channel?

maxPostsPerChannel accepts 1 to 10,000, and Telegram serves 20 posts per page, so the value also sets how many pages are fetched with a short pause between them. It is a cap rather than a promise, so a channel with fewer posts returns what exists.

Are view counts and reactions exact?

views is parsed to an integer from Telegram's printed figure, and viewsText keeps the original string. Subscribers and poll percentages follow the same rule. All of them are a snapshot of what Telegram printed at scrape time, so a later run will show different numbers as views accumulate.

Why is editedAt always null?

Telegram marks an edited post with isEdited true on the public preview but does not print the edit timestamp there. Use isEdited to filter posts that changed, and treat editedAt as unavailable rather than as missing data on your side.

Can I download the photos and videos?

No. photoUrls and videoThumbUrls are CDN links taken from the page, and Telegram's CDN links can expire. Nothing is downloaded by the actor. Animated GIFs render as muted video loops in the preview, so they arrive with mediaType video.

Will a scheduled run send the same posts twice?

Not with onlyNew on. Each run compares against the highest post id already delivered for that channel, kept in the named key-value store. If you also use searchQuery on the same channel, the cursor is shared with timeline runs, so use a separate stateStoreName to keep those streams apart.

Need a data source that is not here?

We build and run scrapers for sites that have no public API. Tell us the site, the fields and how often you need them.