# Telegram 有官方 API 吗？

有：Telegram 的 API 向所有有 Telegram 账号的开发者开放。SocialToAI 不需要 Telegram 的开发者账号就能读它上面公开可见的消息和账号：3 个接口，每次调用 2 积分起（≈ $0.004–$0.0067），失败不扣。官方信息核对于 2026-10-17。

- 页面：https://socialtoai.com/zh/does-telegram-have-an-api/
- 最近更新：2026-10-29

## 简短的回答

有：Telegram 的 API 向所有有 Telegram 账号的开发者开放。

## 官方 API 能做什么、限制在哪

Telegram 的 API 向所有开发者开放：有 Telegram 账号即可在 my.telegram.org 申请 API ID。它是完整的客户端接口，支持频道（可设为公开）和消息搜索，使用须遵守 Telegram 的 API 服务条款。

来源：[Telegram 官方的开发者文档](https://core.telegram.org/api/obtaining_api_id)，核对于 2026-10-17。平台的规则会调整，以它自己的页面为准。

## Telegram 官方的几种 API

| 官方 API | 谁能用、怎么开通 | 费用 | 限制 | 来源 |
| --- | --- | --- | --- | --- |
| Bot API | 任何人：每个机器人创建时拿到自己的 token。 | 默认给用户发消息免费；开通付费群发后，超过每秒 30 条的部分每条 0.1 Stars。 | 给机器人用的 HTTP 接口。机器人只收得到它所在的聊天和频道的消息；发得太快会收到 429 错误。 | [core.telegram.org](https://core.telegram.org/bots/faq)，核对于 2026-10-29 |
| Telegram API（api_id 和 api_hash） | 有 Telegram 账号的人：登录 my.telegram.org，打开 API development tools 填表。每个手机号只能有一个 api_id。 | 官方页面没有写价格。 | 以用户账号登录的完整客户端接口。必须遵守 API 服务条款；用非官方客户端登录的账号会被自动观察，刷屏或刷浏览量会被永久封禁。 | [core.telegram.org](https://core.telegram.org/api/obtaining_api_id)，核对于 2026-10-29 |

## 用 SocialToAI 读 Telegram 的公开数据

SocialToAI 是读取公开可见内容和账号信息的 API 与 MCP 服务。你不需要 Telegram 账号，也不用过应用审核：只要一把 SocialToAI 的 Key，或者在[Claude](https://socialtoai.com/zh/connect/claude.md)、[ChatGPT](https://socialtoai.com/zh/connect/chatgpt.md)、[Claude Code](https://socialtoai.com/zh/connect/claude-code.md)、[Cursor](https://socialtoai.com/zh/connect/cursor.md) 和[Codex](https://socialtoai.com/zh/connect/codex.md) 里登录。每次调用的积分固定，失败不扣。

| 接口 | 返回什么 | 价格键 | 积分 |
| --- | --- | --- | --- |
| [详情](https://socialtoai.com/zh/telegram-detail-api.md) | 用编号或链接取一条消息：正文、作者、播放或阅读数和发布时间。 | `telegram.detail` | 2 |
| [账号资料](https://socialtoai.com/zh/telegram-user-profile-api.md) | 一个账号：名称、简介和粉丝数。 | `telegram.user_profile` | 2 |
| [账号作品](https://socialtoai.com/zh/telegram-user-posts-api.md) | 一个账号最近发布的消息。 | `telegram.user_posts` | 2 |

**一次调用：详情**

```
curl https://api.socialtoai.com/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](https://core.telegram.org/api/obtaining_api_id)，核对于 2026-10-29。

### Bot API 能读频道消息吗？

只能读它所在的频道：Telegram 说机器人会收到它所在频道的全部消息。拉不进去的频道，它就读不到。来源：[core.telegram.org](https://core.telegram.org/bots/faq)，核对于 2026-10-29。

### Telegram API 要钱吗？

官方申请 api_id 的页面没有写任何费用，机器人默认给用户发消息免费；只有开通付费群发、超过每秒 30 条的部分按每条 0.1 Stars 收费。来源：[core.telegram.org](https://core.telegram.org/bots/faq)，核对于 2026-10-29。

### 不申请开发者账号，能读 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 地址，登录后点“允许”，然后用大白话问。每次回答都写明用了多少积分。

## 接着看

- [各平台官方 API 价格和限制一览](https://socialtoai.com/zh/data/official-social-api-pricing.md)：所有平台的官方 API 一页看全，带来源。

## 来源

- [Telegram: core.telegram.org](https://core.telegram.org/api/obtaining_api_id)，核对于 2026-10-17
- [core.telegram.org](https://core.telegram.org/bots/faq)，核对于 2026-10-29
- [SocialToAI 的 Telegram API](https://socialtoai.com/zh/platforms/telegram.md)：每个调用和它的积分，最近实测 2026-10-17
- [实时目录](https://api.socialtoai.com/v1/capabilities)：此刻开放什么、各多少积分，不用 Key 就能读

- [Telegram API](https://socialtoai.com/zh/platforms/telegram.md)：Telegram 上的每个调用和可以照抄的请求。
- [Claude](https://socialtoai.com/zh/connect/claude.md)：接入 Claude：登录即可，不用 Key。
- [ChatGPT](https://socialtoai.com/zh/connect/chatgpt.md)：接入 ChatGPT：登录即可，不用 Key。