Douyin Index Fetch Content Creative Keyword Items

2.07 credits/call
ae_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.

VideoSocial
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
periodenum (1 | 3 | 7)No时间周期/Period: 1, 3, 77
tag_idstringYes垂类ID,**必填,不支持 0=全部** / Category ID, **required, does NOT support 0=all**—
keywordstringYes关键词(从 fetch_content_creative_keywords 获取)/Keyword (get from fetch_content_creative_keywords)—
end_datestringYes结束日期 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 template

Generated from the parameter configuration. Replace the sample values before use.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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.