InsightSocial

Telegram scraper API

The InsightSocial Telegram API has 3 endpoints, from 10 credits a call. A profile call costs 10 credits, about $0.01 on Pro, and your first 10 calls up to 100 credits each are free.

The Telegram API for public channels, as JSON: subscriber counts, descriptions and recent posts with views, per-emoji reactions and media. No bot to add and no phone-number login.

3 endpoints · from 10 credits a call · 10 free calls up to 100 credits each · no credit card

curl "https://api.insightsocial.app/v1/telegram/profile?handle=example_channel" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "telegram",
"endpoint": "/v1/telegram/profile",
"schema_version": "2",
"data": {
"author": {
"id": "1234567890",
"username": "example_channel",
"display_name": "Example Channel",
"avatar_url": "https://cdn.example.com/avatars/example_channel.jpg",
"bio": "Daily notes on open-source tooling. Contact: hello@example.com",
"verified": false,
"followers": 52840,
"followers_approximate": null,
"following": null,
"posts_count": null,
"likes_count": null,
"url": "https://t.me/example_channel",
"location": null,
"external_url": null,
"private": null,
"joined_at": null,
"last_post_at": null,
"ext": null
}
},
"unavailable": [],
"credits_used": 0,
"charge_reason": "miss",
"free_call": true
}

What Telegram data can you get?

Public Telegram data only, returned in the same JSON envelope as every other platform.

Channel profiles

Name, description, avatar, verification and subscriber count for a public channel or group.

Channel posts

A channel's recent posts page by page, and any single post by its t.me URL, with text, publish time, view count, per-emoji reactions and media URLs.

What people build with the Telegram API

  • Channel monitoring

    Read a channel's newest posts on a schedule and keep the ones you have not stored yet, with views and reactions at the time of reading.

  • Reach comparison

    Compare subscriber counts and per-post views across the channels in a niche to see which ones people actually read.

  • Research and fact-checking

    Archive public posts from news or community channels by URL, with publish times and media links, for later analysis.

Telegram API endpoints

All 3 Telegram endpoints and their price in credits. Every one has a fixed price.

EndpointCreditsWhat it returns
/profile10Returns a public Telegram channel or group's profile: display name, description, avatar URL, verification status, and subscriber count.
/profile/posts10Returns one page of recent public posts from a Telegram channel or group, each with its text, publish time, view count, reaction breakdown, and media URLs.
/post10Returns one public Telegram post: text, publish time, view count, the per-emoji reaction breakdown, and direct media URLs.

Parameters, response fields and examples for each endpoint are in the Telegram API reference.

InsightSocial vs the official Telegram API

Telegram's Bot API reads only chats a bot has been added to. MTProto, the API Telegram's own apps use, needs an api_id from my.telegram.org and a user account logged in with a phone number.

InsightSocial APIOfficial Telegram API
SetupSign in and copy a keyA bot token, or an api_id plus a phone-number account
Channels you have not joinedAny public channel by handleNot through the Bot API; MTProto as a logged-in user
ProtocolPlain HTTPS and JSONBot API over HTTPS; MTProto through a client library
Cost per call10 creditsNo per-call price; bound by Telegram's API terms

The official API is the right tool for posting, messaging or managing accounts you own. This one is read-only public data.

How much does the Telegram API cost?

Telegram calls start at 10 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call. Pro's 10,000 monthly credits cover about 1,000 channels at 10 credits each.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Repeats and retries

    A repeat call is charged again: the full price when it fetches new data, 2 credits when the answer comes from the shared cache. Add fresh=1 to force a new read. Only a retry with the same Idempotency-Key is free.

  • One balance

    API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.

Not writing code?

Connect InsightSocial to Claude or ChatGPT and ask for Telegram data in plain English. Same account, same credits.

Use it from Claude or ChatGPT

Telegram API: frequently asked questions

Only one it has been added to: Telegram's Bot FAQ says bots receive messages from channels where they are a member. Reading other channels through Telegram itself means MTProto with an api_id and a user account, and Telegram observes accounts that log in through unofficial clients. /v1/telegram/profile/posts reads any public channel by handle with one key.