Douyin keyword-index demo
Douyin keyword-index demo. Follow concrete contracts, examples and reviewable steps using Douyin.
Copy the agent prompt manually
Douyin keyword index
Paste a complete link or identifier, then explicitly run a fictional local sample. The source URL is never requested and no credits are spent.
Use a complete URL or platform identifier. Open short links yourself and copy the complete address. Editing clears the old result and does not execute anything.
Fictional fixture · 0 live calls · 0 charges
Inspect complete JSON
Input and result
This tool maps the task to douyin.index.keywords.history. Check the input fields below, then run it in the local console; results are fixtures.
Input contract
Inspect meanings, examples and conditional rules for the selected method. view and fields control the response without changing the TEST unit price.
- GET: supply exactly one of keyword.
- POST: supply exactly one of keywords.
| Method | Field | Type | Requirement | Meaning | Enum or bound | Example |
|---|---|---|---|---|---|---|
| GET | keyword | string | Optional / conditional | One keyword, at most 50 characters and without a comma; letter case does not matter | — | "咖啡" |
| GET | since | string | Required | 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 | Required | 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 | Optional / conditional | 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 | Optional / conditional | Return only these fields of each item, by path (`author.name`). | maxItems: 64 | — |
| POST | keywords | array | Required | 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 | Required | 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 | Required | 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 | Optional / conditional | How much of each item to return | ["compact","standard","full"] | — |
| POST | fields | array | Optional / conditional | Return only these fields | maxItems: 64 | — |
Try it locally
Use demo to inspect the fields, then explicitly select simulated with a customer test key to exercise settlement. Never put a customer key in a URL.
{
"capability": "douyin.index.keywords.history",
"method": "GET",
"params": {
"since": "2026-09-01T00:00:00Z",
"until": "2026-09-30T00:00:00Z",
"keyword": "咖啡"
}
}Output fields and interpretation
The keyword_history object permits missing or null values; do not replace missing measurements with zero. This table shows the main structure; the object reference covers nested fields.
| Field | Type | Meaning | Source scope |
|---|---|---|---|
| keyword | string | null | The keyword | Douyin |
| points | array | null | The figures day by day, one entry a day, oldest first | Douyin |
| 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 | Douyin |
| 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 | Douyin |
| 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 | Douyin |
| points[].notes | integer | null | Posts about the keyword that day (standard view and up) | Douyin |
| points[].impressions | integer | null | Times those posts were shown that day (standard view and up) | Douyin |
| points[].views | integer | null | Times those posts were read that day (standard view and up) | Douyin |
| points[].engagements | integer | null | Engagements with those posts that day (standard view and up) | Douyin |
| approximate | array | null | Which numbers of this item are approximate or lower bounds; absent when all are exact | Douyin |
| approximate[].field | string | null | Path of the field, such as metrics.views | Douyin |
| approximate[].kind | string | null | Approximate, or a lower bound | Douyin |
| ext | object | — | Douyin |
| ext.composite_average | integer | null | Daily average of the composite index over the period asked for (full view) | Douyin |
| ext.search_average | integer | null | Daily average of the search index over the period asked for (full view) | Douyin |
| ext.previous_composite_average | integer | null | Daily average of the composite index over the period of the same length before it (full view) | Douyin |
| ext.previous_search_average | integer | null | Daily average of the search index over the period of the same length before it (full view) | Douyin |
| ext.year_ago_composite_average | integer | null | Daily average of the composite index over the same period a year earlier (full view) | Douyin |
| ext.year_ago_search_average | integer | null | Daily average of the search index over the same period a year earlier (full view) | Douyin |
Clear inputs. Inspectable output.
Each click runs a local fixture. Advanced JSON inputs are checked against the selected method. Editing does not execute a request.
Copying does not execute. CLI quote is read-only and needs a local customer TEST key. Configure MCP in demo mode first. GET and POST batches both return only fictional local fixtures.
Download contract example (no execution) ↗For TEST budgets, Key scopes or failure scenarios, open the account console. Customer sandbox ↗