Douyin Index Fetch Content Consume Trend
Retrieve daily viewing and content-consumption trends for a specific Douyin category to understand how its viewing popularity changes over time. Required inputs: - tag_id: A specific category ID as a string. "0" (all categories) is not supported. - start_date: Inclusive start date as a YYYYMMDD string. - end_date: Inclusive end date as a YYYYMMDD string. Returns daily aggregated consumption data. Documented metrics include total plays, watch duration, and unique viewers per day. Consumption means content viewing, not monetary spending. The exact metric fields and response layout are not specified by the response schema; use the values actually returned.
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 |
|---|---|---|---|---|
tag_id | string | Yes | 垂类ID,**必填,不支持 0=全部**(同 fetch_item_query 的 category_id 但不接受 0)/Category ID, **required, does NOT support 0=all**. Get full list via fetch_item_filter_options (excluding id=0) | — |
end_date | string | Yes | 结束日期/End date YYYYMMDD | — |
start_date | string | Yes | 开始日期/Start date YYYYMMDD | — |
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_consume_trend' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"tag_id": "xxx",
"end_date": "xxx",
"start_date": "xxx"
}
}'No response example available yet.

