Telegram Public Data API
通过 t.me 链接读取公开 Telegram 频道:带订阅人数的频道资料、带阅读数和反应的帖子、单条帖子、讨论群评论、相似频道以及全历史搜索。
可用的 Telegram API
Channel Info、Channel Scraper、Similar Channels 和 Channel Search 以频道链接为输入,Post Detail 和 Comments 以帖子链接为输入;每条结果都带有可直接交给下一个接口的链接。
可以获取哪些 Telegram 数据?
每个接口都返回稳定的 SocQ 记录,内容来自公开频道对任何访客展示的信息。
频道资料
用户名、标题、简介、头像、认证标记,以及换算为整数的订阅人数,每次最多 50 个频道。
帖子与媒体
正文、发布时间、阅读数、含付费 Star 反应在内的反应总数,以及图片和视频链接;可从新到旧采集最多 1000 条,或按链接获取最多 50 条。
讨论群评论
每条帖子最多 100 条评论,含作者名、正文、时间和反应数,并带有用于还原回复关系的 parent_id 和 post_id。
相似频道
Telegram 在频道旁推荐的频道,通常约 10 个,按 Telegram 的顺序返回,带精确订阅人数。
频道内搜索
在一个频道的全部历史中匹配关键词或短语,返回最多 100 条帖子及其阅读数和反应数。
SocQ 与 Telegram API
Telegram 官方 API 用于开发 Telegram 应用和机器人。SocQ 以标准化记录返回公开频道数据,便于存储、比较和组合。
| 能力 | SocQ | Telegram API |
|---|---|---|
| 访问方式 | SocQ API key | Telegram 应用 ID 加已登录账号,或机器人令牌 |
| 起始输入 | 公开的 t.me 频道和帖子链接 | 在客户端会话中解析出的 Telegram 对象标识 |
| 输出 | 计数为整数的标准化 JSON 记录 | Telegram 原生对象 |
| 工作方式 | 异步任务,结果存储后可分页读取 | 由你自己的客户端实时调用 |
Telegram API 如何工作
六个接口使用相同的异步提交、轮询和读取流程。
1. 从链接开始
把频道链接交给 Channel Info、Channel Scraper、Similar Channels 或 Channel Search,把帖子链接交给 Post Detail 或 Comments。
2. 轮询任务
用返回的 task_id 请求 /v1/tasks/{task_id},直到任务成功或失败。
3. 串联结果
把 Channel Scraper 或 Channel Search 返回的帖子 url 交给 Comments 或 Post Detail,把 Similar Channels 返回的频道 url 交给 Channel Info。
使用 SocQ API key 验证身份。Channel Scraper 默认返回 20 条帖子,最多 1000 条。
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}'
# 然后读取其中一条帖子的评论:
# POST /v1/telegram/post-comments
# {"url":"https://t.me/tginfo/4455"}
# 轮询 GET /v1/tasks/{task_id}常见 Telegram API 使用场景
投放前审核频道
先用 Channel Info 核对订阅人数和认证状态,再用 Channel Scraper 查看近期帖子的阅读数,然后决定是否付费投放。
频道摘要与提醒
定时采集新闻、行情或项目频道的最新帖子,把新内容和链接推送到摘要或提醒中。
社区反馈
拉取公告下的评论并按主题归类,了解读者如何回应、哪些问题反复出现。
梳理细分领域
用 Similar Channels 从种子频道逐层向外扩展,整理出带受众规模的相关频道名单。
提及研究
在有影响力的频道中搜索品牌、代币或产品名称,衡量每次提及获得的关注度。
数据范围
结果反映采集时公开 Telegram 频道对任何访客展示的内容。
- 所有接口都读取公开频道,以频道用户名或频道内的帖子编号定位。
- 评论来自频道为帖子关联的讨论群,每个任务每条帖子最多 100 条。
- Similar Channels 返回 Telegram 为该频道展示的推荐,通常约 10 个。
- Channel Search 每次请求在一个频道内搜索,覆盖其全部历史,最多返回 100 条匹配。
- 计数是 collected_at 时刻的快照,图片和视频文件链接为临时链接,需要保留的文件请及时下载。
Telegram API 常见问题
Telegram API 是什么?
Telegram API 是一组 SocQ 接口,通过链接读取公开 Telegram 频道,以标准化 JSON 记录返回频道资料、帖子、讨论群评论、相似频道和频道内搜索结果。
目前有哪些 Telegram API?
Telegram Channel Info API、Telegram Channel Scraper API、Telegram Post Detail API、Telegram Comments API、Telegram Similar Channels API 和 Telegram Channel Search API。
需要 Telegram 账号或机器人令牌吗?
不需要。请求使用你的 SocQ API key 和一个公开频道或帖子链接即可。
支持哪些链接格式?
频道链接如 t.me/durov 或 t.me/s/durov,以及对应的 telegram.me 和 telegram.dog 形式;Post Detail 和 Comments 使用 t.me/durov/510 这样的帖子链接。
订阅数和阅读数以什么形式返回?
以整数返回。Telegram 显示的 9.95M、661K 这类缩写会换算成整数,Similar Channels 返回的是精确订阅人数。
这些接口怎么计费?
Channel Info、Post Detail、Similar Channels 和 Channel Search 每返回一条结果扣 0.5 积分,Channel Scraper 和 Comments 每条帖子或评论扣 0.3 积分。无法读取的链接会被跳过或退款,没有评论的帖子和没有匹配的搜索不扣费。
结合多平台数据,获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来,帮助你持续跟踪品牌、达人和话题表现,更高效地完成跨平台监测与分析。
Link in Bio API
把创作者 Instagram、TikTok 或 YouTube 简介里的那一个链接变成结构化数据:显示名称、简介、头像、公开的联系邮箱、关联社媒账号,以及页面上每个按钮的标题和目标地址。
Creator API
从一个 Instagram、TikTok、YouTube、X、Facebook 或 Threads 主页出发,查找创作者公开的商务邮箱、他在其他平台的账号,或根据头像估算年龄和性别。
Google Hotels API
按目的地搜索酒店,查看任意酒店在 Google Hotels 上的完整资料,并获取它的每晚价格日历,三者通过同一个酒店 ID 串联。
Brand Monitoring API
查找提及某个品牌、产品或话题的网页,为每个网页打出情感和情绪评分,并汇总全网如何谈论它。
AI Search API
追踪 AI 概览、ChatGPT 和 Google AI 模式如何回答你所在市场的问题:哪些回答点名了你的品牌、你的可见度有多高,以及它们引用了哪些域名和页面。
Instagram API
通过统一异步流程查询已知 username 或发现公开主页,并采集粉丝列表记录、关注关系、账号发布的帖子、标记主页的帖子、hashtag 结果、Reels、字幕文本、评论、账号计数、互动指标和媒体元数据。





