telegram/
channel-info

用 t.me 链接一次查询最多 50 个公开 Telegram 频道,每个频道返回用户名、标题、简介、头像、认证标记和订阅人数。

Telegram Channel Info API

每次最多 50 个频道
订阅数为整数
认证标记
t.me 与 t.me/s 链接
每条结果 0.5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

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

提交一组频道链接,每个查到的频道返回一行。

  1. 向 /v1/telegram/channel-info 发送 {"urls": ["https://t.me/durov", "https://t.me/tginfo"]}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
  3. 从 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。

除了 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 条匹配帖子及其正文、日期、阅读数和反应数。

探索其他平台

还可以将 Telegram 数据与其他已支持社交平台的公开数据结合使用。

Telegram Channel Info API — 常见问题

Telegram Channel Info API 是按频道链接查询公开 Telegram 频道资料的接口,每次最多 50 个频道,返回用户名、标题、简介、头像、认证标记和订阅人数。

支持 t.me/name、t.me/s/name 形式的频道链接,以及 telegram.me 和 telegram.dog 链接。频道用户名以字母开头,长度为 5 到 32 个字符。

私密或已删除的频道会被跳过且不计费,同批其他频道正常返回。如果所有链接都无法读取,任务失败并退还积分。

Telegram 常把订阅数显示为 9.95M 这类缩写,返回时换算成对应的整数;Telegram 公布精确数值时,则返回精确值。

每返回一个频道扣 0.5 积分,50 个链接都能读取时共 25 积分,被跳过的链接不扣费。