Douyin Index Fetch Topic Query
Search for topics by keyword on Douyin or Toutiao within a specified date range. Inputs: - keyword (required): The topic keyword to search for. - start_date (required): Start date as a YYYYMMDD string. - end_date (required): End date as a YYYYMMDD string. - app_name (optional): aweme for Douyin (default), or toutiao for Toutiao. Returns: Response status information and a data payload containing topic details and related metrics, such as topic popularity and related video counts, when available. The payload may be null, and its exact fields are not fixed by the documented response schema; use the fields actually returned. Example: keyword="旅行", start_date="20260406", end_date="20260412", app_name="aweme".
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
keyword | string | Yes | 话题关键词/Topic keyword | — |
app_name | enum (aweme | toutiao) | No | 平台/Platform: aweme(抖音), toutiao(头条) | aweme |
end_date | string | Yes | 结束日期/End date YYYYMMDD | — |
start_date | string | Yes | 开始日期/Start date YYYYMMDD | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_index_fetch_topic_query' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"app_name": "aweme",
"end_date": "20261111",
"keyword": "供热管道",
"start_date": "20261104"
}
}'{
"code": 200,
"data": {
"BaseResp": {
"StatusCode": 0,
"StatusMessage": ""
},
"topic_list": [
{
"datetime": "",
"digg_cnt": "765",
"item_cnt": "22",
"play_read_cnt": "139559",
"topic_id": "1663060989747213",
"topic_index": "807"
}
]
},
"docs": "https://api.tikhub.io/#/Douyin-Index-API/fetch_topic_query_api_v1_douyin_index_fetch_topic_query_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"app_name": "aweme",
"end_date": "20261111",
"keyword": "供热管道",
"start_date": "20261104"
}
}This example shows part of the response. Copied content is valid JSON.

