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 Channels | Telegram 在某频道旁推荐的频道,含用户名、名称、认证标识和订阅数 | 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"
}'
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 平台页,当前费率见 价格页。