Telegram Comments
Telegram 评论是读者通过频道关联的讨论群在帖子下留下的回复,每条带有作者名、正文、时间、反应数以及所回复的评论。读完这一串评论,就能看出社区如何看待一条公告、哪些问题反复出现、哪些回复获得最多反应,可用于反馈分析、客服分流和社区研究。
Telegram Comments API 主要特性
- 来自讨论群的评论提交一个帖子链接,即可读取该频道关联讨论群里的评论串,每个任务最多 100 条。
- 用 parent_id 还原回复关系parent_id 是回复所针对的评论,可据此重建评论串;post_id(例如 tginfo/4455)把每一行关联到所属帖子。
- 每条评论的反应数metrics.likes_count 给出每条评论的反应总数,便于找出社区最认同的回复。
- 评论直达链接url 以 t.me/channel/post?comment=id 的形式直接打开这条评论,方便审核或引用。
Telegram Comments API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 一个 Telegram 帖子链接,例如 https://t.me/tginfo/4455。评论来自帖子所在公开频道关联的讨论群。 |
results_limit | 可选 | 采集的评论数。整数,范围 1 到 100,默认 100。 |
如何使用 Telegram Comments API
提交一个帖子链接,读取其讨论串中的评论。
- 向 /v1/telegram/post-comments 发送 {"url": "https://t.me/tginfo/4455", "results_limit": 100}。
- 轮询 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-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://t.me/tginfo/4455","results_limit":100}'Telegram Comments API 最佳使用场景
- 了解公告反响: 采集新品发布或政策公告下的评论,按主题归类,看读者如何回应。
- 发现高频问题: 扫描多条帖子的评论正文,找出用户反复提出的问题,再补进文档或帮助中心。
- 客服分流: 把品牌频道帖子评论中涉及故障、支付或账号问题的内容转入客服队列。
- 社区研究: 比较不同帖子的评论量和反应数,了解某个领域里哪些话题最能引发讨论。
Telegram Comments API 使用建议
- 优先选择开启了评论的频道:评论来自频道绑定的讨论群,只按返回的评论计费。
- 通过 parent_id 把回复挂到父评论下还原评论串,再按 metrics.likes_count 把最受认同的回复排到前面。
相关 API
除了 Telegram Comments API,需要其他类型的 Telegram 公开数据时,可以使用以下 API。
- Telegram Channel Info API — 按链接一次查询最多 50 个公开 Telegram 频道,返回标题、简介、头像、认证标记和换算为整数的订阅人数。
- Telegram Channel Scraper API — 从新到旧采集公开 Telegram 频道最多 1000 条帖子,含正文、发布时间、阅读数、反应总数以及图片和视频。
- Telegram Post Detail API — 按链接获取最多 50 条指定的 Telegram 帖子,可混合多个公开频道,含完整正文、发布时间、阅读数、反应数和媒体。
- Telegram Similar Channels API — 获取 Telegram 在公开频道旁推荐的相似频道,通常约 10 个,每个含标题、认证标记和精确订阅人数。
- Telegram Channel Search API — 在公开 Telegram 频道的全部历史帖子中搜索关键词或短语,返回最多 100 条匹配帖子及其正文、日期、阅读数和反应数。