POST
/v1/call/douyin.keyword_related预览抖音巨量算数关联词接口
抖音独有的接口。
抖音巨量算数关联词 API（数据接口）按一个关键词取它在抖音上某一周的关联词（巨量算数）：搜索里一起出现的词和内容里一起出现的词，各带相关度、相关度名次、搜索指数和综合指数。指数是平台算出的热度分，不是搜索次数。每次调用 2 积分（约 $0.004–$0.0067），失败不扣。用 HTTP 调用，或让 AI 客户端通过 MCP 调用。最近实测：2026-10-17。
2 积分每次调用
最多 250 条只返回第一页
2026-10-17最近实测
854 B示例返回的体积（1 条）
最近更新：
预览：这个接口还没有标为稳定，参数和返回字段之后可能调整。计费和其他调用一样，调用失败不扣积分。
请求与返回
curl https://api.socialtoai.com/v1/call/douyin.keyword_related \ -H "Authorization: Bearer $SOCIALTOAI_KEY" \ -H "Content-Type: application/json" \ -d '{ "keyword": "露营", "until": "2026-10-04T00:00:00Z" }'import osimport requestsresponse = requests.post( "https://api.socialtoai.com/v1/call/douyin.keyword_related", headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"}, json={ "keyword": "露营", "until": "2026-10-04T00:00:00Z", },)print(response.json())# 已经通过 MCP 接好了？直接用大白话问。用“抖音巨量算数关联词”接口（douyin.keyword_related），参数是 keyword: 露营，until: 2026-10-04T00:00:00Z。# 你的 AI 会调用 call 工具，参数是：{ "keyword": "露营", "until": "2026-10-04T00:00:00Z"}200 OK854 B2 积分
{ "op": "douyin.keyword_related", "platform": "douyin", "status": "ok", "items": [ { "platform": "douyin", "id": "露营车", "ref": "露营车", "approx": [], "type": "entry", "entry_type": "keyword_related", "title": "露营车", "url": null, "rank": 2, "heat": null, "fields": { "related_to": "露营", "relation": "query", "relevance": 0.07604021617112115, "search_index": 669384, "composite_index": 190809 } } ], "unavailable": [], "page": { "has_more": false }, "cost_credits": 2}- entry_type
- keyword_related
- related_to
- 露营
- relation
- query
- relevance
- 0.07604021617112115
- search_index
- 669384
- composite_index
- 190809
示例里的名称和正文已去掉，数字是录制时的真实值。
示例数据录制的 173 条里的 1 条
2 个参数。
全部必填。
用 POST 发一个 JSON 请求体。Key 放在 Authorization 请求头里，不要放进网址。
| 名称 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| keyword | string | 必填 | — | 一个关键词，不分大小写 |
| until | datetime | 必填 | — | 要哪一周：关联词按周出（周一到周日，中国时间），取在这一天或之前结束的最近一个整周。最新一周通常在下周初出数，还没出数时返回空 |
只返回第一页：最多 250 条，没有 cursor 参数，也不能往后翻。
items 里每一条的字段。
抖音给不了的标出来了。
| 字段 | 类型 | 含义 |
|---|---|---|
| items[].title | string | 条目的标题或名称。 |
| items[].url | string | 能打开它的链接；平台的列表不带链接时为 null。 |
| items[].rank | integer | 榜上的名次，从 1 起。 |
| items[].heat | integer | 平台给的热度值。 |
| items[].fields.related_to | string | 你查的那个关键词。 |
| items[].fields.relation | string | 关联方式：query 是和你查的词一起被搜，posts 是在内容里一起出现，prior 是人们搜它之前搜的词，after 是之后搜的词。 |
| items[].fields.relevance | number | 和你查的词的相关度，0 到 1。 |
| items[].fields.search_index | integer | 这个关联词的搜索指数：平台算出的指数，不是搜索次数；平台没给这个词的数值时为 null。 |
| items[].fields.composite_index | integer | 这个关联词的综合指数：平台按相关内容的热度算出的指数，不是次数。 |
null抖音给不了的字段这个调用的字段抖音都给得出；单条内容缺某个值时，那个字段是 null。
每一条另有 platform、id、ref、approx、type；items 外面的部分每个调用都一样。 返回格式
会发生什么。
一次调用只返回第一页，最多 250 条，没有 cursor，2 积分。
正常执行但没有结果，算一次成功的调用：status 为 "empty"，items 为空，扣 2 积分。
抖音的这个接口分不清“视频不存在”和“没有数据”：两种情况都返回 empty，并照常扣费。
每把 Key 每秒 1 次，购买后 5 次；超出不扣费。 频率限制
失败的调用 0 积分，不会自动重试。 错误码
接好 MCP 后，这样问就会用到它。
按一个关键词取它在抖音上某一周的关联词（巨量算数）（keyword：露营，until：2026-10-04T00:00:00Z）
2 积分call {"op":"douyin.keyword_related","keyword":"露营","until":"2026-10-04T00:00:00Z"}
常见问题。
简短回答。
抖音的全部接口需要抖音账号，或者申请抖音官方的 API 吗？
不需要，只要一把 SocialToAI 的 Key。返回的是抖音上公开可见的内容和账号信息，你不用登录抖音，也不用在那边申请任何东西。
能翻到下一页吗？
不能。抖音的这个接口只给第一页（最多 250 条），返回里没有 cursor，page.has_more 始终是 false。
“预览”是什么意思？
预览：这个接口还没有标为稳定，参数和返回字段之后可能调整。计费和其他调用一样，调用失败不扣积分。