POST/v1/user_profile"platform": "telegram"

Telegram 账号资料接口

一个账号。

Telegram 账号资料 API（数据接口）按账号名返回一个公开的 Telegram 账号：名称、简介和粉丝数，返回格式和 SocialToAI 的其他调用相同。每次调用 2 积分（约 $0.004–$0.0067），失败不扣。用 HTTP 调用，或让 AI 客户端通过 MCP 调用。最近实测：2026-10-17。

免费开始登录后运行

注册送 100 积分，不用绑卡

2 积分每次调用

一个对象每次调用返回

2026-10-17最近实测

734 B示例返回的体积（1 条）

最近更新：2026-10-17

请求与返回

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

import osimport requestsresponse = requests.post(    "https://api.socialtoai.com/v1/user_profile",    headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"},    json={        "platform": "telegram",        "username": "telegram",    },)print(response.json())

# 已经通过 MCP 接好了？直接用大白话问。查一下这个 Telegram 账号：telegram# 你的 AI 会调用 user_profile 工具，参数是：{  "platform": "telegram",  "username": "telegram"}

登录后运行2 积分登录后带着这些参数进入 Playground，不会自动运行。

200 OK734 B2 积分

{  "platform": "telegram",  "status": "ok",  "items": [    {      "platform": "telegram",      "id": null,      "ref": "…",      "approx": [],      "type": "account",      "username": "…",      "name": "…",      "url": "https://example.com/…",      "bio": "…",      "verified": true,      "followers": 10816949,      "following": null,      "posts_count": null    }  ],  "unavailable": ["id", "following", "posts_count"],  "cost_credits": 2}

@…·示例里的文字已去掉

10,816,949 粉丝null 关注null 作品

示例里的名称和正文已去掉，数字是录制时的真实值。

示例数据完整返回

2 个参数。
全部必填。

用 POST 发一个 JSON 请求体。Key 放在 Authorization 请求头里，不要放进网址。

名称	类型	是否必填	默认值	说明
platform	string	必填	—	这一页固定填 "telegram"。
username	string	必填	—	频道的账号名，不带 @

这些值从哪里拿。

username

频道的账号名，不带 @（例如 telegram）

平台上没有别的接口返回它，按上面的说明从网页或链接里取。

items 里每一条的字段。
Telegram 给不了的标出来了。

字段	类型	含义
items[].id	string始终 null	平台自己的编号。
items[].username	string	账号名。
items[].name	string	显示名。
items[].url	string	主页链接。
items[].bio	string	简介。
items[].verified	boolean	是否认证。
items[].followers	integer	粉丝数。
items[].following	integer始终 null	关注数。
items[].posts_count	integer始终 null	发布的内容数。