Telegram 频道 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.
价格与服务商
Telegram 频道 API 价格：一个 API，3 个可互换的服务商
最便宜的服务商优先响应。如果它失败，下一个会在同一次调用中接手。
试一试
一个请求获取 Telegram 频道
{
"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"
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
一个请求，一种响应结构。
你发送的每个字段和收到的每个字段，都附有真实示例。
最近验证于 2026-10-19 · 可用率和延迟按 30d 统计
请求体
JSON，POST 到这个接口。
- 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.
响应
JSON，每个字段一个示例值。
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.
- fileCountinteger可设为必填
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.
- linkCountinteger可设为必填
Links the channel has posted, rounded by Telegram. Null when not shown or when this source does not report it.
- photoCountinteger可设为必填
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.
- videoCountinteger可设为必填
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.
常见问题
关于 Telegram 频道 API
AnyAPI 的 Telegram 频道 API 只需一次 POST 请求 /v1/run/telegram.channel，就以统一格式的 JSON 返回 Telegram 数据。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 会在 3 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$1.10 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 Telegram 频道 API 调用中有 100.0% 成功，响应时间中位数为 1.1 秒，共测量 2 次调用。