Telegram 公开数据 API | SandBase

选择 Telegram 频道资料或少量近期消息,了解 channel 输入、业务结构、缩略计数与游标边界,使用一个 SandBase Key 接入。

深色电影质感画面:Telegram 频道、帖子与评论数据经由同一条 API 管道汇入 Agent 内核

读取公开 Telegram 频道,不必一开始就搭成账号集成项目。先问自己:需要频道资料,还是几条近期消息?资料帮助确认来源,消息小样本帮助了解内容。如果自动把两者和每帖评论都读一遍,工作量已经超过了任何一个首请求问题。

本次 2026-11-08 修订通过免费 inspect 和保存的公开参考核对 channel-info、channel-posts,没有新的业务调用。2026-09-27 UTC 的原资料摘录仍在下方。评论、搜索、相似频道只是历史目录导航,不表示本轮重新验证了一整条研究链路。

先说结论

  • 两个所选请求都使用 channel 字段;返回的 username 不会改变输入名称。
  • 资料和近期消息独立选择。帖子示例明确 limit 3,不发送续页游标。
  • outputs[0].data 直接就是资料或 messages/pagination 对象,不套其他 provider 的 data 层或 status_code 规则。
  • 订阅量和 views 可以是缩略字符串,不能据此证明精确受众增长或独立读者数。

沿用封面是概念插画,身份、卡片、计数和频道到评论的链路均为示意,不是本轮验证的结果或已执行动作。

根据任务选择接口

所选 SandBase 请求使用 SandBase Key,不需要在请求中提供 Telegram 登录、Bot token 或 MTProto 会话。它们不代表 Telegram 用户执行动作,也不提供私聊访问。SandBase 是接入层,不拥有或运营 Telegram;本文不是官方合作声明。

机器人动作和账号授权属于另一类集成决定。公开资料响应不是账号凭据,能读一个频道也不代表能访问所有相关群组或讨论。这里聚焦两个公开读取,不把其他动作混入默认工作流。

第一个问题精确入口请求业务结构
这是我想读的频道吗?频道资料{"channel":"telegram"}title、username 等资料字段
近期小样本里有什么?频道帖子{"channel":"telegram","limit":3}channel、messages、pagination

资料 schema 接受裸名称、@handle 或 t.me 链接,并说明会自动归一化。帖子只描述频道用户名,因此共用教程对两者都使用裸名称 telegram。本地较严格的输入检查不抹掉资料 API 的链接支持;输出里虽然有 username,实际请求字段仍是 channel。

历史 Telegram 目录 历史 Telegram 目录截图。旧端点数量和目录 GET 标签用于导航,不是新的可用性检查,也不是当前 POST 示例的执行方式。

给 Agent 一个有边界的首任务

已有 Key 就保存在运行环境或密钥管理器里,已连接 Agent 直接复用。新项目可从 SKILL.md、quickstart.md 和快速开始入手,并明确一个选定结果。不要把秘密发进聊天。

例如,让 Agent 查看一个公开频道资料,返回字段名称,没有的值保持未知。这样就能检查首次接入,不需要创建监控调度、抓帖子或分析评论。Python 首请求教程另有独立的三条消息任务,并检查传输错误和业务结构。

Shell
curl --fail-with-body --connect-timeout 10 --max-time 90 \
  -X POST https://api.sandbase.ai/v1/api/telegram/web/channel-info \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel":"telegram"}'

curl 只打印一次响应,HTTP 处理不代替业务校验。需要确认 completed 和 outputs[0].data 对象;资料参考还要检查 title、username 字符串。教程会拒绝缺失身份字段,而不是把空对象当成成功确认了频道,也会处理 JSON、超时和跳转,不暴露响应正文或凭据。

独立帖子任务改选帖子 URL,输入 {"channel":"telegram","limit":3}。响应需要 channel、对象组成的 messages 数组和 pagination 对象。明确空 messages 与数组缺失不同。这些参考没有额外业务 data 层,也没有要求 status_code 为零;把其他平台的 parser 搬过来会读错位置。

原资料摘录说明了什么

以下截断结果来自原 2026-09-27 UTC 记录,run 为 b7159c20-ae57-47cb-bf5d-e34ab1020d10。订阅显示值属于历史,不是最新受众测量:

JSON
{
  "id": "b7159c20-ae57-47cb-bf5d-e34ab1020d10",
  "status": "completed",
  "model": "telegram/web/channel-info",
  "outputs": [
    {
      "data": {
        "title": "Telegram News",
        "username": "telegram",
        "subscribers": "9.46M",
        "verified": true,
        "counters": { "photos": "16", "videos": "228", "links": "378" }
      }
    }
  ]
}

