TelegramTelegram 频道频道采集API 指南

Telegram 频道 API:频道信息、帖子、评论与频道内搜索

SocQ 新增 6 个面向 Telegram 公开频道的接口:频道信息、帖子流、指定帖子、讨论组评论、相似频道和频道内搜索,附请求示例与按结果计费价格。

SocQ更新于 2026年11月19日阅读约 6 分钟

2026-11-17,SocQ 新增 Telegram 平台,上线 6 个面向 Telegram 公开频道 的接口,覆盖完整的研究流程:核查频道、读取帖子流、拉取指定帖子、读取帖子下的讨论、发现相关频道,以及在频道历史中搜索关键词。

本文逐一说明每个接口返回什么、请求怎么写、价格多少、适合什么场景。所有接口都以公开的 t.me 链接作为输入,并以 SocQ 异步任务的方式运行。

快速回答: 带上 Authorization: Bearer $SOCQ_API_KEY,把公开频道或帖子链接发送到 6 个 POST /v1/telegram/... 接口之一。保存返回的 task_id,轮询 GET /v1/tasks/{task_id} 直到 status 为 succeeded,再从 data.results.items 读取记录。所有接口都按结果计费:每行 0.3 或 0.5 credits,按每 credit $0.005 计算即 $0.0015 或 $0.0025。

6 个新的 Telegram 接口

接口返回内容输入价格
Channel Info频道名称、简介、头像、认证标识、订阅数最多 50 个频道链接每个频道 0.5 credits($0.0025)
Channel Scraper按从新到旧排列的帖子,含正文、时间、浏览量、反应总数、图片和视频1 个频道链接每条帖子 0.3 credits($0.0015)
Post Detail指定帖子的完整正文、时间、浏览量、反应和媒体最多 50 个帖子链接每条帖子 0.5 credits($0.0025)
Comments关联讨论组中的最多 100 条评论,含作者、正文、时间、反应和回复对象1 个帖子链接每条评论 0.3 credits($0.0015)
Similar ChannelsTelegram 在某频道旁推荐的频道,含用户名、名称、认证标识和订阅数1 个频道链接每个频道 0.5 credits($0.0025)
Channel Search在单个频道全部历史中匹配关键词或短语的帖子1 个频道链接 + query每条匹配帖子 0.5 credits($0.0025)

6 个接口都只对返回的行计费,没有单次请求的基础费用。

Telegram Channel Info:批量核查频道

Telegram Channel Info API 通过 t.me/name 或 t.me/s/name 链接查询公开频道,每个频道返回一行:名称、简介、头像、认证标识和订阅数(metrics.followers_count)。适合在赞助投放前核查频道、更新新闻或加密货币频道的关注清单,或补全从其他渠道收集到的频道链接。原始结果文件还包含每个频道分享过的图片、视频和链接数量。

curl -X POST "https://api.socq.ai/v1/telegram/channel-info" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://t.me/durov", "https://t.me/tginfo"]
  }'

每次请求最多 50 个链接。非公开频道的链接会被跳过;只有全部链接都无法读取时任务才会失败并退款。参见 Channel Info 文档。

Telegram Channel Scraper:读取频道帖子流

Telegram Channel Scraper API 从最新一条帖子开始向前读取公开频道。每条帖子包含正文、发布时间、浏览量、表情与 Star 反应总数,以及附带的图片和视频。可以拉取最近几天的内容做每日摘要,也可以调高上限回填频道历史。

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
  }'

results_limit 默认 20,可取 1 到 1,000。无法读取的频道会失败并退款。参见 Channel Scraper 文档。

Telegram Post Detail:刷新已知帖子

如果你已经知道要看哪些帖子,Telegram Post Detail API 接收这些链接,逐条返回完整内容:正文、发布时间、浏览量、反应总数、图片和视频。一次请求可以混合不同频道的帖子,适合刷新一组重点公告或推广帖的数据。原始结果文件保留按表情拆分的反应数和转发来源。

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"]
  }'

