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
提交一个频道链接和采集条数,按从新到旧读取帖子。
- 向 /v1/telegram/channel-posts 发送 {"url": "https://t.me/durov", "results_limit": 20}。
- 轮询 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-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 一起保存,对标时尽量比较发布时间相近的帖子。
相关 API
除了 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 条匹配帖子及其正文、日期、阅读数和反应数。