返回 API 列表
Telegram 公开频道数据

Telegram Public Data API

通过 t.me 链接读取公开 Telegram 频道:带订阅人数的频道资料、带阅读数和反应的帖子、单条帖子、讨论群评论、相似频道以及全历史搜索。

可用的 Telegram API

Channel Info、Channel Scraper、Similar Channels 和 Channel Search 以频道链接为输入,Post Detail 和 Comments 以帖子链接为输入;每条结果都带有可直接交给下一个接口的链接。

可以获取哪些 Telegram 数据?

每个接口都返回稳定的 SocQ 记录,内容来自公开频道对任何访客展示的信息。

频道资料

用户名、标题、简介、头像、认证标记,以及换算为整数的订阅人数,每次最多 50 个频道。

帖子与媒体

正文、发布时间、阅读数、含付费 Star 反应在内的反应总数,以及图片和视频链接;可从新到旧采集最多 1000 条,或按链接获取最多 50 条。

讨论群评论

每条帖子最多 100 条评论,含作者名、正文、时间和反应数,并带有用于还原回复关系的 parent_id 和 post_id。

相似频道

Telegram 在频道旁推荐的频道,通常约 10 个,按 Telegram 的顺序返回,带精确订阅人数。

频道内搜索

在一个频道的全部历史中匹配关键词或短语,返回最多 100 条帖子及其阅读数和反应数。

SocQ 与 Telegram API

Telegram 官方 API 用于开发 Telegram 应用和机器人。SocQ 以标准化记录返回公开频道数据,便于存储、比较和组合。

能力SocQTelegram API
访问方式SocQ API keyTelegram 应用 ID 加已登录账号,或机器人令牌
起始输入公开的 t.me 频道和帖子链接在客户端会话中解析出的 Telegram 对象标识
输出计数为整数的标准化 JSON 记录Telegram 原生对象
工作方式异步任务,结果存储后可分页读取由你自己的客户端实时调用

Telegram API 如何工作

六个接口使用相同的异步提交、轮询和读取流程。

  1. 1. 从链接开始

    把频道链接交给 Channel Info、Channel Scraper、Similar Channels 或 Channel Search,把帖子链接交给 Post Detail 或 Comments。

  2. 2. 轮询任务

    用返回的 task_id 请求 /v1/tasks/{task_id},直到任务成功或失败。

  3. 3. 串联结果

    把 Channel Scraper 或 Channel Search 返回的帖子 url 交给 Comments 或 Post Detail,把 Similar Channels 返回的频道 url 交给 Channel Info。

从一次 API 请求开始

使用 SocQ API key 验证身份。Channel Scraper 默认返回 20 条帖子,最多 1000 条。

curl -X POST "https://api.socq.ai/v1/telegram/channel-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://t.me/durov","results_limit":20}'

# 然后读取其中一条帖子的评论:
# POST /v1/telegram/post-comments
# {"url":"https://t.me/tginfo/4455"}
# 轮询 GET /v1/tasks/{task_id}

常见 Telegram API 使用场景

投放前审核频道

先用 Channel Info 核对订阅人数和认证状态,再用 Channel Scraper 查看近期帖子的阅读数,然后决定是否付费投放。

频道摘要与提醒

定时采集新闻、行情或项目频道的最新帖子,把新内容和链接推送到摘要或提醒中。

社区反馈

拉取公告下的评论并按主题归类,了解读者如何回应、哪些问题反复出现。

梳理细分领域

用 Similar Channels 从种子频道逐层向外扩展,整理出带受众规模的相关频道名单。

提及研究

在有影响力的频道中搜索品牌、代币或产品名称,衡量每次提及获得的关注度。

数据范围

结果反映采集时公开 Telegram 频道对任何访客展示的内容。

  • 所有接口都读取公开频道,以频道用户名或频道内的帖子编号定位。
  • 评论来自频道为帖子关联的讨论群,每个任务每条帖子最多 100 条。
  • Similar Channels 返回 Telegram 为该频道展示的推荐,通常约 10 个。
  • Channel Search 每次请求在一个频道内搜索,覆盖其全部历史,最多返回 100 条匹配。
  • 计数是 collected_at 时刻的快照,图片和视频文件链接为临时链接,需要保留的文件请及时下载。

Telegram API 常见问题

Telegram API 是什么?

Telegram API 是一组 SocQ 接口,通过链接读取公开 Telegram 频道,以标准化 JSON 记录返回频道资料、帖子、讨论群评论、相似频道和频道内搜索结果。

目前有哪些 Telegram API?

Telegram Channel Info API、Telegram Channel Scraper API、Telegram Post Detail API、Telegram Comments API、Telegram Similar Channels API 和 Telegram Channel Search API。

需要 Telegram 账号或机器人令牌吗?

不需要。请求使用你的 SocQ API key 和一个公开频道或帖子链接即可。

支持哪些链接格式?

频道链接如 t.me/durov 或 t.me/s/durov,以及对应的 telegram.me 和 telegram.dog 形式;Post Detail 和 Comments 使用 t.me/durov/510 这样的帖子链接。

订阅数和阅读数以什么形式返回?

以整数返回。Telegram 显示的 9.95M、661K 这类缩写会换算成整数,Similar Channels 返回的是精确订阅人数。

这些接口怎么计费?

Channel Info、Post Detail、Similar Channels 和 Channel Search 每返回一条结果扣 0.5 积分,Channel Scraper 和 Comments 每条帖子或评论扣 0.3 积分。无法读取的链接会被跳过或退款,没有评论的帖子和没有匹配的搜索不扣费。

将不同平台的公开账号、内容与互动数据统一起来,帮助你持续跟踪品牌、达人和话题表现,更高效地完成跨平台监测与分析。