telegram/
channel-search

在公开 Telegram 频道的全部历史帖子中搜索关键词或短语,返回最多 100 条匹配帖子,含正文、发布日期、阅读数和反应数。

Telegram Channel Search API

覆盖频道全部历史
最多 100 条匹配
阅读数与反应数
无匹配不计费
每条结果 0.5 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

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

提交频道链接和搜索词,读取匹配的帖子。

  1. 向 /v1/telegram/channel-search 发送 {"url": "https://t.me/durov", "query": "TON", "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-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。

除了 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 个,每个含标题、认证标记和精确订阅人数。

探索其他平台

还可以将 Telegram 数据与其他已支持社交平台的公开数据结合使用。

Telegram Channel Search API — 常见问题

Telegram Channel Search API 是在单个公开 Telegram 频道的全部历史帖子中搜索关键词或短语的接口,返回最多 100 条匹配帖子及其正文、发布日期、阅读数和反应数。

搜索范围是 url 传入的那个频道,覆盖该频道的全部历史。想按话题发现新频道,可以从已知频道出发使用 Telegram Similar Channels API。

最多 100 条匹配帖子,由 results_limit 设置,默认 20 条。

搜索结果中的图片链接指向展示该图片的帖子。把帖子链接交给 Telegram Post Detail API,即可拿到图片文件。

每返回一条匹配帖子扣 0.5 积分,默认 20 条共 10 积分。没有匹配结果时不扣费。