Telegram Post Detail
Telegram 帖子详情是频道中单条帖子的完整记录,包括正文、发布时间、阅读数、反应总数以及附带的图片或视频。对已知的帖子读取这些数值,可以刷新投放帖子的数据、留存公告原文,并给自有记录中的链接补上触达数据。
Telegram Post Detail API 主要特性
- 一次查多个频道的帖子urls 最多接收 50 个 t.me/channel/post_id 形式的链接,同一请求中的链接可以来自不同频道。
- 当前阅读数与反应数metrics.views_count 和 metrics.likes_count 以整数给出帖子在采集时的阅读数和反应总数。
- 完整正文与媒体text 保存帖子全文,media 列出每张图片或每段视频的类型和文件地址。
- 缺失帖子跳过且不计费已删除的帖子和私密频道中的帖子不返回也不扣费;只有全部链接都无法读取时,任务才会失败并退款。
Telegram Post Detail API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 最多 50 个 Telegram 帖子链接,格式为 https://t.me/channel/post_id,例如 https://t.me/durov/510;可混合不同公开频道的链接。 |
如何使用 Telegram Post Detail API
提交需要的帖子链接,每条查到的帖子返回一条完整记录。
- 向 /v1/telegram/post-detail 发送 {"urls": ["https://t.me/durov/510"]}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变为 succeeded。
- 从 results.items 读取帖子;has_more 为 true 时,带上 results.next_cursor 读取下一页。
curl -X POST "https://api.socq.ai/v1/telegram/post-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://t.me/durov/510"]}'Telegram Post Detail API 最佳使用场景
- 刷新投放帖子数据: 保存推广帖或公告帖的链接,定时重新采集,跟踪阅读数和反应数的变化。
- 留存帖子原文: 为报告、争议处理或新闻中引用的帖子保存原文和发布时间,并附上 collected_at。
- 补全分享来的帖子链接: 把从群聊、文章或表格中收集的帖子链接补成包含所属频道、触达数据和媒体的完整记录。
Telegram Post Detail API 使用建议
- 不同频道的帖子链接可以合并成一次最多 50 条的请求,无需逐条提交。
- author.username 是每条帖子所属的频道,方便给混合批次按频道分组。
- 只想拿频道最新帖子、手里没有帖子链接时,请用 Telegram Channel Scraper API;Post Detail 适合已经能定位到的帖子。
相关 API
除了 Telegram Post Detail API,需要其他类型的 Telegram 公开数据时,可以使用以下 API。
- Telegram Channel Info API — 按链接一次查询最多 50 个公开 Telegram 频道,返回标题、简介、头像、认证标记和换算为整数的订阅人数。
- Telegram Channel Scraper API — 从新到旧采集公开 Telegram 频道最多 1000 条帖子,含正文、发布时间、阅读数、反应总数以及图片和视频。
- Telegram Comments API — 从讨论群采集 Telegram 频道帖子下最多 100 条评论,含作者名、正文、时间、反应数和所回复的评论。
- Telegram Similar Channels API — 获取 Telegram 在公开频道旁推荐的相似频道,通常约 10 个,每个含标题、认证标记和精确订阅人数。
- Telegram Channel Search API — 在公开 Telegram 频道的全部历史帖子中搜索关键词或短语,返回最多 100 条匹配帖子及其正文、日期、阅读数和反应数。