Telegram API 数据接口

消息、账号。

Telegram API（数据接口）可以读消息详情、账号资料和账号发布的消息，不用登录 Telegram 账号，也不用提供 Cookie。每次调用 2 积分（约 $0.004–$0.0067），失败不扣。Telegram 的内容不带作者粉丝数，这个字段返回 null。可以直接发 HTTP 请求，也可以通过 MCP 接到 AI 客户端里用。最近实测：2026-10-17。

免费开始登录后运行

6 个里 3 个动作可用

2 积分起每次调用

同一种格式和其他调用一样

最近实测：2026-10-17最近更新：2026-10-17

POST/v1/detail200 OK2 积分

platform: "telegram" · id: "telegram/401"

@…·2021-01-11

nullnullnullnull4,350,000

这里始终是 null：titleauthor.idauthor.verifiedauthor.followers+7

items一个对象

billing本次调用2 积分

示例数据完整返回

3 个动作。
同一种返回格式。

点开任意一行，看请求怎么写；完整的参数和返回字段在它自己的页面。

动作每次调用积分

详情用编号或链接取一条消息：正文、作者、播放或阅读数和发布时间。/v1/detail2 积分

请求里要带

platformid 或 url

全部参数和返回字段

登录后运行2 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。

cURL

curl https://api.socialtoai.com/v1/detail \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -H "Content-Type: application/json" \  -d '{    "platform": "telegram",    "id": "telegram/401"  }'

POST /v1/detailKey 放在 Authorization 请求头里

账号资料一个账号：名称、简介和粉丝数。/v1/user_profile2 积分

请求里要带

platformusername

全部参数和返回字段

登录后运行2 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。

cURL

curl https://api.socialtoai.com/v1/user_profile \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -H "Content-Type: application/json" \  -d '{    "platform": "telegram",    "username": "telegram"  }'

POST /v1/user_profileKey 放在 Authorization 请求头里

账号作品一个账号最近发布的消息。/v1/user_posts2 积分

请求里要带

platformusername

全部参数和返回字段

登录后运行2 积分登录后带着这个接口进入 Playground，不会自动运行。调用失败不扣积分。

cURL

curl https://api.socialtoai.com/v1/user_posts \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -H "Content-Type: application/json" \  -d '{    "platform": "telegram",    "username": "telegram"  }'

POST /v1/user_postsKey 放在 Authorization 请求头里

Telegram 不提供：搜索、热榜和评论。

也可以不管参数。
直接问。

通过 MCP 接一次 SocialToAI，之后该调哪些接口由 AI 决定，每一步花了多少积分你都看得到。

你问01

这个 Telegram 账号有多大？最近发了什么？

AI 会调用

user_profile你说的那个账号2 积分
user_posts最近一页2 积分

合计4 积分

你问02

查一下这个 Telegram 账号，告诉我它是谁。

AI 会调用

user_profile你说的那个账号2 积分

合计2 积分

你问03

比较这 3 个 Telegram 账号的粉丝数和发帖数。

AI 会调用

user_profile3 个账号6 积分

合计6 积分

每个平台，同一种结构。
学一次就够。

Telegram 的消息和小红书的笔记，返回的字段名一模一样。平台给不了的字段，返回 null。

Telegram详情 · 2 积分

{  "platform": "telegram",  "id": "…",  "ref": "…",  "approx": [    {      "field": "metrics.views",      "kind": "approximate"    }  ],  "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}

Telegram 给不了，返回 null：titleauthor.idauthor.verifiedauthor.followersmetrics.likesmetrics.commentsmetrics.sharesmetrics.collectsmetrics.repostshashtagsis_pinned

小红书详情 · 12 积分

{  "platform": "xiaohongshu",  "id": "…",  "ref": "…",  "approx": [],  "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}