手动复制 Agent 提示
本地模拟所有展示数据均为虚构样本。真实 API、支付和外部邮件关闭。English ↗
01
这条能力做什么
抖音巨量算数关键词热度趋势以 /v1/douyin/index/keywords/history 为入口;GET 返回 data.items;POST 返回 data.items,对象为关键词历史。
当前为本地模拟模式;样本由程序生成,不代表平台实时数据,也不证明真实供应商的可用性。
- 能力标识:douyin.index.keywords.history
- 分页:此能力没有游标分页,不应无限重复调用。
02
输入合同
按所选方法查看参数含义、示例和条件规则;view 与 fields 控制返回内容,不改变 TEST 单价。
- GET:keyword 必须恰好提供一个。
- POST:keywords 必须恰好提供一个。
| 方法 | 字段 | 类型 | 要求 | 含义 | 枚举或边界 | 示例 |
|---|---|---|---|---|---|---|
| GET | keyword | string | 可选/条件 | One keyword, at most 50 characters and without a comma; letter case does not matter | — | "咖啡" |
| GET | since | string | 必填 | The first day wanted: the China-time (UTC+8) calendar day this moment falls on; 2026-09-01 means 1 September | — | "2026-09-01T00:00:00Z" |
| GET | until | string | 必填 | The last day wanted, read the same way. The platform publishes a day or two late: a day it has no figure for yet has a null index | — | "2026-09-30T00:00:00Z" |
| GET | view | string | 可选/条件 | How much of each item: compact (the most used fields, long text cut short), standard, or full (adds `ext`). | ["compact","standard","full"] | — |
| GET | fields | array | 可选/条件 | Return only these fields of each item, by path (`author.name`). | maxItems: 64 | — |
| POST | keywords | array | 必填 | One to five keywords, each at most 50 characters and without a comma; letter case does not matter. One item comes back per keyword that has figures; a keyword the index does not cover is not in the answer | maxItems: 5 | ["咖啡","CityWalk"] |
| POST | since | string | 必填 | The first day wanted: the China-time (UTC+8) calendar day this moment falls on; 2026-09-01 means 1 September | — | "2026-09-01T00:00:00Z" |
| POST | until | string | 必填 | The last day wanted, read the same way. The platform publishes a day or two late: a day it has no figure for yet has a null index | — | "2026-09-30T00:00:00Z" |
| POST | view | string | 可选/条件 | How much of each item to return | ["compact","standard","full"] | — |
| POST | fields | array | 可选/条件 | Return only these fields | maxItems: 64 | — |
03
在本地试一次
先使用 demo 验证字段,再用客户测试 Key 显式选择 simulated 演练结算。不要把客户 Key 写入网址。
{
"capability": "douyin.index.keywords.history",
"method": "GET",
"params": {
"since": "2026-09-01T00:00:00Z",
"until": "2026-09-30T00:00:00Z",
"keyword": "咖啡"
}
}04
返回字段与解释
统一对象 keyword_history 允许空值;缺失字段不能替换成零。当前页展示主要结构,完整嵌套字段见对象文档。
| 字段 | 类型 | 含义 | 字段来源 |
|---|---|---|---|
| keyword | string | null | The keyword | 抖音 |
| points | array | null | The figures day by day, one entry a day, oldest first | 抖音 |
| points[].date | string | null | The day: a calendar day in China time (UTC+8), written as midnight UTC of its date (8 a.m. that day in China); passed back as since or until it asks for that same day | 抖音 |
| points[].search_index | integer | null | Search index of the day: the platform's index of how much the keyword was searched, not a count of searches | 抖音 |
| points[].composite_index | integer | null | Composite index of the day: the platform's index of how much attention content about the keyword drew, not a count | 抖音 |
| points[].notes | integer | null | Posts about the keyword that day (standard view and up) | 抖音 |
| points[].impressions | integer | null | Times those posts were shown that day (standard view and up) | 抖音 |
| points[].views | integer | null | Times those posts were read that day (standard view and up) | 抖音 |
| points[].engagements | integer | null | Engagements with those posts that day (standard view and up) | 抖音 |
| approximate | array | null | Which numbers of this item are approximate or lower bounds; absent when all are exact | 抖音 |
| approximate[].field | string | null | Path of the field, such as metrics.views | 抖音 |
| approximate[].kind | string | null | Approximate, or a lower bound | 抖音 |
| ext | object | — | 抖音 |
| ext.composite_average | integer | null | Daily average of the composite index over the period asked for (full view) | 抖音 |
| ext.search_average | integer | null | Daily average of the search index over the period asked for (full view) | 抖音 |
| ext.previous_composite_average | integer | null | Daily average of the composite index over the period of the same length before it (full view) | 抖音 |
| ext.previous_search_average | integer | null | Daily average of the search index over the period of the same length before it (full view) | 抖音 |
| ext.year_ago_composite_average | integer | null | Daily average of the composite index over the same period a year earlier (full view) | 抖音 |
| ext.year_ago_search_average | integer | null | Daily average of the search index over the same period a year earlier (full view) | 抖音 |
06
边界与核对
接口成功不等于覆盖全部公开内容。保留请求编号、采样时间、参数和分页位置,先核对返回条目,再进行分析。
本地模拟只使用 TEST 积分;真实 API、正式支付和外部邮件均关闭。原站历史价格不作为DataNavoAPI收费标准。
- 媒体地址、计数和显示字段的可用性应逐项核验。
输入清楚,结果可查。
每次点击仅运行本机固定样本,不访问平台。高级 JSON 参数按所选方法校验;修改输入不会自动执行。
复制不会运行请求。CLI quote 只读报价,需要本地客户 TEST Key;MCP 需先配置 demo;GET 与批量 POST 均只返回本地虚构样本。
下载合同固定示例(不执行) ↗需要 TEST 预算、Key 权限或失败演练?进入账户控制台。 客户模拟网关 ↗