Telegram Channel Search
Telegram 频道搜索会在一个公开频道发布过的所有帖子里查找关键词或短语,返回匹配帖子的正文、发布日期、阅读数和反应数。无论提及发生在多久以前都能找到,可以看出有影响力的频道是否报道过某个项目、多常回到某个话题,以及每次提及获得了多少关注。
Telegram Channel Search API 主要特性
- 搜索全部历史query 覆盖频道发布过的所有帖子,几年前的提及和今天的一样能找到。
- 最多 100 条匹配帖子results_limit 设置返回的匹配条数,范围 1 到 100,默认 20。
- 每条匹配的阅读与反应每条匹配帖子都带有 metrics.views_count 和 metrics.likes_count,显示这次提及获得的关注度。
- 只为匹配结果付费每条匹配帖子 0.5 积分,搜索没有结果时不扣费。
Telegram Channel Search API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 要搜索的一个公开 Telegram 频道链接,例如 https://t.me/durov;也支持 t.me/s/、telegram.me 和 telegram.dog 链接。 |
query | 必填 | 要在频道帖子中查找的关键词或短语,例如 TON。 |
results_limit | 可选 | 返回的匹配帖子数。整数,范围 1 到 100,默认 20。 |
如何使用 Telegram Channel Search API
提交频道链接和搜索词,读取匹配的帖子。
- 向 /v1/telegram/channel-search 发送 {"url": "https://t.me/durov", "query": "TON", "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-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://t.me/durov","query":"TON","results_limit":20}'Telegram Channel Search API 最佳使用场景
- 核查频道是否报道过项目: 提出合作前,在意见领袖或新闻频道中搜索你的代币、产品或品牌名称。
- 汇总一次发布的报道: 把某个频道关于新品发布或活动的全部帖子拉到一个列表里,用于复盘。
- 投放前的频道尽调: 搜索频道过去是否推广过竞品或某个话题,在购买投放位前了解它的历史。
- 跨频道话题研究: 对多个频道运行同一个搜索词,比较各自提及的频率以及这些帖子获得的阅读数。
Telegram Channel Search API 使用建议
- 代币符号和项目全名分开各搜一次,覆盖频道可能使用的不同写法。
- 搜索结果中的图片链接指向展示该图片的帖子;需要图片文件时,把帖子 url 交给 Telegram Post Detail API。
- 每次搜索覆盖一个频道;想围绕话题发现更多频道,可以从一个已知频道出发使用 Telegram Similar Channels API。
相关 API
除了 Telegram Channel Search API,需要其他类型的 Telegram 公开数据时,可以使用以下 API。
- Telegram Channel Info API — 按链接一次查询最多 50 个公开 Telegram 频道,返回标题、简介、头像、认证标记和换算为整数的订阅人数。
- Telegram Channel Scraper API — 从新到旧采集公开 Telegram 频道最多 1000 条帖子,含正文、发布时间、阅读数、反应总数以及图片和视频。
- Telegram Post Detail API — 按链接获取最多 50 条指定的 Telegram 帖子,可混合多个公开频道,含完整正文、发布时间、阅读数、反应数和媒体。
- Telegram Comments API — 从讨论群采集 Telegram 频道帖子下最多 100 条评论,含作者名、正文、时间、反应数和所回复的评论。
- Telegram Similar Channels API — 获取 Telegram 在公开频道旁推荐的相似频道,通常约 10 个,每个含标题、认证标记和精确订阅人数。