Telegram Channel Scraper - Posts, Profiles, Members & Search
Pricing
from $0.70 / 1,000 results
Telegram Channel Scraper - Posts, Profiles, Members & Search
Extract public Telegram channel posts, channel profiles and single posts as structured rows. Members, keyword search and comments need an account session. Pay per delivered row plus a start fee.
Pricing
from $0.70 / 1,000 results
Rating
0.0
(0)
Developer
kane liu
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
3 days ago
Last modified
Categories
Features
Share
Export posts, channel profiles and single posts from public Telegram channels as structured rows, with view counts, reactions and links.
- Newest-first posts from any public channel, with text, links, views, forwards and reactions.
- Channel profiles with title, description, subscriber count and media counters.
- Single posts by link, such as
https://t.me/durov/553. - Group members, keyword search across public channels and comments under a post, when an account session is available.
- Pay only for the rows you receive: one row is one billed result, plus a small start fee.
What does Telegram Channel Scraper do?
Telegram Channel Scraper collects public data from t.me. It reads public channels and groups only. It does not read private chats, private groups or invite-only channels, it does not download media files and it does not send messages.
- Channel posts (
posts): the newest posts of each channel inchannels, newest first. - Channel profile (
profile): one row per channel with title, description, subscribers and counters. - Single posts (
post): one row per link inpostUrls. - Group members (
members): members of a public group. Needs an account session. - Keyword search (
search): posts that match each keyword insearchQueries, across public channels. Needs an account session. - Comments (
comments): comments under each post inpostUrls. Needs an account session.
The three modes marked "needs an account session" can be temporarily unavailable. When that happens the run fails at once with the error AUTH_SESSION_UNAVAILABLE and no row is charged. The posts, profile and post modes work from the public pages and do not depend on a session.
Telegram shows rounded counters on public pages, such as 455K views. The Actor keeps the number it can read in views and the text Telegram showed in viewsDisplay, and sets viewsApprox to true when the number was expanded from a rounded value. Turn on exactCounts to replace rounded view counts with exact numbers for posts. This uses an account session.
What data can you extract from Telegram?
Every row has a rowType and an id. Fields the source does not show stay null. These are the most useful fields; the dataset schema lists all of them.
Post rows (channel_post)
| Field | Description | Example |
|---|---|---|
channel | Channel username | durov |
postId | Post number inside the channel | 553 |
url | Link to the post | https://t.me/durov/553 |
publishedAt | Publication time | 2026-03-14T09:30:00+00:00 |
text | Post text | Example post text |
links | Links found in the post | ["https://example.com"] |
views | View count | 455000 |
viewsDisplay | View count as Telegram showed it | 455K |
viewsApprox | true when views was expanded from a rounded value | true |
forwards | Forward count | 1200 |
repliesCount | Number of replies, when comments are enabled | 300 |
reactions | List of reactions with emoji and count | [{"emoji":"👍","count":5200}] |
mediaType | Kind of attached media | photo |
mediaCount | Number of attached media items | 1 |
forwardedFrom | Original source of a forwarded post: {name, url} | {"name": "Telegram", "url": "https://t.me/telegram"} |
Profile rows (channel_profile)
| Field | Description | Example |
|---|---|---|
username | Channel username | durov |
title | Channel title | Example Channel |
about | Channel description | Example description |
subscribers | Subscriber count | 7000000 |
subscribersDisplay | Subscriber count as Telegram showed it | 7M |
verified | Verified badge | true |
photosCount | Number of photos | 250 |
videosCount | Number of videos | 80 |
linksCount | Number of shared links | 120 |
linkedChatId | Linked discussion group, when there is one | null |
Member rows (participant)
| Field | Description | Example |
|---|---|---|
channel | Group username | examplegroup |
userId | Numeric user ID | 1000001 |
username | Public username, when set | example_user |
firstName | First name | Jane |
isBot | Whether the member is a bot | false |
lastSeen | Last-seen status shown by Telegram | recently |
role | Role in the group | member |
Search rows (search_hit) and comment rows (comment)
| Field | Description | Example |
|---|---|---|
query | Keyword that matched (search rows) | example keyword |
channelTitle | Title of the channel with the match (search rows) | Example Channel |
commentId | Comment number (comment rows) | 42 |
authorName | Display name of the commenter (comment rows) | Jane Doe |
authorUsername | Username of the commenter (comment rows) | example_user |
replyToCommentId | Comment this one replies to (comment rows) | null |
How to scrape Telegram
- Open Telegram Channel Scraper in Apify Console (a free Apify account is enough to try it).
- Fill one target field, for example
channels. Leave everything else as it is. - Set
maxResultsto a small number such as3for your first run. - Click Start and wait for the run to finish.
- Download the results as JSON, CSV, Excel or another format, or read them through the API.
An empty input starts an example run for the channel durov in posts mode, limited to 3 rows, so you can see the output format before you spend anything. Fill one target field and the Actor picks the mode by itself: postUrls selects post, searchQueries selects search and channels selects posts. If you fill several target fields, postUrls wins over searchQueries, and searchQueries wins over channels.
Channel posts
Set mode to posts and list public channels in channels. You can write durov, @durov, https://t.me/durov or t.me/s/durov. Each channel has its own maxResults allowance.
Channel profile
Set mode to profile and list channels in channels. You get one channel_profile row per channel.
Single posts
Set mode to post and list links such as https://t.me/durov/553 in postUrls.
Group members
Set mode to members and list public groups in channels. Needs an account session.
Keyword search
Set mode to search and list keywords in searchQueries. Each keyword is searched across public channels. Needs an account session.
Comments
Set mode to comments and list post links in postUrls. You get the comments under each post. Needs an account session.
What to fill in
| Field | What to enter | Default |
|---|---|---|
mode | One of posts, profile, post, members, search, comments | posts |
channels | Public channels or groups for posts, profile and members | ["durov"] in the form, empty otherwise |
postUrls | Post links for post and comments | Empty |
searchQueries | Keywords for search | Empty |
exactCounts | Replace rounded view counts with exact numbers; uses an account session for posts | false |
maxResults | Rows per channel, link or keyword, 1 to 1000 | 70; form example 3 |
Channel posts:
{"mode": "posts", "channels": ["durov"], "maxResults": 5}
Channel profile:
{"mode": "profile", "channels": ["durov", "@telegram"], "maxResults": 1}
Single posts:
{"mode": "post", "postUrls": ["https://t.me/durov/553"], "maxResults": 1}
Group members:
{"mode": "members", "channels": ["examplegroup"], "maxResults": 10}
Keyword search:
{"mode": "search", "searchQueries": ["example keyword"], "maxResults": 10}
Comments:
{"mode": "comments", "postUrls": ["https://t.me/durov/553"], "maxResults": 10}
maxResultsis the most rows for each channel, link or keyword.maxItemsandlimitare accepted as the same setting.- Unknown fields never fail the run: close misspellings are corrected and other unknown fields are ignored with a note.
- Wrong input stops the run at once with a message like
INVALID_INPUT: <field> — <how to fix>. No rows are charged. - The
INPUT_REPORTrecord in the run's key-value store shows how your input was read: fields filled, corrected or ignored.
Output example
A post row:
{"rowType": "channel_post","id": "durov/553","channel": "durov","postId": 553,"url": "https://t.me/durov/553","publishedAt": "2026-03-14T09:30:00+00:00","text": "Example post text","views": 455000,"viewsDisplay": "455K","viewsApprox": true,"forwards": 1200,"reactions": [{"emoji": "👍", "count": 5200}],"mediaType": "photo","mediaCount": 1}
A profile row:
{"rowType": "channel_profile","id": "durov","username": "durov","url": "https://t.me/durov","title": "Example Channel","about": "Example description","verified": true,"subscribers": 7000000,"subscribersDisplay": "7M","subscribersApprox": true}
You can export the dataset as JSON, CSV, Excel, XML, RSS or an HTML table.
Why use this Telegram scraper?
- Pay per row. You pay for rows written to the dataset, not for pages tried. One row is one billed result.
- Partial results are kept. If the run is stopped or times out, rows collected so far are delivered and billed; nothing else is.
- Clear errors. A failed input names the field and the fix.
- No made-up data. A field the source does not show stays
null. - Several inputs per run. List many channels, links or keywords; each has its own
maxResultsallowance. - No setup. You do not need proxies, cookies or a Telegram account for the public modes.
How much does it cost to scrape Telegram?
The Actor uses pay-per-event pricing: $0.005 per run start and $0.001 per delivered row on the Free plan. Platform usage is included in these prices.
| Apify plan | Price per row | Price per 1,000 rows |
|---|---|---|
| Free | $0.001 | $1.00 |
| Starter | $0.001 | $1.00 |
| Scale | $0.00087 | $0.87 |
| Business | $0.00073 | $0.73 |
| Platinum | $0.0006 | $0.60 |
| Diamond | $0.00047 | $0.47 |
maxResultsapplies to each input. The default is 70; bigger numbers are collected in parts of 70, up to 1000 per input.- Runs on the free Apify plan stop at 200 rows.
- The run never costs more than the Maximum cost per run you set in the run options (
maxTotalChargeUsdin the API). - A run that fails with
AUTH_SESSION_UNAVAILABLEdelivers no rows and has no row charge. - The Apify Free plan includes $5.00 in monthly usage credit (about 4,999 rows at
$0.001per row across Free-plan runs capped at 200 rows per run).
Example: 3 channels with maxResults set to 50 in posts mode deliver at most 150 rows → 150 × $0.001 + $0.005 = $0.155 on the Free plan.
What happens when the run timeout is too short
Some requests take longer than the run timeout you chose. In that case the run does not fail. It ends early with the status message "Queued on the collection backend; this run will resume automatically when results are ready (about N s)." and shows as ABORTED for a while. When the results are ready the same run starts again by itself, reports "Resumed: delivering N rows.", writes the rows to the same dataset and finishes as SUCCEEDED. No row is delivered or charged twice, and you do not need to do anything.
- This can happen at most 3 times per run. To avoid it, keep the default timeout (
3600s). - The synchronous API endpoints (
run-sync,run-sync-get-dataset-items) wait at most 300 seconds and can return an empty dataset while the run is paused. For larger jobs start the run asynchronously and read the dataset after the run reachesSUCCEEDED, or use a webhook on the "succeeded" event.
Use with AI agents and the API
Apify MCP server (Claude, ChatGPT, Cursor, VS Code)
Add this Actor as a tool in any MCP client that supports remote servers:
https://mcp.apify.com?tools=lentic_clockss/telegram-channel-scraper
Sign in with Apify when the client asks (OAuth), or send the header Authorization: Bearer <YOUR_APIFY_TOKEN>. The tool starts a run and returns the run and dataset IDs; the agent then reads rows with get-dataset-items. Clients without remote MCP support can run npx @apify/actors-mcp-server --tools lentic_clockss/telegram-channel-scraper with the APIFY_TOKEN environment variable.
Example prompt: "Get the last five posts of the public Telegram channel durov with their view counts."
- Agent execution note: Set
maxResultsbetween5and20on exploratory tool calls to keep responses compact, and readRUN_SUMMARYandINPUT_REPORTfrom the default key-value store to inspect normalized inputs and delivered row counts. When a long run briefly reportsABORTEDwith the automatic-resume status message, wait for the same run ID to finish asSUCCEEDEDinstead of starting a duplicate run.
Apify API
from apify_client import ApifyClientclient = ApifyClient("<YOUR_APIFY_TOKEN>")run = client.actor("lentic_clockss/telegram-channel-scraper").call(run_input={"channels": ["durov"], "maxResults": 10})for item in client.dataset(run["defaultDatasetId"]).iterate_items():print(item)
import { ApifyClient } from 'apify-client';const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });const run = await client.actor('lentic_clockss/telegram-channel-scraper').call({ channels: ['durov'], maxResults: 10 });const { items } = await client.dataset(run.defaultDatasetId).listItems();console.log(items);
Or over HTTP: POST https://api.apify.com/v2/acts/lentic_clockss~telegram-channel-scraper/runs with the input as the JSON body and your token in the Authorization: Bearer header, then GET https://api.apify.com/v2/datasets/<datasetId>/items?format=json.
Integrations
Connect the results to Google Sheets, Make, Zapier, n8n, Slack, Airtable or your own webhook from the Integrations tab of the Actor, or schedule regular runs with Apify Schedules.
FAQ
Is it legal to scrape Telegram?
The Actor collects public data from public channels and groups. You are responsible for following Telegram's terms and the data-protection laws that apply to you. Member lists and comments contain personal data, and processing personal data requires a lawful basis. This is an unofficial tool and is not affiliated with Telegram.
Why did my run end as ABORTED?
A run that reaches the platform timeout, or that you stop yourself, shows as ABORTED. Rows written before that point stay in the dataset and are billed; nothing else is. Keep the default timeout of 3600 seconds for large inputs.
How many results can I get?
Set maxResults from 1 to 1000 for each channel, link or keyword. Actual delivery depends on how many public posts, members or comments exist, the charge ceiling and the free-plan limit.
Why are some fields empty?
Telegram does not show every field for every row. A post without media has mediaType set to null, a channel without a linked discussion group has no linkedChatId, and a member may hide the last-seen time. The Actor leaves these fields empty instead of guessing.
Why do I see AUTH_SESSION_UNAVAILABLE?
The members, search and comments modes, and exactCounts for posts, need an account session. When none is available, the run fails at once and no row is charged. Try again later, or use the posts, profile and post modes, which do not need a session.
Why is views a rounded number?
Public pages show rounded counters such as 455K. The Actor keeps the expanded number in views, the original text in viewsDisplay and sets viewsApprox to true. Turn on exactCounts to get exact view numbers.
Does it download photos and videos?
No. Rows carry mediaType, mediaCount and the post link in url. Media files are not downloaded.
Can I look up people by phone number or send messages?
No. The Actor does not look up phone numbers and has no messaging features.
Limitations
- Only public channels and groups are supported. Private chats, private groups and invite-only channels are not.
members,search,commentsandexactCountsdepend on an account session and can be temporarily unavailable.- Media files are not downloaded; rows carry
mediaType,mediaCountand the post link. - Without
exactCounts, counters from public pages can be rounded. - Phone-number lookup and messaging are not supported.
- How far back a channel can be read depends on what Telegram shows for that channel.
Related scrapers
More social media and video scrapers from the same publisher:
- TikTok Scraper
- Reddit Scraper
- YouTube Shorts Scraper
- YouTube Scraper
- Douban Scraper
- IMDb Scraper
- Stealth Web Scraper
- Email Validator
Browse all of our scrapers at apify.com/lentic_clockss.
Support
Found a problem or need another field? Open an issue in the Issues tab of this Actor's page and include the run ID and the input you used.