POST/v1/user_profile"platform": "tiktok"

TikTok 账号资料接口

一个账号。

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

免费开始登录后运行

注册送 100 积分，不用绑卡

2 积分每次调用

一个对象每次调用返回

2026-10-17最近实测

701 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": "tiktok",    "id": "6767146744805213190"  }'

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

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

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

200 OK701 B2 积分

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

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

605,660 粉丝92 关注364 作品

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

示例数据完整返回

3 个参数。
1 个必填。

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

名称	类型	是否必填	默认值	说明
platform	string	必填	—	这一页固定填 "tiktok"。
id	string	几个里给一个	—	TikTok 用户编号，一串数字
username	string	几个里给一个	—	TikTok 账号名，不带 @

这些值从哪里拿。

id

TikTok 用户编号，一串数字（例如 6767146744805213190）

这些接口返回的每一条都带 ref，原样填进来即可：

search · type=user搜索
followers用户粉丝列表

username

TikTok 账号名，不带 @（例如 nasa）

这些接口返回的每一条都带 username，原样填进来即可：

search · type=user搜索
followers用户粉丝列表

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

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

nullTikTok 给不了的字段

这个调用的字段 TikTok 都给得出；单条内容缺某个值时，那个字段是 null。

每一条另有 platform、id、ref、approx、type；items 外面的部分每个调用都一样。返回格式

会发生什么。

一次调用返回一个对象，不翻页，2 积分。

每把 Key 每秒 1 次，购买后 5 次；超出不扣费。频率限制

失败的调用 0 积分，不会自动重试。错误码

接好 MCP 后，这样问就会用到它。

查一下这个 TikTok 账号：6767146744805213190
user_profile {"platform":"tiktok","id":"6767146744805213190"}
2 积分
在 TikTok 上找和“nike”有关的账号，再对前 3 个结果：查一下这个 TikTok 账号。
search {"platform":"tiktok","query":"nike","type":"user"}user_profile {"platform":"tiktok","id":"<ref>"} × 3
8 积分