Telegram 有官方 API 吗?(2026)
有:Telegram 的 API 向所有有 Telegram 账号的开发者开放。SocialToAI 不需要 Telegram 的开发者账号就能读它上面公开可见的消息和账号:3 个接口,每次调用 2 积分起(≈ $0.004–$0.0067),失败不扣。官方信息核对于 2026-10-30。
简短的回答
有:Telegram 的 API 向所有有 Telegram 账号的开发者开放。
| 方式 | 能读什么、谁能用 | 价格 |
|---|---|---|
| Bot API | 任何人:每个机器人创建时拿到自己的 token。 | 默认给用户发消息免费;开通付费群发后,超过每秒 30 条的部分每条 0.1 Stars。 |
| Telegram API(api_id 和 api_hash) | 有 Telegram 账号的人:登录 my.telegram.org,打开 API development tools 填表。每个手机号只能有一个 api_id。 | 官方页面没有写价格。 |
| 第三方托管接口(本站) | 有 Key 就能用:不用 Telegram 账号,不用开发者审核。 | 每次 2 积分起(约 ¥0.05),失败不扣。 |
官方 API 能做什么、限制在哪
Telegram 的 API 向所有开发者开放:有 Telegram 账号即可在 my.telegram.org 申请 API ID。它是完整的客户端接口,支持频道(可设为公开)和消息搜索,使用须遵守 Telegram 的 API 服务条款。
来源:Telegram 官方的开发者文档,核对于 2026-10-30。平台的规则会调整,以它自己的页面为准。
Telegram 官方的几种 API
| 官方 API | 谁能用、怎么开通 | 费用 | 限制 | 来源 |
|---|---|---|---|---|
| Bot API | 任何人:每个机器人创建时拿到自己的 token。 | 默认给用户发消息免费;开通付费群发后,超过每秒 30 条的部分每条 0.1 Stars。 | 给机器人用的 HTTP 接口。机器人只收得到它所在的聊天和频道的消息;发得太快会收到 429 错误。 | core.telegram.org,核对于 2026-10-30 |
| Telegram API(api_id 和 api_hash) | 有 Telegram 账号的人:登录 my.telegram.org,打开 API development tools 填表。每个手机号只能有一个 api_id。 | 官方页面没有写价格。 | 以用户账号登录的完整客户端接口。必须遵守 API 服务条款;用非官方客户端登录的账号会被自动观察,刷屏或刷浏览量会被永久封禁。 | core.telegram.org,核对于 2026-10-30 |
怎么申请 api_id 和 api_hash
| 步骤 | 怎么做 | 来源 |
|---|---|---|
| 1 | 先用 Telegram 的官方应用注册账号。 | core.telegram.org,核对于 2026-10-30 |
| 2 | 登录 my.telegram.org。 | core.telegram.org,核对于 2026-10-30 |
| 3 | 打开 API development tools,填写表单。 | core.telegram.org,核对于 2026-10-30 |
| 4 | 复制页面给出的 api_id 和 api_hash:应用登录用户账号时两个都要用。每个手机号只能有一个 api_id。 | core.telegram.org,核对于 2026-10-30 |
改用机器人:怎么拿 bot token
| 步骤 | 怎么做 | 来源 |
|---|---|---|
| 1 | 在 Telegram 里给 @BotFather 发送 /newbot。 | core.telegram.org,核对于 2026-10-30 |
| 2 | 给机器人起名字和用户名;用户名必须以 bot 结尾,之后不能再改。 | core.telegram.org,核对于 2026-10-30 |
| 3 | BotFather 会回复这个机器人的 token,调用 Bot API 时用它授权。务必保密:拿到 token 的人就能控制这个机器人。 | core.telegram.org,核对于 2026-10-30 |
用 SocialToAI 读 Telegram 的公开数据
SocialToAI 是读取公开可见内容和账号信息的 API 与 MCP 服务。你不需要 Telegram 账号,也不用过应用审核:只要一把 SocialToAI 的 Key,或者在Claude、ChatGPT、Claude Code、Cursor 和Codex 里登录。每次调用的积分固定,失败不扣。
| 接口 | 返回什么 | 积分 |
|---|---|---|
| Telegram 详情接口 | 用编号或链接取一条消息:正文、作者、播放或阅读数和发布时间。 | 2 |
| Telegram 账号资料接口 | 一个账号:名称、简介和粉丝数。 | 2 |
| Telegram 账号作品接口 | 一个账号最近发布的消息。 | 2 |
curl https://socialtoai.app/v1/detail \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "telegram", "id": "telegram/401" }'- 你这边不需要 Telegram 账号、Cookie 或开发者审批。
- 返回的是平台上公开可见的内容;评论者一律匿名。
- 所有平台返回同一种格式,读 Telegram 和读其他平台用同一套代码。
- 每次调用 2 积分起,预付积分;注册送 100 积分,不用绑卡。
不用官方 API,怎么采集 Telegram 的公开数据
大致有三种办法,区别在于你要交出什么、要自己维护什么。下面说的是工具的类型,不是具体产品。
| 办法 | 你要准备什么 | 要注意什么 |
|---|---|---|
| 自己写爬虫 | 代码、代理,常常还要你自己的 Telegram 登录状态或 Cookie | 以你账号名义发出的请求可能被限流或封号;页面和签名会变,代码要一直维护。 |
| 在本机跑开源 MCP 或脚本 | 装好后用你的账号扫码登录,或贴上 Cookie | 它以你的账号去读;平台一改版、电脑一关机就停。 |
| 调用托管接口(SocialToAI) | 一把 SocialToAI 的 Key,或一个 MCP 地址加登录 | 不用你的账号;每次 2 积分起,失败不扣;跟上 Telegram 的变化是我们的事。 |
常见问题
怎么申请 api_id 和 api_hash?
先用官方应用注册 Telegram,登录 my.telegram.org,打开 API development tools 填表,就能拿到 api_id 和 api_hash。每个手机号只能有一个 api_id。来源:core.telegram.org,核对于 2026-10-30。
bot token 和 api_id 有什么区别,该用哪个?
bot token 属于机器人:创建机器人时由 @BotFather 给出,用来给机器人调用 Bot API 授权。api_id 和 api_hash 属于用完整 Telegram API 登录用户账号的应用,在 my.telegram.org 申请,步骤见上。来源:core.telegram.org,核对于 2026-10-30。
Bot API 能读频道消息吗?
只能读它所在的频道:Telegram 说机器人会收到它所在频道的全部消息。拉不进去的频道,它就读不到。来源:core.telegram.org,核对于 2026-10-30。
Telegram API 要钱吗?
官方申请 api_id 的页面没有写任何费用,机器人默认给用户发消息免费;只有开通付费群发、超过每秒 30 条的部分按每条 0.1 Stars 收费。来源:core.telegram.org,核对于 2026-10-30。
不申请开发者账号,能读 Telegram 吗?
能。SocialToAI 替你读 Telegram 上公开可见的消息和账号:3 个接口,每次 2 积分起(约 ¥0.05),失败不扣。只要一把 SocialToAI 的 Key,或在 AI 客户端里登录。
这样采集 Telegram 会封号吗?
不会牵连你的账号:全程不用你的 Telegram 账号,不登录、不交 Cookie、不装任何东西,没有任何读取是以你的账号名义发生的。
在这里读 Telegram 多少钱?
每次 2 积分起:按第一档约 $0.0067(约 ¥0.05),一千次约 $6.67。失败不扣,每次返回都写明扣了多少。注册送 100 积分,不用绑卡。
Claude 和 ChatGPT 能读 Telegram 吗?
能:在 Claude 或 ChatGPT 里添加 SocialToAI 的 MCP 地址,登录后点“允许”,然后用大白话问。每次回答都写明用了多少积分。
接着看
来源
- Telegram: core.telegram.org,核对于 2026-10-30
- core.telegram.org,核对于 2026-10-30
- core.telegram.org,核对于 2026-10-30
- SocialToAI 的 Telegram API:每个调用和它的积分,最近实测 2026-11-16
- 实时目录:此刻开放什么、各多少积分,不用 Key 就能读
最近更新: