POST/v1/call/douyin.kol_profile预览

抖音星图达人资料接口

抖音独有的接口。

抖音星图达人资料 API（数据接口）按星图达人编号取这位抖音达人在星图上的资料：昵称、所在地、内容类目、粉丝数。每次调用 3 积分（约 $0.006–$0.01），失败不扣。用 HTTP 调用，或让 AI 客户端通过 MCP 调用。最近实测：2026-10-17。

免费开始登录后运行

注册送 100 积分，不用绑卡

3 积分每次调用

一个对象每次调用返回

2026-10-17最近实测

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

最近更新：2026-10-17

预览：这个接口还没有标为稳定，参数和返回字段之后可能调整。计费和其他调用一样，调用失败不扣积分。

请求与返回

curl https://api.socialtoai.com/v1/call/douyin.kol_profile \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -H "Content-Type: application/json" \  -d '{    "id": "6763236383382306828"  }'

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

# 已经通过 MCP 接好了？直接用大白话问。用“抖音星图达人资料”接口（douyin.kol_profile），参数是 id: 6763236383382306828。# 你的 AI 会调用 call 工具，参数是：{  "id": "6763236383382306828"}

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

200 OK776 B3 积分

{  "op": "douyin.kol_profile",  "platform": "douyin",  "status": "ok",  "items": [    {      "platform": "douyin",      "id": "…",      "ref": "…",      "approx": [],      "type": "entry",      "entry_type": "creator",      "title": "…",      "url": null,      "rank": null,      "heat": null,      "fields": {        "account_id": "…",        "username": "…",        "location": null,        "categories": ["…"],        "subcategories": ["…"],        "followers": 25909243      }    }  ],  "unavailable": [],  "cost_credits": 3}

entry_type: creator
account_id: …
username: …
location: null
followers: 25909243

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

示例数据完整返回

1 个参数。
全部必填。

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

名称	类型	是否必填	默认值	说明
id	string	必填	—	星图达人编号，一串数字；不是抖音账号编号，从星图达人搜索的结果里取

这些值从哪里拿。

id

星图达人编号，一串数字；不是抖音账号编号，从星图达人搜索的结果里取（例如 6763236383382306828）

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

kol_search星图达人搜索

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

字段	类型	含义
items[].title	string	条目的标题或名称。
items[].url	string	能打开它的链接；平台的列表不带链接时为 null。
items[].rank	integer	榜上的名次，从 1 起。
items[].heat	integer	平台给的热度值。
items[].fields.account_id	string	这位达人的平台账号编号，可以传给同平台的账号类调用。
items[].fields.username	string	账号名。
items[].fields.location	string	所在地，用平台的原话。
items[].fields.categories	string[]	内容类目（一级），用平台的原话。
items[].fields.subcategories	string[]	内容类目（二级），用平台的原话。
items[].fields.followers	integer	粉丝数。

null抖音给不了的字段

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

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

会发生什么。

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

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

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

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

按星图达人编号取这位抖音达人在星图上的资料：6763236383382306828
call {"op":"douyin.kol_profile","id":"6763236383382306828"}
3 积分
按昵称里的词搜索星图上的抖音达人：美食，再对前 3 个结果：按星图达人编号取这位抖音达人在星图上的资料。
call {"op":"douyin.kol_search","query":"美食"}call {"op":"douyin.kol_profile","id":"<ref>"} × 3
12 积分