Telegram Scraper API
Telegram channel details, plus each post with its views, reactions and forwards, returned as JSON. It suits developers who would rather not hold an api_id or a spare phone number. A failed request is free.
100 free credits. No card needed.
{
"ok": true,
"credits_charged": 1,
"credits_remaining": 4999,
"cached": false,
"cached_at": null,
"request_id": "req_4bfd4c61bbc632c2ff55f435",
"data": {
"object": "list",
"items": [
{
"object": "post",
"platform": "telegram",
"id": "552",
"url": "https://t.me/durov/552",
"type": "video",
"author": { ... },
"title": null,
"text": "✨ Designers × AI\n\n🆕 The mockup era is over. Today’s AI tools give every designe...",
"published_at": "2026-10-11T14:52:40Z",
"duration_seconds": 75,
"language": null,
"hashtags": null,
"mentions": [ ... ],
"stats": { ... }
...
},
{
"object": "post",
"platform": "telegram",
"id": "551",
"url": "https://t.me/durov/551",
"type": "video",
"author": { ... },
"title": null,
"text": "💸 If your wallet doesn’t look like this, don’t even bother sending me money for...",
"published_at": "2026-10-10T14:22:43Z",
"duration_seconds": null,
"language": null,
"hashtags": null,
"mentions": null,
"stats": { ... }
...
}
],
"cursor": "531",
"has_more": true,
"parent": {
"object": "community",
"platform": "telegram",
"id": null,
"url": "https://t.me/durov",
"kind": "channel",
"name": "durov",
"title": "Pavel Durov",
"description": "Founder of Telegram.",
"avatar_url": "https://cdn4.telesco.pe/file/E1fT1nGQ1lDmNdTpfhudwrMtUB-bHaQjPg9dJWmN5KP932jw4th...",
"banner_url": null,
"member_count": 10200000,
"online_count": null,
"is_nsfw": null,
"is_private": null
...
}
},
"cursor": "531",
"has_more": true
}{
"ok": true,
"credits_charged": 1,
"credits_remaining": 4999,
"cached": false,
"cached_at": null,
"request_id": "req_08e7e0a500aac8057ac41e6f",
"data": {
"object": "community",
"platform": "telegram",
"id": null,
"url": "https://t.me/durov",
"kind": "channel",
"name": "durov",
"title": "Pavel Durov",
"description": "Founder of Telegram.",
"avatar_url": "https://cdn4.telesco.pe/file/E1fT1nGQ1lDmNdTpfhudwrMtUB-bHaQjPg9dJWmN5KP932jw4th...",
"banner_url": null,
"member_count": 10201685,
"online_count": null,
"is_nsfw": null,
"is_private": null
...
},
"cursor": null,
"has_more": null
}3 endpoints. One key.
Posts and videos
2 endpointsWhat you get from Telegram
What you can build with Telegram data
Your first request.
Open an account
100 credits come with it. There is no card form.
Pass a channel name
Use the handle from its t.me link, such as durov for t.me/durov.
Look at the audience
member_count gives the size, and the verified flag shows whether Telegram has marked it.
curl -G "https://api.socialscrape.dev/v1/telegram/channel/posts" \ -H "x-api-key: $SOCIALSCRAPE_API_KEY" \ --data-urlencode "handle=durov"
import os
import requests
params = {
"handle": "durov",
}
res = requests.get(
"https://api.socialscrape.dev/v1/telegram/channel/posts",
headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},
params=params,
)
body = res.json()
if body["ok"]:
print(body["data"])
else:
print(body["error"]["code"], body["error"]["message"])
const url = new URL("https://api.socialscrape.dev/v1/telegram/channel/posts"); url.search = new URLSearchParams({ "handle": "durov" }).toString(); const res = await fetch(url, { headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! }, }); const body = await res.json(); if (body.ok) { console.log(body.data); } else { console.error(body.error.code, body.error.message); }
The response. Sample values, in the shape every call returns.
{
"ok": true,
"credits_charged": 1,
"credits_remaining": 4999,
"cached": false,
"cached_at": null,
"request_id": "req_4bfd4c61bbc632c2ff55f435",
"data": {
"object": "list",
"items": [
{
"object": "post",
"platform": "telegram",
"id": "552",
"url": "https://t.me/durov/552",
"type": "video",
"author": { ... },
"title": null,
"text": "✨ Designers × AI\n\n🆕 The mockup era is over. Today’s AI tools give every designe...",
"published_at": "2026-10-11T14:52:40Z",
"duration_seconds": 75,
"language": null,
"hashtags": null,
"mentions": [ ... ],
"stats": { ... }
...
},
{
"object": "post",
"platform": "telegram",
"id": "551",
"url": "https://t.me/durov/551",
"type": "video",
"author": { ... },
"title": null,
"text": "💸 If your wallet doesn’t look like this, don’t even bother sending me money for...",
"published_at": "2026-10-10T14:22:43Z",
"duration_seconds": null,
"language": null,
"hashtags": null,
"mentions": null,
"stats": { ... }
...
}
],
"cursor": "531",
"has_more": true,
"parent": {
"object": "community",
"platform": "telegram",
"id": null,
"url": "https://t.me/durov",
"kind": "channel",
"name": "durov",
"title": "Pavel Durov",
"description": "Founder of Telegram.",
"avatar_url": "https://cdn4.telesco.pe/file/E1fT1nGQ1lDmNdTpfhudwrMtUB-bHaQjPg9dJWmN5KP932jw4th...",
"banner_url": null,
"member_count": 10200000,
"online_count": null,
"is_nsfw": null,
"is_private": null
...
}
},
"cursor": "531",
"has_more": true
}
Pay only for data you get.
Failed requests and cached repeats are free.
1,000 credits
$13 one time
Get an API key- $13.00 per 1,000 credits
- Credits never expire
- No subscription
25,000 credits
$55 one time
Get an API key- $2.20 per 1,000 credits
- Credits never expire
- No subscription
230,000 credits
$349 one time
Get an API key- $1.52 per 1,000 credits
- Credits never expire
- No subscription
Questions, answered.
About the Telegram API
How much does Telegram data cost?
A channel's details cost 1 credit and each page of its posts costs 1 more. Archiving 100 channels with their latest 3 pages of posts is 400 credits, around $0.88 priced from the Growth pack. The more credits you buy, the closer the rate gets to $1.39 per 1,000. You begin with 100. See pricing.
How is it different from Telegram's own API?
Telegram's own client API, the one libraries like Telethon use, asks you for an api_id and api_hash from my.telegram.org, and Telegram allows one api_id per phone number. That ties your project to a real phone-number account. This API takes your SocialScrape key alone, so no phone number and no session file are involved.
Do I need a Telegram account?
No. Nothing is signed in on your side: a request carries your SocialScrape key and the channel name.
Which chats can it read?
Channels and groups that have a t.me web preview page. Private and invite-only chats do not have one, so they are not supported, and neither are direct messages.
How do I get older posts?
Each page of posts carries a cursor, which is a post number. Send it back and the previous page comes, so you walk from the newest posts toward the oldest one request at a time.
What do I get for each post?
The text and date, views, reactions and forwards, plus previews of any media or links, and the source when a post was forwarded from elsewhere. Views and reactions are what Telegram shows at the time of the request.
Can I follow a keyword across Telegram?
Not with these endpoints: there is no search. You pick the channels, and the API reads them. Get an API key and try it on a channel you already watch.
Start pulling social data.
100 free credits. No card needed.