/v1/call/douyin.kol_scores抖音星图达人星图指数接口
抖音独有的接口。
按星图达人编号取星图给这位抖音达人打的六项指数:星图指数(综合)和传播、种草、转化、合作、性价比五个分项,每项带得分、同类达人的平均分、名次和名次排在前多大比例。抖音星图达人星图指数 API(数据接口)每次调用 5 积分(约 $0.01–$0.017),失败不扣。用 HTTP 调用,或让 AI 客户端通过 MCP 调用。
最近更新:
调用抖音星图达人星图指数,你会拿到什么。
取自一次录制的返回。
录制的一次调用返回了下面这个对象。名称和正文在示例里去掉了,数字是录制时的真实值。
| 字段 | 录制时的值 |
|---|---|
| title | null |
| url | null |
| rank | null |
| heat | null |
| fields.overall.score | 90.9 |
| fields.overall.average | 56.2 |
| fields.overall.rank | 12 |
| fields.overall.rank_share | 0 |
| fields.reach.score | 98.77 |
| fields.reach.average | 53.08 |
| fields.reach.rank | 232 |
| fields.reach.rank_share | 0 |
| fields.seeding.score | 98.68 |
| fields.seeding.average | 53.26 |
| fields.seeding.rank | 280 |
| fields.seeding.rank_share | 0 |
| fields.conversion.score | 98.92 |
| fields.conversion.average | 55.24 |
| fields.conversion.rank | 164 |
| fields.conversion.rank_share | 0 |
每次 5 积分(≈ $0.01–$0.017),$10 约够 600 次。
抖音星图达人星图指数的请求与返回
curl https://socialtoai.app/v1/call/douyin.kol_scores \ -H "Authorization: Bearer $SOCIALTOAI_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{ "id": "6763236383382306828" }'import osimport uuidimport requestsresponse = requests.post( "https://socialtoai.app/v1/call/douyin.kol_scores", headers={ "Authorization": f"Bearer {os.environ['SOCIALTOAI_API_KEY']}", # A new key for each request; the same one again retries it without paying twice. "Idempotency-Key": str(uuid.uuid4()), }, json={ "id": "6763236383382306828", },)print(response.json())# 已经通过 MCP 接好了?直接用大白话问。用“抖音星图达人星图指数”接口(douyin.kol_scores),参数是 id: 6763236383382306828。# 你的 AI 会调用 call 工具,参数是:{ "id": "6763236383382306828"}{ "op": "douyin.kol_scores", "platform": "douyin", "status": "ok", "items": [ { "platform": "douyin", "id": "…", "ref": "…", "approx": [], "extra": {}, "type": "entry", "entry_type": "xingtu_creator_scores", "title": null, "url": null, "rank": null, "heat": null, "fields": { "overall": { "score": 90.9, "average": 56.2, "rank": 12, "rank_share": 0 }, "reach": { "score": 98.77, "average": 53.08, "rank": 232, "rank_share": 0.0001 }, "seeding": { "score": 98.68, "average": 53.26, "rank": 280, "rank_share": 0.0001 }, "conversion": { "score": 98.92, "average": 55.24, "rank": 164, "rank_share": 0.0001 }, "cooperation": { "score": 89.49, "average": 75.55, "rank": 1038, "rank_share": 0.0005 }, "value_for_money": { "score": 68.64, "average": 64.09, "rank": 50209, "rank_share": 0.023 } } } ], "unavailable": [], "cost_credits": 5}- entry_type
- xingtu_creator_scores
示例里的名称和正文已去掉,数字是录制时的真实值。
抖音星图达人星图指数的参数。
1 个,全部必填。
用 POST 发一个 JSON 请求体。Key 放在 Authorization 请求头里,不要放进网址。
| 名称 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| id | string | 必填 | — | 星图达人编号,一串数字;不是抖音账号编号,从星图达人搜索的结果里取 |
这些值从哪里拿。
id星图达人编号,一串数字;不是抖音账号编号,从星图达人搜索的结果里取(例如 6763236383382306828)
这些接口返回的每一条都带 ref,原样填进来即可:
kol_search抖音星图达人搜索接口
抖音星图达人星图指数返回的字段。
抖音给不了的标出来了。
| 字段 | 类型 | 含义 |
|---|---|---|
| items[].extra | object | 平台在下面这些字段之外给的内容,用平台自己的字段名(IP 属地、uid、有没有橱窗等),每个是什么见接口的 extra_fields;没有就是空对象。评论和评价里不会有写的人是谁。 |
| items[].title | string | 条目的标题或名称。 |
| items[].url | string | 能打开它的链接;平台的列表不带链接时为 null。 |
| items[].rank | integer | 榜上的名次,从 1 起。 |
| items[].heat | integer | 平台给的热度值。 |
| items[].fields.overall.score | number | 星图指数(综合)得分,0 到 100。 |
| items[].fields.overall.average | number | 同类达人星图指数(综合)的平均分。 |
| items[].fields.overall.rank | integer | 星图指数(综合)的名次,1 为最高。 |
| items[].fields.overall.rank_share | number | 这个名次处在前百分之多少,0 到 1:0.05 表示前 5%。 |
| items[].fields.reach.score | number | 传播指数得分,0 到 100。 |
| items[].fields.reach.average | number | 同类达人传播指数的平均分。 |
| items[].fields.reach.rank | integer | 传播指数的名次,1 为最高。 |
| items[].fields.reach.rank_share | number | 这个名次处在前百分之多少,0 到 1:0.05 表示前 5%。 |
| items[].fields.seeding.score | number | 种草指数得分,0 到 100。 |
| items[].fields.seeding.average | number | 同类达人种草指数的平均分。 |
| items[].fields.seeding.rank | integer | 种草指数的名次,1 为最高。 |
| items[].fields.seeding.rank_share | number | 这个名次处在前百分之多少,0 到 1:0.05 表示前 5%。 |
| items[].fields.conversion.score | number | 转化指数得分,0 到 100。 |
| items[].fields.conversion.average | number | 同类达人转化指数的平均分。 |
| items[].fields.conversion.rank | integer | 转化指数的名次,1 为最高。 |
| items[].fields.conversion.rank_share | number | 这个名次处在前百分之多少,0 到 1:0.05 表示前 5%。 |
| items[].fields.cooperation.score | number | 合作指数得分,0 到 100。 |
| items[].fields.cooperation.average | number | 同类达人合作指数的平均分。 |
| items[].fields.cooperation.rank | integer | 合作指数的名次,1 为最高。 |
| items[].fields.cooperation.rank_share | number | 这个名次处在前百分之多少,0 到 1:0.05 表示前 5%。 |
| items[].fields.value_for_money.score | number | 性价比指数得分,0 到 100。 |
| items[].fields.value_for_money.average | number | 同类达人性价比指数的平均分。 |
| items[].fields.value_for_money.rank | integer | 性价比指数的名次,1 为最高。 |
| items[].fields.value_for_money.rank_share | number | 这个名次处在前百分之多少,0 到 1:0.05 表示前 5%。 |
null抖音给不了的字段这个调用的字段抖音都给得出;单条内容缺某个值时,那个字段是 null。
每一条另有 platform、id、ref、approx、type;items 外面的部分每个调用都一样。 返回格式
抖音星图达人星图指数的翻页与计费。
每把 Key 每秒 5 次,购买后 20 次;超出不扣费。 频率限制
失败的调用 0 积分,不会自动重试。 错误码
接口上次实测:2026-10-17。每次调用从平台读取,返回里的 fetched_at 是读取时间;同一把 Key 5 分钟内重发完全相同的请求算重放(replayed: true),0 积分,返回第一次读到的结果。
接好 MCP 后,这样问就会用到抖音星图达人星图指数。
按星图达人编号取星图给这位抖音达人打的六项指数:6763236383382306828
5 积分call {"op":"douyin.kol_scores","id":"6763236383382306828"}按昵称里的词搜索星图上的抖音达人,可按粉丝数、预期 CPM(元)、性别筛选,按预期 CPM 从低到高排:美食,再对前 3 个结果:按星图达人编号取星图给这位抖音达人打的六项指数。
18 积分call {"op":"douyin.kol_search","query":"美食"}call {"op":"douyin.kol_scores","id":"<ref>"} × 3
交给你的 AI。
复制给 Claude 或 ChatGPT。
怎么接用 SocialToAI 的 MCP 服务(https://socialtoai.app/mcp)完成这件事:按星图达人编号取星图给这位抖音达人打的六项指数:6763236383382306828调用 call 工具,参数是 {"op":"douyin.kol_scores","id":"6763236383382306828"}。必填:id。要查多个就一个一个调用,每个 5 积分。开跑前先算出总共要多少积分,问我同意了再调用。拿到结果后,可以接着调:call douyin.kol_videos(星图达人作品表现),用返回的 ref 或 username。如果还没接上 SocialToAI,告诉我怎么接,不要让我把 Key 贴进对话。回答时附上你用到的每一条的链接,最后告诉我花了多少积分。接好 MCP 后把这段话贴进对话。里面没有 Key:在 Claude 和 ChatGPT 里登录授权,其他客户端把 Key 放在请求头里。
用到它的工作场景。
接着看。
官方能做什么、谁能申请、多少钱,带来源。
找达人、看资料、看粉丝画像,各平台能拿到什么。
让 Claude 读抖音视频下的评论
让 Claude Code、Cursor 读小红书和抖音:不扫码、不用 Cookie,以及本地自建要付出什么
海外品牌用 AI 监测小红书、抖音和微博:英文输出、带原帖链接
蒲公英和星图的接口:两边的搜索怎么匹配、要什么编号、一份名单多少钱
让你的 AI 直接读抖音。