Telegram Channel Info
Telegram 频道信息是广播频道对外公开的资料,包括用户名、标题、简介、头像、认证标记和订阅人数。这几项信号能说明频道规模多大、是否经过 Telegram 认证以及主要发布什么内容,可用于投放前审核频道、维护频道关注清单和补全频道名单。
Telegram Channel Info API 主要特性
- 一次最多查 50 个频道urls 可混用 t.me/name、t.me/s/name、telegram.me 和 telegram.dog 链接;同一频道重复出现只查一次,每个查到的频道返回一行。
- 订阅数换算为整数metrics.followers_count 把 Telegram 显示的 9.95M 这类缩写换算成 9950000 这样的整数,可直接排序、筛选和设阈值。
- 身份信息与认证标记同行返回username、name、text 和 avatar_url 描述频道本身,is_verified 表示频道是否带有 Telegram 认证标记。
- 无法读取的链接跳过且不计费私密或已移除的频道不会出现在结果里,也不扣费,同批其他频道照常返回。
Telegram Channel Info API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 最多 50 个公开 Telegram 频道链接,例如 https://t.me/durov 或 https://t.me/s/durov;也支持 telegram.me 和 telegram.dog 链接,重复的频道只查一次。 |
如何使用 Telegram Channel Info API
提交一组频道链接,每个查到的频道返回一行。
- 向 /v1/telegram/channel-info 发送 {"urls": ["https://t.me/durov", "https://t.me/tginfo"]}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
- 从 results.items 读取频道;has_more 为 true 时,带上 results.next_cursor 读取下一页。
curl -X POST "https://api.socq.ai/v1/telegram/channel-info" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://t.me/durov","https://t.me/tginfo"]}'Telegram Channel Info API 最佳使用场景
- 投放前审核频道: 签约付费推广前,把订阅人数、认证状态和频道简介放在一起核对。
- 维护频道关注清单: 定时重跑同一批链接,把 followers_count 与 collected_at 一起存下,跟踪各个加密、新闻或垂直领域频道的增长。
- 补全外部收集的链接: 把表格、搜索结果或合作方名单里的一列 t.me 链接补成频道标题、简介和受众规模。
Telegram Channel Info API 使用建议
- 以返回的 username 作为主键:t.me/name 和 t.me/s/name 指向同一个频道,得到的 id 相同,多次查询的记录可以直接合并。
- 像 https://t.me/durov/510 这样的帖子链接会按所属频道查询;要获取帖子本身,请改用 Telegram Post Detail API。
相关 API
除了 Telegram Channel Info API,需要其他类型的 Telegram 公开数据时,可以使用以下 API。
- Telegram Channel Scraper API — 从新到旧采集公开 Telegram 频道最多 1000 条帖子,含正文、发布时间、阅读数、反应总数以及图片和视频。
- Telegram Post Detail API — 按链接获取最多 50 条指定的 Telegram 帖子,可混合多个公开频道,含完整正文、发布时间、阅读数、反应数和媒体。
- Telegram Comments API — 从讨论群采集 Telegram 频道帖子下最多 100 条评论,含作者名、正文、时间、反应数和所回复的评论。
- Telegram Similar Channels API — 获取 Telegram 在公开频道旁推荐的相似频道,通常约 10 个,每个含标题、认证标记和精确订阅人数。
- Telegram Channel Search API — 在公开 Telegram 频道的全部历史帖子中搜索关键词或短语,返回最多 100 条匹配帖子及其正文、日期、阅读数和反应数。