Telegram API 数据接口
消息、账号。
Telegram API(数据接口)可以读消息详情、账号资料和账号发布的消息,不用登录 Telegram 账号,也不用提供 Cookie。每次调用 2 积分(约 $0.004–$0.0067),失败不扣。Telegram 的内容不带作者粉丝数,这个字段返回 null。可以直接发 HTTP 请求,也可以通过 MCP 接到 AI 客户端里用。最近实测:2026-11-16。
最近实测:最近更新:
/v1/detail200 OK2 积分platform: "telegram" · id: "telegram/401"nullcomments nullshares nullcollects nullviews 4,350,000titleauthor.idauthor.verifiedauthor.followers+73 个动作。
同一种返回格式。
点开任意一行,看请求怎么写;完整的参数和返回字段在它自己的页面。
详情用编号或链接取一条消息:正文、作者、播放或阅读数和发布时间。/v1/detail2 积分≈ $0.0067 · ¥0.05
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" }'POST /v1/detailKey 放在 Authorization 请求头里账号资料一个账号:名称、简介和粉丝数。/v1/user_profile2 积分≈ $0.0067 · ¥0.05
curl https://socialtoai.app/v1/user_profile \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "telegram", "username": "telegram" }'POST /v1/user_profileKey 放在 Authorization 请求头里账号作品一个账号最近发布的消息。/v1/user_posts2 积分≈ $0.0067 · ¥0.05
curl https://socialtoai.app/v1/user_posts \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "platform": "telegram", "username": "telegram" }'POST /v1/user_postsKey 放在 Authorization 请求头里Telegram 不提供:搜索、热榜和评论。
和 X 比,Telegram 的消息少给作者粉丝数、点赞、评论数、收藏、转发和话题标签;账号资料少给关注数和作品数。
办成一件事多少钱。
| 要做的事 | 怎么算 | 积分 | 约合 |
|---|---|---|---|
| 回填一个 Telegram 账号:200 条消息列表加 20 条全文 | 10 页列表 + 20 次全文 | 60 积分 | 约 ¥1.4($0.20) |
| 每天盯 1 个 Telegram 账号,一个月最多 | 每次 10 积分 × 31 天 | 310 积分 | 约 ¥7.4($1.03) |
按 $10 档算,买得越多单价越低。监控只在你开启时运行,随时可以暂停,没有订阅。
也可以不管参数。
直接问。
通过 MCP 接一次 SocialToAI,之后该调哪些接口由 AI 决定,每一步花了多少积分你都看得到。
这个 Telegram 账号有多大?最近发了什么?
- user_profile你说的那个账号2 积分
- user_posts最近一页2 积分
查一下这个 Telegram 账号,告诉我它是谁。
- user_profile你说的那个账号2 积分
比较这 3 个 Telegram 账号的粉丝数和发帖数。
- user_profile3 个账号6 积分
每个平台,同一种结构。
学一次就够。
Telegram 的消息和小红书的笔记,返回的字段名一模一样。平台给不了的字段,返回 null。
{ "platform": "telegram", "id": "…", "ref": "…", "approx": [ { "field": "metrics.views", "kind": "approximate" } ], "extra": {}, "type": "content", "url": "https://example.com/…", "format": "video", "title": null, "text": "…", "published_at": "2021-01-11T21:57:12.000Z", "author": { "id": null, "username": "…", "name": "…", "verified": null, "followers": null }, "metrics": { "likes": null, "comments": null, "shares": null, "collects": null, "views": 4350000, "reposts": null }, "images": [], "hashtags": null, "is_pinned": null}titleauthor.idauthor.verifiedauthor.followersmetrics.likesmetrics.commentsmetrics.sharesmetrics.collectsmetrics.repostshashtagsis_pinned{ "platform": "xiaohongshu", "id": "…", "ref": "…", "approx": [], "extra": {}, "type": "content", "url": "https://example.com/…", "format": "image", "title": "…", "text": "…", "published_at": "2026-10-09T01:00:34.000Z", "author": { "id": "…", "username": "…", "name": "…", "verified": null, "followers": null }, "metrics": { "likes": 927, "comments": 122, "shares": 256, "collects": 59, "views": null, "reposts": null }, "images": ["https://example.com/…", "https://example.com/…"], "hashtags": ["…", "…"], "is_pinned": false}author.verifiedauthor.followersmetrics.viewsmetrics.reposts3 个工具能读 Telegram。
全部工具Telegram 有官方 API 吗?
Telegram 的 API 向所有开发者开放:有 Telegram 账号即可在 my.telegram.org 申请 API ID。它是完整的客户端接口,支持频道(可设为公开)和消息搜索,使用须遵守 Telegram 的 API 服务条款。
来源:Telegram 官方开发者文档,核对于 2026-10-30。
| 谁能用 | 费用 | 限制 | 来源 | |
|---|---|---|---|---|
| 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 |
| SocialToAI | 有 Key 就能用,不用你的 Telegram 账号,也不用审核。 | 每次 2 积分起(约 $0.0067),失败不扣。 | 只读公开可见的内容;一次调用最多 20 条。 | 价格 |
在这里读 1,000 条消息:约 50 次 telegram.user_posts 调用(每页通常 20 条),共 100 积分,按第一档约 $0.33。 算一下要多少钱
- Telegram MCP 服务器让你的 AI 直接读 Telegram。