Start with 100 free credits. No card needed. Get an API key

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.

A sample request for each kind of data
GET /v1/telegram/channel/postshandle=durov
200 OKSample values1 credit
{
  "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
}
Telegram endpoints3
Every request1 credit
A failed requestFree
Telegram loginNot needed

What you get from Telegram

ChannelsName, description, member count and verified status.
PostsText, publish date, length and views.

What you can build with Telegram data

Follow channelsCollect new posts from the channels a market, project or newsroom relies on.
Check channelsCompare member counts, verification and descriptions before you buy an ad slot or add a source.
Measure engagementWeigh views, reactions and forwards per post to find what a channel's audience reacts to.
Keep a recordArchive a channel's posts and their numbers, so a deleted or edited post is still on file.
Follow communitiesWatch an open group's size and activity as a signal for a token, game or open-source project.

Your first request.

01

Open an account

100 credits come with it. There is no card form.

02

Pass a channel name

Use the handle from its t.me link, such as durov for t.me/durov.

03

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"
Read the docs

The response. Sample values, in the shape every call returns.

200 OKSample values
{
  "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.

RequestCredits
A channel's details1 credit
One page of its posts1 credit
A single post, from its link1 credit
A request that failsFree
Starter

1,000 credits

$13 one time

Get an API key
  • $13.00 per 1,000 credits
  • Credits never expire
  • No subscription
GrowthMost popular

25,000 credits

$55 one time

Get an API key
  • $2.20 per 1,000 credits
  • Credits never expire
  • No subscription
Scale

230,000 credits

$349 one time

Get an API key
  • $1.52 per 1,000 credits
  • Credits never expire
  • No subscription
Packs never expire. Monthly plans too.See pricing

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.

Get started

Start pulling social data.

100 free credits. No card needed.