POST
/v1/call/douyin.kol_videos预览抖音星图达人作品表现接口
抖音独有的接口。
抖音星图达人作品表现 API（数据接口）按星图达人编号取一页这位抖音达人的视频，从新到旧，带星图给的表现数据：播放数、点赞数、完播率、互动率、时长。每次调用 3 积分（约 $0.006–$0.01），失败不扣。用 HTTP 调用，或让 AI 客户端通过 MCP 调用。最近实测：2026-10-17。
3 积分每次调用
每页最多 20 条一次调用返回一页
2026-10-17最近实测
936 B示例返回的体积（1 条）
最近更新：
预览：这个接口还没有标为稳定，参数和返回字段之后可能调整。计费和其他调用一样，调用失败不扣积分。
请求与返回
curl https://api.socialtoai.com/v1/call/douyin.kol_videos \ -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_videos", headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"}, json={ "id": "6763236383382306828", },)print(response.json())# 已经通过 MCP 接好了？直接用大白话问。用“抖音星图达人作品表现”接口（douyin.kol_videos），参数是 id: 6763236383382306828。# 你的 AI 会调用 call 工具，参数是：{ "id": "6763236383382306828"}200 OK936 B3 积分
{ "op": "douyin.kol_videos", "platform": "douyin", "status": "ok", "items": [ { "platform": "douyin", "id": "…", "ref": "…", "approx": [], "type": "entry", "entry_type": "xingtu_creator_post", "title": "…", "url": "https://example.com/…", "rank": null, "heat": null, "fields": { "published_at": "2026-10-09T09:00:01.000Z", "duration": 222.207, "views": 96840, "likes": 1370, "comments": 91, "completion_rate": 0.020132, "engagement_rate": 0.02032 } } ], "unavailable": [], "page": { "has_more": true, "cursor": "cur_…", "cursor_expires_at": "2026-10-12T22:38:13.000Z" }, "cost_credits": 3}- entry_type
- xingtu_creator_post
- published_at
- 2026-10-09T09:00:01.000Z
- duration
- 222.207
- views
- 96840
- likes
- 1370
- comments
- 91
- completion_rate
- 0.020132
示例里的名称和正文已去掉，数字是录制时的真实值。
示例数据录制的 20 条里的 1 条
2 个参数。
1 个必填。
用 POST 发一个 JSON 请求体。Key 放在 Authorization 请求头里，不要放进网址。
| 名称 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| id | string | 必填 | — | 星图达人编号，一串数字；不是抖音账号编号，从星图达人搜索的结果里取 |
| cursor | string | 选填 | — | 填上一次返回的 page.cursor，取下一页。 |
这些值从哪里拿。
id星图达人编号，一串数字；不是抖音账号编号，从星图达人搜索的结果里取（例如 6763236383382306828）
这些接口返回的每一条都带 ref，原样填进来即可：
kol_search星图达人搜索
items 里每一条的字段。
抖音给不了的标出来了。
| 字段 | 类型 | 含义 |
|---|---|---|
| items[].title | string | 条目的标题或名称。 |
| items[].url | string | 能打开它的链接；平台的列表不带链接时为 null。 |
| items[].rank | integer | 榜上的名次，从 1 起。 |
| items[].heat | integer | 平台给的热度值。 |
| items[].fields.published_at | string | 发布时间。 |
| items[].fields.duration | number | 视频时长，秒。 |
| items[].fields.views | integer | 播放数。 |
| items[].fields.likes | integer | 点赞数。 |
| items[].fields.comments | integer | 评论数。 |
| items[].fields.completion_rate | number | 完播率，0 到 1。 |
| items[].fields.engagement_rate | number | 互动率，0 到 1。 |
null抖音给不了的字段这个调用的字段抖音都给得出；单条内容缺某个值时，那个字段是 null。
每一条另有 platform、id、ref、approx、type；items 外面的部分每个调用都一样。 返回格式
会发生什么。
一次调用返回一页，最多 20 条；page.has_more 为 true 时把 page.cursor 填进 cursor 取下一页，每页 3 积分，cursor 30 分钟内有效。
正常执行但没有结果，算一次成功的调用：status 为 "empty"，items 为空，扣 3 积分。
抖音的这个接口分不清“视频不存在”和“没有数据”：两种情况都返回 empty，并照常扣费。
每把 Key 每秒 1 次，购买后 5 次；超出不扣费。 频率限制
失败的调用 0 积分，不会自动重试。 错误码
接好 MCP 后，这样问就会用到它。
按星图达人编号取一页这位抖音达人的视频，从新到旧，带星图给的表现数据：6763236383382306828
3 积分call {"op":"douyin.kol_videos","id":"6763236383382306828"}按昵称里的词搜索星图上的抖音达人：美食，再对前 3 个结果：按星图达人编号取一页这位抖音达人的视频，从新到旧，带星图给的表现数据。
12 积分call {"op":"douyin.kol_search","query":"美食"}call {"op":"douyin.kol_videos","id":"<ref>"} × 3
常见问题。
简短回答。
抖音的全部接口需要抖音账号，或者申请抖音官方的 API 吗？
不需要，只要一把 SocialToAI 的 Key。返回的是抖音上公开可见的内容和账号信息，你不用登录抖音，也不用在那边申请任何东西。
“预览”是什么意思？
预览：这个接口还没有标为稳定，参数和返回字段之后可能调整。计费和其他调用一样，调用失败不扣积分。