Telegram Channel API
Get a public Telegram channel by username: name, bio, photo, verified badge, exact subscriber count, and how many photos, videos, files and links it has posted.
Pricing and providers
Telegram Channel API pricing: one API, 3 interchangeable providers
The cheapest provider serves first. If it fails, the next one takes over in the same call.
Try it
Get Telegram channel in one request
{
"data": {
"avatarUrl": "https://example.com/image.jpg",
"description": "A short example description of this item.",
"fileCount": 12500,
"handle": "alex_rivera",
"linkCount": 12500,
"photoCount": 12500,
"subscribers": 12500,
"title": "Example title",
"url": "https://example.com/page",
"verified": true,
"videoCount": 12500
},
"found": true,
"reason": "not_found"
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
One request, one response shape.
Every field you send and every field you get back, each with a real example.
Last verified 2026-10-19 · uptime and latency measured over 30d
Request body
JSON, posted to this endpoint.
- handlestring
telegram
Public Telegram channel username, with or without the @ (e.g. "telegram"), or its t.me link.
- requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `photoCount`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a channel that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Response
JSON, one example value per field.
The channel record, or null when nothing was found.
- avatarUrlstring
Channel photo URL. Temporary: Telegram's CDN link expires.
- descriptionstring
Channel bio as plain text; null when the channel has none.
- fileCountintegercan require
Files the channel has posted, rounded by Telegram. Null when not shown or when this source does not report it.
- handlestring
Channel username, without the @. Populated whenever the provider has data for the entity.
- linkCountintegercan require
Links the channel has posted, rounded by Telegram. Null when not shown or when this source does not report it.
- photoCountintegercan require
Photos the channel has posted. Telegram rounds this count ("1.2K" becomes 1200). Null when not shown or when this source does not report it.
- subscribersinteger
Exact subscriber count, read from the channel's public t.me page. Null when Telegram does not show it. Populated whenever the provider has data for the entity.
- titlestring
Channel name. Populated whenever the provider has data for the entity.
- urlstring
The channel's t.me link.
- verifiedboolean
True when the channel carries Telegram's verified badge. Null when this source does not report it.
- videoCountintegercan require
Videos the channel has posted, rounded by Telegram. Null when not shown or when this source does not report it.
- foundboolean
True when the channel was found; false when no public channel has this username.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
FAQ
About the Telegram Channel API
The AnyAPI Telegram Channel API returns Telegram channel data as normalized JSON from one POST call to /v1/run/telegram.channel. Get a public Telegram channel by username: name, bio, photo, verified badge, exact subscriber count, and how many photos, videos, files and links it has posted. AnyAPI routes each request across 3 sources and falls back automatically when one fails. It costs from $1.10 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Telegram channel calls through AnyAPI succeeded, with a median response time of 1.1 seconds across 2 measured calls.