Douyin Index Fetch Content Creative Topic
Retrieve popular creative topics for a specific Douyin content category to support content planning. Inputs: - tag_id (required): A specific category ID, for example "601" for Drama or "628" for Food. "0" for all categories is not supported. - end_date (required): End date in YYYYMMDD format. It must be a Sunday when period is "7", including when period is omitted. For period "1" or "3", any day is allowed. - period (optional): "1", "3", or "7"; defaults to "7". - rank_type (optional): "index" for index ranking or "rise" for rising ranking; defaults to "index". Returns: Response data containing the popular topic list for the selected category and period, using the requested ranking. The documented response schema does not specify individual topic fields. Example: tag_id="601", period="7", end_date="20260405", rank_type="index".
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 |
|---|---|---|---|---|
period | enum (1 | 3 | 7) | No | 时间周期/Period: 1, 3, 7 | 7 |
tag_id | string | Yes | 垂类ID,**必填,不支持 0=全部** / Category ID, **required, does NOT support 0=all** | — |
end_date | string | Yes | 结束日期 YYYYMMDD(**仅当 period=7 时必须为周日**,period=1/3 时可为任意日期)/End date YYYYMMDD (**must be a Sunday only when period=7**; any day for period=1/3) | — |
rank_type | enum (index | rise) | No | 排序类型/Rank type: index=指数排序, rise=飙升排序 | index |
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_content_creative_topic' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"end_date": "20261101",
"period": "7",
"rank_type": "rise",
"tag_id": "613"
}
}'{
"code": 200,
"data": {
"BaseResp": {
"StatusCode": -1,
"StatusMessage": "系统异常"
}
},
"docs": "https://api.tikhub.io/#/Douyin-Index-API/fetch_content_creative_topic_api_v1_douyin_index_fetch_content_creative_topic_post",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

