POST
/v1/call/douyin.kol_performance预览抖音星图达人传播数据接口
抖音独有的接口。
抖音星图达人传播数据 API（数据接口）按星图达人编号取这位抖音达人近 30 天或 90 天视频的传播数据：视频数、播放中位数、平均点赞评论分享、互动率、完播率、预期千次播放成本和单次互动成本。每次调用 3 积分（约 $0.006–$0.01），失败不扣。用 HTTP 调用，或让 AI 客户端通过 MCP 调用。最近实测：2026-10-17。
3 积分每次调用
一个对象每次调用返回
2026-10-17最近实测
1007 B示例返回的体积（1 条）
最近更新：
预览：这个接口还没有标为稳定，参数和返回字段之后可能调整。计费和其他调用一样，调用失败不扣积分。
请求与返回
curl https://api.socialtoai.com/v1/call/douyin.kol_performance \ -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_performance", headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"}, json={ "id": "6763236383382306828", },)print(response.json())# 已经通过 MCP 接好了？直接用大白话问。用“抖音星图达人传播数据”接口（douyin.kol_performance），参数是 id: 6763236383382306828。# 你的 AI 会调用 call 工具，参数是：{ "id": "6763236383382306828"}改一改请求上面的代码会跟着变。
window200 OK1007 B3 积分
{ "op": "douyin.kol_performance", "platform": "douyin", "status": "ok", "items": [ { "platform": "douyin", "id": "…", "ref": "…", "approx": [], "type": "entry", "entry_type": "xingtu_creator_metrics", "title": null, "url": null, "rank": null, "heat": null, "fields": { "videos": 763, "median_views": 237059, "average_likes": 11712, "average_comments": 993, "average_shares": 938, "engagement_rate": 0.0148, "engagement_rate_percentile": 0.512, "completion_rate": 0.2377, "completion_rate_percentile": 0.7391, "currency": "…", "cpm_21_60s": "537.29", "cpm_over_60s": "2238.73", "cpe_21_60s": "36.92", "cpe_over_60s": "153.84" } } ], "unavailable": [], "cost_credits": 3}- entry_type
- xingtu_creator_metrics
- videos
- 763
- median_views
- 237059
- average_likes
- 11712
- average_comments
- 993
- average_shares
- 938
- engagement_rate
- 0.0148
示例里的名称和正文已去掉，数字是录制时的真实值。
示例数据完整返回
2 个参数。
1 个必填。
用 POST 发一个 JSON 请求体。Key 放在 Authorization 请求头里，不要放进网址。
| 名称 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| id | string | 必填 | — | 星图达人编号，一串数字；不是抖音账号编号，从星图达人搜索的结果里取 |
| window | string | 选填 | "30d" | 统计周期：近 30 天或近 90 天"30d""90d" |
这些值从哪里拿。
id星图达人编号，一串数字；不是抖音账号编号，从星图达人搜索的结果里取（例如 6763236383382306828）
这些接口返回的每一条都带 ref，原样填进来即可：
kol_search星图达人搜索
items 里每一条的字段。
抖音给不了的标出来了。
| 字段 | 类型 | 含义 |
|---|---|---|
| items[].title | string | 条目的标题或名称。 |
| items[].url | string | 能打开它的链接；平台的列表不带链接时为 null。 |
| items[].rank | integer | 榜上的名次，从 1 起。 |
| items[].heat | integer | 平台给的热度值。 |
| items[].fields.videos | integer | 统计周期内的视频数。 |
| items[].fields.median_views | integer | 单条视频播放数的中位数。 |
| items[].fields.average_likes | integer | 单条视频的平均点赞数。 |
| items[].fields.average_comments | integer | 单条视频的平均评论数。 |
| items[].fields.average_shares | integer | 单条视频的平均分享数。 |
| items[].fields.engagement_rate | number | 互动率，0 到 1。 |
| items[].fields.engagement_rate_percentile | number | 互动率超过同类达人的比例，0 到 1。 |
| items[].fields.completion_rate | number | 完播率，0 到 1。 |
| items[].fields.completion_rate_percentile | number | 完播率超过同类达人的比例，0 到 1。 |
| items[].fields.currency | string | 下面四项成本的货币。 |
| items[].fields.cpm_21_60s | string | 21 到 60 秒视频的预期千次播放成本。 |
| items[].fields.cpm_over_60s | string | 60 秒以上视频的预期千次播放成本。 |
| items[].fields.cpe_21_60s | string | 21 到 60 秒视频的预期单次互动成本。 |
| items[].fields.cpe_over_60s | string | 60 秒以上视频的预期单次互动成本。 |
null抖音给不了的字段这个调用的字段抖音都给得出；单条内容缺某个值时，那个字段是 null。
每一条另有 platform、id、ref、approx、type；items 外面的部分每个调用都一样。 返回格式
会发生什么。
一次调用返回一个对象，不翻页，3 积分。
每把 Key 每秒 1 次，购买后 5 次；超出不扣费。 频率限制
失败的调用 0 积分，不会自动重试。 错误码
接好 MCP 后，这样问就会用到它。
按星图达人编号取这位抖音达人近 30 天或 90 天视频的传播数据：6763236383382306828
3 积分call {"op":"douyin.kol_performance","id":"6763236383382306828"}按星图达人编号取这位抖音达人近 30 天或 90 天视频的传播数据：6763236383382306828，window 取 90d。
3 积分call {"op":"douyin.kol_performance","id":"6763236383382306828","window":"90d"}按昵称里的词搜索星图上的抖音达人：美食，再对前 3 个结果：按星图达人编号取这位抖音达人近 30 天或 90 天视频的传播数据。
12 积分call {"op":"douyin.kol_search","query":"美食"}call {"op":"douyin.kol_performance","id":"<ref>"} × 3
常见问题。
简短回答。
抖音的全部接口需要抖音账号，或者申请抖音官方的 API 吗？
不需要，只要一把 SocialToAI 的 Key。返回的是抖音上公开可见的内容和账号信息，你不用登录抖音，也不用在那边申请任何东西。
“预览”是什么意思？
预览：这个接口还没有标为稳定，参数和返回字段之后可能调整。计费和其他调用一样，调用失败不扣积分。