Douyin Index Fetch Content Creative Keyword Items
Retrieve videos associated with a hot keyword in a specific Douyin content category to inspect which videos contribute to that keyword. Inputs and prerequisites: - tag_id (required): A specific category ID. "0" for all categories is not supported. - keyword (required): Select a keyword from the results of fetch_content_creative_keywords first. Use exactly the same tag_id, period, and end_date as in that keyword-list query; mismatched values can produce "json data error". - period (optional): "1" for the past day, "3" for the past 3 days, or "7" for the past 7 days. Defaults to "7". - end_date (required): End date in YYYYMMDD format. It must be a Sunday when period is "7"; for "1" or "3", any date is allowed. Returns: A response containing the videos related to the selected keyword in data. The response schema does not specify individual video fields. This is a keyword drill-down, not an unrestricted keyword search.
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** | — |
keyword | string | Yes | 关键词(从 fetch_content_creative_keywords 获取)/Keyword (get from fetch_content_creative_keywords) | — |
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) | — |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/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_keyword_items' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"tag_id": "xxx",
"keyword": "xxx",
"end_date": "xxx"
}
}'No response example available yet.

