SocialToAI免费开始控制台
POST/v1/call/douyin.keyword_history预览

抖音巨量算数关键词热度趋势接口

抖音独有的接口。

抖音巨量算数关键词热度趋势 API（数据接口）按一个关键词，加起止日期，取每个词在抖音上逐日的搜索指数和综合指数（巨量算数，也就是抖音指数），带本期、上期和去年同期的日均值。指数是平台算出的热度分，不是搜索次数；日期是中国时间（UTC+8）的自然日。每次调用 4 积分（约 $0.008–$0.013），失败不扣。最近实测：2026-10-17。

免费开始登录后运行
注册送 100 积分，不用绑卡
4 积分每次调用
最多 5 条只返回第一页
2026-10-17最近实测
1.8 KB示例返回的体积（1 条）

最近更新：

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

请求与返回

curl https://api.socialtoai.com/v1/call/douyin.keyword_history \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -H "Content-Type: application/json" \  -d '{    "since": "2026-09-01T00:00:00Z",    "until": "2026-09-30T00:00:00Z",    "keyword": "咖啡"  }'
import osimport requestsresponse = requests.post(    "https://api.socialtoai.com/v1/call/douyin.keyword_history",    headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"},    json={        "since": "2026-09-01T00:00:00Z",        "until": "2026-09-30T00:00:00Z",        "keyword": "咖啡",    },)print(response.json())
# 已经通过 MCP 接好了？直接用大白话问。用“抖音巨量算数关键词热度趋势”接口（douyin.keyword_history），参数是 since: 2026-09-01T00:00:00Z，until: 2026-09-30T00:00:00Z，keyword: 咖啡。# 你的 AI 会调用 call 工具，参数是：{  "since": "2026-09-01T00:00:00Z",  "until": "2026-09-30T00:00:00Z",  "keyword": "咖啡"}
登录后运行4 积分登录后带着这些参数进入 Playground，不会自动运行。
200 OK1.8 KB4 积分
{  "op": "douyin.keyword_history",  "platform": "douyin",  "status": "ok",  "items": [    {      "platform": "douyin",      "id": "咖啡",      "ref": "咖啡",      "approx": [],      "type": "entry",      "entry_type": "keyword_history",      "title": "咖啡",      "url": null,      "rank": null,      "heat": null,      "fields": {        "points": [          {            "date": "2026-09-01T00:00:00Z",            "search_index": 4542097,            "composite_index": 1627826,            "notes": null,            "impressions": null,            "views": null,            "engagements": null          },          {            "date": "2026-09-02T00:00:00Z",            "search_index": 4430237,            "composite_index": 1603543,            "notes": null,            "impressions": null,            "views": null,            "engagements": null          },          {            "date": "2026-09-03T00:00:00Z",            "search_index": 4439049,            "composite_index": 1606224,            "notes": null,            "impressions": null,            "views": null,            "engagements": null          },          {            "date": "2026-09-04T00:00:00Z",            "search_index": 4590172,            "composite_index": 1648872,            "notes": null,            "impressions": null,            "views": null,            "engagements": null          },          {            "date": "2026-09-05T00:00:00Z",            "search_index": 5608382,            "composite_index": 1966637,            "notes": null,            "impressions": null,            "views": null,            "engagements": null          },          {            "date": "2026-09-06T00:00:00Z",            "search_index": 5341970,            "composite_index": 1888380,            "notes": null,            "impressions": null,            "views": null,            "engagements": null          },          {            "date": "2026-09-07T00:00:00Z",            "search_index": 5098808,            "composite_index": 1808789,            "notes": null,            "impressions": null,            "views": null,            "engagements": null          }        ]      }    }  ],  "unavailable": ["fields.points.notes", "fields.points.impressions", "fields.points.views", "fields.points.engagements"],  "page": {    "has_more": false  },  "cost_credits": 4}
entry_type
keyword_history

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

示例数据录制的 2 条里的 1 条

3 个参数。
全部必填。

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

名称类型是否必填默认值说明
keywordstring必填—一个关键词，不超过 50 个字符、不含逗号，不分大小写
sincedatetime必填—从哪一天起（含）：取这个时刻所在的中国时间（UTC+8）自然日，写 2026-09-01 就是 9 月 1 日
untildatetime必填—到哪一天止（含），取法同上。平台的数通常晚一到两天出：还没出数的日子，指数为 null
只返回第一页：最多 5 条，没有 cursor 参数，也不能往后翻。

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

字段类型含义
items[].titlestring条目的标题或名称。
items[].urlstring能打开它的链接；平台的列表不带链接时为 null。
items[].rankinteger榜上的名次，从 1 起。
items[].heatinteger平台给的热度值。
items[].fields.pointsarray逐日数据，每天一项，按日期从早到晚：date、search_index、composite_index、notes、impressions、views、engagements。其中 notes、impressions、views、engagements 在这里始终是 null
null抖音给不了的字段

null 的意思是“抖音没给这个值”，不要当成 0。这些字段在这个调用里始终是 null：

  • fields.points.notes逐日数据，每天一项，按日期从早到晚：date、search_index、composite_index、notes、impressions、views、engagements。
  • fields.points.impressions逐日数据，每天一项，按日期从早到晚：date、search_index、composite_index、notes、impressions、views、engagements。
  • fields.points.views逐日数据，每天一项，按日期从早到晚：date、search_index、composite_index、notes、impressions、views、engagements。
  • fields.points.engagements逐日数据，每天一项，按日期从早到晚：date、search_index、composite_index、notes、impressions、views、engagements。

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

会发生什么。

一次调用只返回第一页，最多 5 条，没有 cursor，4 积分。
正常执行但没有结果，算一次成功的调用：status 为 "empty"，items 为空，扣 4 积分。
抖音的这个接口分不清“视频不存在”和“没有数据”：两种情况都返回 empty，并照常扣费。

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

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

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

  1. 按一个关键词，加起止日期，取每个词在抖音上逐日的搜索指数和综合指数（巨量算数，也就是抖音指数），带本期、上期和去年同期的日均值（since：2026-09-01T00:00:00Z，until：2026-09-30T00:00:00Z，keyword：咖啡）
    call {"op":"douyin.keyword_history","since":"2026-09-01T00:00:00Z","until":"2026-09-30T00:00:00Z","keyword":"咖啡"}
    4 积分

常见问题。
简短回答。

抖音的全部接口
需要抖音账号，或者申请抖音官方的 API 吗？
不需要，只要一把 SocialToAI 的 Key。返回的是抖音上公开可见的内容和账号信息，你不用登录抖音，也不用在那边申请任何东西。
能翻到下一页吗？
不能。抖音的这个接口只给第一页（最多 5 条），返回里没有 cursor，page.has_more 始终是 false。
“预览”是什么意思？
预览：这个接口还没有标为稳定，参数和返回字段之后可能调整。计费和其他调用一样，调用失败不扣积分。

你的 AI 离全网社交媒体
只差一个地址。

免费开始文档

注册送 100 积分，不用绑卡