另有独立公开保存样例,资料 created_at 为 2026-10-07T17:37:02.535Z,帖子为 2026-10-07T17:37:14.205Z。保存请求都使用 channel telegram,帖子明确 limit 3。它们的业务对象直接是资料字段或 messages/pagination,支持当前 parser;11 月 8 日阅读这些样例不会让它们变成新执行。

短 README 资料样本与完整保存记录展示不同缩略订阅字符串,要各自绑定来源。本轮不会从差值推导增长率,也不假装它们是同步观测。配套教程还保留旧文同一 run ID 复用的疑点,不编造一段修正后的调用历史。

历史 channel-info 参数参考 历史 channel-info 参数与信封参考。当前输入是 channel;图片不能让旧订阅数字变成当前值,也不能证明精确受众规模。

计数必须带上语境

所选参考的 subscribers 和 counters 是字符串,有时用 M 缩略;views 也可能缩略。把原显示值、频道、来源和获取时间一起保留。后续换成数字估计或许有用,但无法恢复隐藏精度,不应写成准确的人数。

消息 views 不证明独立读者、互动质量或转化量。把它与频道的舍入订阅数相比,也得不到精确互动率。缺失 views 保留未知;空 reactions 不能说明所有入口都没有互动。false 和 null 各有含义,不要为了计算方便全部换成零。

资料与活动还属于不同层级。profile title 表示显示的频道,而消息 author、forwarded_from 提供的是单条帖子的背景。以后跨频道存储时,要用 channel 加 message ID;仅按 ID 建表可能在不同频道间冲突。转发消息也不是自动扩大查询到来源频道的命令。

小样本不是完整归档

帖子 limit 为 1–100 的整数,默认 20;schema 明确说明超过 20 会由服务端自动向旧帖翻页。因此请求 100 不只是本地多打印几行,它改变了请求内部的获取量。首请求固定为 3,省略 before、after,不承诺完整覆盖或恰好返回三条。

契约规定 after、before 分别用于较新和较旧消息的整数游标,来自上一响应 pagination.after_cursor、pagination.before_cursor,默认零。保存样例还提供 has_more_before、count、pages_fetched 等分页观测。返回了就保留,不从 ID 制造游标,也不按预期 limit 编造实际 count。

本轮没有测试续页,不保证告警无重复、历史穷尽或失败轮询后能无缝恢复。周期系统仍需存储、错误处理、游标持久化规则与单独决定的工作量。当前 helper 在一次响应后停止,让这些决定保持可见。

历史 channel-posts 参数参考 历史 channel-posts 参数参考,不是端点列表截图。图中分页输入描述可发出的请求,但本轮没有执行下一页或监控调度。

其他能力作为独立任务

Telegram 目录可帮助寻找下一个问题。下表是历史导航,不是本轮复验过的响应:

能力代表路由使用前再确认
单条帖子telegram/web/post-detail频道上下文、帖子标识和响应结构
评论telegram/web/post-comments当前输入和该讨论串可用性
频道内搜索telegram/web/channel-search搜索输入与自身结果结构
相似频道telegram/web/similar-channels当前契约及推荐结果边界

统一鉴权不代表业务字段可互换。资料成功不能替评论端点做验收,返回链接预览也不意味着应自动访问目标页。所选任务不渲染 text_html、不下载图/视频 URL,也不逐条查询回复。应用中的 HTML、媒体完整性和归属展示要分别处理,不能因为接入入口统一就省略这些检查。

价格和下一步决定

2026-11-08 免费 inspect 显示,每个所选端点为 $0.001,符合组织内合格 API 每日共享 100 次额度,00:00 UTC 重置。资格不是剩余额度或余额,也不能证明一次请求会免费成功。本轮未测实际扣费或新的业务结果。

选择一次读取标价 $0.001;独立选择资料与帖子才是 $0.002,尚未考虑额度。重试、轮询和每帖评论调用会增加次数;超过 20 的帖子 limit 也意味着只数 HTTP 请求不足以描述底层翻页量。明确下一个交付结果,再扩大任务。

常见问题

发送 username 还是 channel? 发送 channel。username 是资料响应中观察到的字段。共用示例使用裸 handle,资料端点单独有文档说明归一化支持。

这已经是一个 Telegram 监控器了吗? 这里提供有边界的首次响应,本轮没有新轮询、续页、调度或评论遍历,也不作这些成功声明。

缩略计数可以证明精确增长吗? 不可以。保留原标签和日期,不把舍入显示当成精确受众变化或独立读者总数。

以前的 Python 去哪里了? 历史归档逐字保留并附哈希。当前首请求使用新版教程,原代码作为证据留存,不再当作现行指引。

觉得有用?分享给更多人