最多 50 个链接,格式为 t.me/channel/post_id。已删除的帖子和私有频道中的帖子会被跳过。参见 Post Detail 文档。

Telegram Comments:读取帖子下的讨论

关联了讨论组的频道允许读者在每条帖子下评论。Telegram Comments API 读取一条帖子的评论串,每条评论返回作者名称、正文、时间、反应总数以及它所回复的评论(parent_id)。可用来观察社区对某条公告的反应,或把评论接入客服、研究流程。

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
  }'

results_limit 默认 100,也是上限。只对返回的评论计费。参见 Comments 文档。

Telegram Similar Channels:梳理细分领域

Telegram 会在每个公开频道上展示一排相关频道。Telegram Similar Channels API 返回某个频道的这份列表,通常约 10 个,顺序与 Telegram 展示一致,每个频道含用户名、名称、认证标识和订阅数。从竞品频道或已投放过的频道出发,可以扩充媒体名单。

curl -X POST "https://api.socq.ai/v1/telegram/similar-channels" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://t.me/durov"
  }'

参见 Similar Channels 文档。

Telegram Channel Search:搜索频道历史

Telegram Channel Search API 在公开频道的全部历史中搜索一个词或短语,返回匹配的帖子及其正文、日期、浏览量和反应。可以确认某个有影响力的频道是否提到过某个项目,或收集某频道关于一次发布的全部帖子。

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
  }'

results_limit 默认 20,可取 1 到 100。没有匹配结果的搜索不收费。搜索结果中的图片链接指向展示该图片的帖子。参见 Channel Search 文档。

认证与异步任务流程

每个请求都携带 API key 和 JSON 内容类型:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

每次提交都会启动一个后台任务:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

提交响应返回 data.task_id 和 data.status。用同一个 key 轮询任务:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

任务处于 queued、running 或 failed 时,响应只包含任务元数据;failed 时读取 error_message。任务为 succeeded 时,同一响应会带上第一页标准化记录,位于 data.results.items。limit 默认 50,最大 500。若 has_more 为 true,把 results.next_cursor 作为 cursor 传入即可读取下一页。需要更小的字段集时,fields 最多接受 50 个以逗号分隔的字段或点路径。

客户端超时不会取消任务,因此请用同一个 task_id 继续查询,不要重新提交而为重复采集付费。不想轮询的话,可以在提交请求中加入 callback_url;任务结束时 SocQ 会发送一次带任务摘要的 POST,之后再从任务接口读取记录。

典型任务的费用

  • 用 Channel Info 核查 50 个频道:50 × 0.5 = 25 credits,$0.125。
  • 从一个频道回填 1,000 条帖子:1,000 × 0.3 = 300 credits,$1.50。
  • 读取一条公告下的 100 条评论:30 credits,$0.15。
  • 搜索一个频道并得到 20 条匹配:10 credits,$0.05。

常见问题

这些接口支持私有频道或群组吗?

不支持。它们通过 t.me 链接读取公开频道。Channel Info 和 Post Detail 会跳过无法读取的链接,Comments 读取的是公开频道为帖子关联的讨论组。

Channel Scraper 能往前读多久?

它按从新到旧读取,每次请求的 results_limit 最多 1,000 条帖子。要查找某个主题的更早帖子,请使用 Channel Search,它会搜索频道的全部历史。

反应数包含哪些内容?

对于频道帖子,metrics.likes_count 是表情反应与 Star 反应的总数。Post Detail 的原始结果文件保留按表情拆分的数量。

找不到的频道或帖子会收费吗?

不会。按返回的行计费,没有基础费用。没有匹配的 Channel Search 不收费;若所有链接都无法读取,任务会失败并退款。

怎样发现新的频道来跟踪?

从一个已知频道出发调用 Similar Channels,再把返回的链接传给 Channel Info 对比订阅数。全部接口见 Telegram 平台页,当前费率见 价格页。

TELEGRAM API

使用公开的 Telegram 输入测试工作流

提交公开输入,获取带有可追溯来源上下文的标准化记录。

查看 Telegram API