telegram/
channel-posts

从最新一条往前采集公开 Telegram 频道的帖子,每个任务最多 1000 条,返回正文、发布时间、阅读数、反应总数以及附带的图片和视频。

Telegram Channel Scraper API

最多 1000 条帖子
从新到旧
阅读数与反应数
图片和视频
每条结果 0.3 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Telegram Channel Scraper

Telegram 频道帖子是公开广播频道里的信息流,每条帖子带有正文、发布时间、阅读数、反应总数以及图片或视频。一批帖子的阅读和反应能反映频道受众真正在看、在回应什么,可用于每日摘要、内容对标和历史存档。

Telegram Channel Scraper API 主要特性

  • 从新到旧,最多 1000 条results_limit 设置采集条数,范围 1 到 1000,默认 20,从最新一条帖子往前读取。
  • 阅读数换算为整数metrics.views_count 把 Telegram 显示的 661K 这类缩写换算成整数,帖子之间可以直接比较和求和。
  • 反应总数含 Star 反应metrics.likes_count 汇总帖子上的全部反应,表情反应和付费 Star 反应都计入同一个互动数。
  • 每条帖子的图片和视频media 列出每个附件的类型(image 或 video)和文件直链。
  • 稳定的帖子 ID每行的 id 由频道名和帖子编号组成,例如 durov/564,url 直接指向这条帖子。

Telegram Channel Scraper API 参数

参数必填描述
url必填一个公开 Telegram 频道链接,例如 https://t.me/durov;也支持 t.me/s/、telegram.me 和 telegram.dog 形式。
results_limit可选采集的帖子数,按从新到旧排列。整数,范围 1 到 1000,默认 20。

如何使用 Telegram Channel Scraper API

提交一个频道链接和采集条数,按从新到旧读取帖子。

  1. 向 /v1/telegram/channel-posts 发送 {"url": "https://t.me/durov", "results_limit": 20}。
  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-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://t.me/durov","results_limit":20}'

Telegram Channel Scraper API 最佳使用场景

  • 频道每日摘要: 每天早上拉取最近 20 到 50 条帖子,汇总一组新闻或行情频道夜间发布的内容。
  • 按阅读数对标内容: 按 views_count 和 likes_count 给频道近期帖子排序,看哪些形式和话题最能留住读者。
  • 回填频道历史存档: 首次用较大的 results_limit 抓下频道历史,之后每次只采集新帖子。
  • 监测公告频道: 关注项目或品牌的公告频道,把新帖子的正文和链接推送到告警或研究数据库。

Telegram Channel Scraper API 使用建议

  • 把 published_at 与上次运行时间对比,遇到已存过的帖子就停止入库,定时任务的数据量和费用都会更小。
  • 需要保留的图片和视频请在采集后尽快下载,Telegram 的文件链接会在一段时间后失效。
  • 阅读数和反应数是采集时刻的数值,每次快照都连同 collected_at 一起保存,对标时尽量比较发布时间相近的帖子。

除了 Telegram Channel Scraper API,需要其他类型的 Telegram 公开数据时,可以使用以下 API。

  • Telegram Channel Info API — 按链接一次查询最多 50 个公开 Telegram 频道,返回标题、简介、头像、认证标记和换算为整数的订阅人数。
  • 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 Scraper API — 常见问题

Telegram Channel Scraper API 是从新到旧采集公开 Telegram 频道帖子的接口,每个任务最多 1000 条,每条帖子包含正文、发布时间、阅读数、反应总数和附带媒体。

通过 results_limit 设置 1 到 1000 条,默认 20 条。帖子按从新到旧返回,设得小就是最近的动态。

在 Telegram 上,likes_count 是这条帖子全部反应的总数,表情反应和付费 Star 反应合并成一个数。

公开频道均可,链接写成 t.me/name、t.me/s/name、telegram.me 或 telegram.dog 形式。频道无法读取时(例如私密频道),任务失败并退还积分。

图片和视频 URL 指向 Telegram 的文件服务器,一段时间后会失效。需要的文件请在任务完成后尽快下载。

每返回一条帖子扣 0.3 积分,默认 20 条共 6 积分,1000 条共 300 积分。