抖音巨量算数关键词热度趋势 API
按一个关键词或一次 1 到 5 个关键词,加起止日期,取每个词在抖音上逐日的搜索指数和综合指数(巨量算数,也就是抖音指数),带本期、上期和去年同期的日均值。指数是平台算出的热度分,不是搜索次数;日期是中国时间(UTC+8)的自然日。每次约 1 条,最多 5 条;$0.0060 一次。出错和超时不收费;空结果收 $0.0060。
试一次
改一个值,右边的请求跟着变。登录后运行,用你自己的余额。 这个接口新用户可免费试用 16 次。
以前用的是 POST /v1/douyin/index/keyword-interpretation / POST /v1/douyin/index/keyword-trends?已经换成这个地址。 旧接口改了什么
search_indexcomposite_index9/1 – 9/7search_index4,864,388search_index5,608,382search_index4,430,237看数据表
curl "https://api.dataxapi.com/v1/douyin/index/keywords/history" \ -H "Authorization: Bearer $DATAXAPI_API_KEY" \ -H "Content-Type: application/json" \ -d '{"since":"2026-09-01T00:00:00Z","until":"2026-09-30T00:00:00Z","keywords":["咖啡","CityWalk"]}'
{
"code": "ok",
"request_id": "53564b2f-0976-4ff1-bacd-8f35e1e89865",
"data": {
"items": [
{
"keyword": "咖啡",
"points": [
{
"date": "2026-09-01T00:00:00Z",
"search_index": 4542097,
"composite_index": 1627826
},
{
"date": "2026-09-02T00:00:00Z",
"search_index": 4430237,
"composite_index": 1603543
},
{
"date": "2026-09-03T00:00:00Z",
"search_index": 4439049,
"composite_index": 1606224
},
{
"date": "2026-09-04T00:00:00Z",
"search_index": 4590172,
"composite_index": 1648872
},
{
"date": "2026-09-05T00:00:00Z",
"search_index": 5608382,
"composite_index": 1966637
},
{
"date": "2026-09-06T00:00:00Z",
"search_index": 5341970,
"composite_index": 1888380
},
{
"date": "2026-09-07T00:00:00Z",
"search_index": 5098808,
"composite_index": 1808789
},
// … 另有 23 条
]
},
// … 另有 1 条
]
},
"page": {
"next_cursor": null,
"cursor_expires_at": null,
"has_more": false,
"returned": 2
},
"warnings": [],
"meta": {
"capability": "douyin.index.keywords.history",
"result_status": "complete",
"fetched_at": "2026-10-12T21:47:47.000Z",
"cached": false,
"replayed": false,
"unavailable": {
"points.notes": "platform",
"points.impressions": "platform",
"points.views": "platform",
"points.engagements": "platform"
},
"billing": {
"amount": "0.006",
"currency": "USD",
"balance_after": "9.994"
}
}
}取自 2026-10-12 21:47 UTC 录下的真实返回。名字、正文和编号是示例,链接也是,都不是录到的原文(页面不展示任何人的个人信息);数字是原样。长列表做了截断。请求号、游标和余额是示意。
返回大小:标准档 5.2 KB(精简 5.2 KB,完整 5.6 KB)。
{
"code": "ok",
"request_id": "2f84dceb-a3e5-448e-906d-070c3e66e29d",
"data": { "items": [] },
"page": {
"next_cursor": null,
"cursor_expires_at": null,
"has_more": false,
"returned": 0
},
"warnings": [],
"meta": {
"capability": "douyin.index.keywords.history",
"result_status": "empty",
"fetched_at": "2026-10-12T21:47:49.000Z",
"cached": false,
"replayed": false,
"unavailable": {
"points.notes": "platform",
"points.impressions": "platform",
"points.views": "platform",
"points.engagements": "platform"
},
"billing": {
"amount": "0.006",
"currency": "USD",
"balance_after": "9.994"
}
}
}取自 2026-10-12 21:47 UTC 录下的真实返回。请求号和余额是示意。
返回大小:标准档 527 B(精简 527 B,完整 527 B)。
curl "https://api.dataxapi.com/v1/douyin/index/keywords/history" \ -H "Authorization: Bearer $DATAXAPI_API_KEY" \ -H "Content-Type: application/json" \ -d '{"since":"2026-09-01T00:00:00Z","until":"2026-09-30T00:00:00Z","keywords":["咖啡","CityWalk"]}'
from dataxapi import DataXAPI dx = DataXAPI() # reads DATAXAPI_API_KEY result = dx.douyin.index.keywords.history(since="2026-09-01T00:00:00Z", until="2026-09-30T00:00:00Z", keywords=["咖啡", "CityWalk"]) print(result["data"]["items"])
import { DataXAPI } from "@dataxapi/sdk";
const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.douyin.index.keywords.history({ since: "2026-09-01T00:00:00Z", until: "2026-09-30T00:00:00Z", keywords: ["咖啡", "CityWalk"] });
console.log(result.data.items);dataxapi call douyin.index.keywords.history since=2026-09-01T00:00:00Z until=2026-09-30T00:00:00Z 'keywords=咖啡,CityWalk'{
"mcpServers": {
"dataxapi": {
"type": "http",
"url": "https://api.dataxapi.com/mcp",
"headers": {
"Authorization": "Bearer ${DATAXAPI_API_KEY}"
}
}
}
}把这段加进你的 MCP 客户端,然后让你的 AI 调用 douyin.index.keywords.history。
参数
keywords、keyword 里给且只给一个一个关键词,不超过 50 个字符、不含逗号,不分大小写。示例:咖啡。
keywords、keyword 里给且只给一个1 到 5 个关键词,每个不超过 50 个字符、不含逗号,不分大小写;每个有数的词返回一条,平台没收录的词不在返回里。示例:["咖啡","CityWalk"]。
从哪一天起(含):取这个时刻所在的中国时间(UTC+8)自然日,写 2026-09-01 就是 9 月 1 日。示例:2026-09-01T00:00:00Z。
到哪一天止(含),取法同上。平台的数通常晚一到两天出:还没出数的日子,指数为 null。示例:2026-09-30T00:00:00Z。
返回档位。三档价格相同。取值:compact、standard(默认)、full。
只要这些字段。按路径写,例如 author.name。
带 keywords 的请求用 POST,参数放在 JSON 请求体里;其余请求用 GET。
已知限制
- 每页约 1 条,最多 5 条。每页条数由平台决定,不收
limit。 - 一次给全,不发游标。
- 这个对象有 4 个字段这个接口给不了
返回字段
data.items 是关键词指数历史对象的列表。预览:结构可能调整,改之前会公告。
关键词
在这个平台上:平台的写法:英文一律小写
逐日的数,一天一项,从早到晚
日期:中国时间(UTC+8)的一个自然日,写成这个日期的 UTC 零点(北京时间当天 8 点);原样传给 since、until 取的就是这一天
这一天的搜索指数:平台按搜索热度算出的指数,不是搜索次数
这一天的综合指数:平台把这个词相关内容的热度合起来算出的指数,不是次数
这一天和这个词有关的内容数
展开全部 18 个字段 →
这些内容这一天的曝光数
这些内容这一天的阅读数
这些内容这一天的互动数
所查时间段内综合指数的日均值
所查时间段内搜索指数的日均值
上一个同样长的时间段的综合指数日均值
上一个同样长的时间段的搜索指数日均值
去年同期的综合指数日均值
去年同期的搜索指数日均值
这一条里哪些数是约数或下限;都是准确值时不出现
字段的路径,如 metrics.views
约数,还是下限approximatelower_bound
每条数据的典型体积:compact 2.3 KB、standard 2.3 KB、full 2.5 KB(按 2026-10-12 21:47 UTC 录下的那次返回量的)。
这个接口给不了的
points[].notes平台没有points[].impressions平台没有points[].views平台没有points[].engagements平台没有什么时候收费
X-Max-Price 可以设自己的上限,超过就不执行)价格读取于 2026-10-21 10:10 UTC,按价目版本 2,2026-10-17 11:00 UTC 起生效;在 Playground 里运行前会再读一次当前价格。
对象不存在时
平台没收录的关键词不在返回里;要的词一个都没有数时返回空结果,不报“不存在”。只查平台还没出数的日子也是空结果。
常见报错
这个接口会返回的错误码;所有接口共有的见完整列表。
invalid_params参数不合法能否重试:改了再试未扣费insufficient_balance余额不足能否重试:改了再试未扣费upstream_failed数据来源出错能否重试:能未扣费timeout没有在时限内取到数据,可以用同一个幂等键重试能否重试:能未扣费常见问题
抖音巨量算数关键词热度趋势 API 多少钱?
$0.0060 一次。单次最高扣费 $0.0060。
什么情况下不收费?
出错和超时不收费;空结果收 $0.0060。
一次返回多少条?怎么翻页?
每页约 1 条,最多 5 条。每页条数由平台决定,不收 limit。一次给全,不发游标。
对象不存在会怎样?
平台没收录的关键词不在返回里;要的词一个都没有数时返回空结果,不报“不存在”。只查平台还没出数的日子也是空结果。
数据从哪来?
来自抖音官方的指数工具巨量算数(也叫抖音指数):就是它给这个词的搜索指数和综合指数,按天给。不用抖音账号,也不用广告主账号。
多久更新一次?
每天一个数,按中国时间(UTC+8)的自然日算。平台的数通常晚一到两天出:还没出数的日子,指数是 null。
能查多长时间范围?
since 到 until 之间的任意整天,两头都算;时间段长短不影响价格。示例查的是 2026 年 9 月整月。每个词还附带本期、上期和去年同期的日均值。
一次能查几个词?
用 keyword 查一个,用 keywords 一次查 1 到 5 个(POST)。按次收费,一次 $0.0060,查 5 个词和查 1 个词同价。巨量算数没收录的词不在返回里。
怎么在 AI 里用?
先接入 DataXAPI(在“给 AI 代理”页复制一段带 Key 的提示词,贴给你的 AI),然后直接用中文问:“用 DataXAPI 查‘咖啡’2026 年 9 月在抖音巨量算数上的搜索指数。”它会调用 douyin.index.keywords.history,每次扣 $0.0060。
抖音的全部 34 个接口
在你的 AI 里用它
复制这段提示词
你的 API Key 已经写在里面,不用再配置什么。
还没有账户?注册只要一个邮箱,不用绑卡,失败的调用不收费。
贴给你的 agent
它会去读提示词指向的那一页,自己接好。
现在问点什么
用下面任意一句,或者用自己的话问。
想自己手动配置?
dataxapi setup给这台电脑上的 AI 代理(Claude Code、Codex、Cursor)装好 DataXAPI 的 MCP 服务和基础技能。Key 从环境变量 DATAXAPI_API_KEY 读,不写进任何文件。MCP 服务地址:https://api.dataxapi.com/mcp。你的客户端要填的配置在本页请求示例的“MCP”页签里;接好后让你的 AI 调用 douyin.index.keywords.history。其他客户端 →展开全文
使用 DataXAPI 的接口 douyin.index.keywords.history(抖音巨量算数关键词热度趋势)。按一个关键词或一次 1 到 5 个关键词,加起止日期,取每个词在抖音上逐日的搜索指数和综合指数(巨量算数,也就是抖音指数),带本期、上期和去年同期的日均值。指数是平台算出的热度分,不是搜索次数;日期是中国时间(UTC+8)的自然日。
用 POST 请求 https://api.dataxapi.com/v1/douyin/index/keywords/history,带请求头 "Authorization: Bearer $DATAXAPI_API_KEY"。Key 从环境变量 DATAXAPI_API_KEY 读,不要写进代码。
参数:
- keyword:一个关键词,不超过 50 个字符、不含逗号,不分大小写。示例:咖啡。
- keywords:1 到 5 个关键词,每个不超过 50 个字符、不含逗号,不分大小写;每个有数的词返回一条,平台没收录的词不在返回里。示例:["咖啡","CityWalk"]。
- since (必填):从哪一天起(含):取这个时刻所在的中国时间(UTC+8)自然日,写 2026-09-01 就是 9 月 1 日。示例:2026-09-01T00:00:00Z。
- until (必填):到哪一天止(含),取法同上。平台的数通常晚一到两天出:还没出数的日子,指数为 null。示例:2026-09-30T00:00:00Z。
- view:返回档位。三档价格相同。取值:compact、standard(默认)、full。
- fields:只要这些字段。按路径写,例如 author.name。
价格:$0.0060 一次。出错和超时不收费;空结果收 $0.0060。
返回 JSON:data.items 是关键词指数历史;meta.billing.amount 是这次调用的扣费。
示例:
curl "https://api.dataxapi.com/v1/douyin/index/keywords/history" \
-H "Authorization: Bearer $DATAXAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"since":"2026-09-01T00:00:00Z","until":"2026-09-30T00:00:00Z","keywords":["咖啡","CityWalk"]}'
完整说明(Markdown):https://dataxapi.com/zh/apis/douyin/index/keywords/history.md名称和编号
- 英文名
- Douyin trend-index keyword trends API
- 接口编号
douyin.index.keywords.history- 地址
GET / POST /v1/douyin/index/keywords/history
一把 Key,开始用。
21 个平台 207 个接口,一次 $0.0003 起。出错和超时不收费。