Douyin Index Fetch Content Creative Duration
## Purpose Retrieve video-duration distribution for a specific content category to understand its video-length structure and creators' preferred lengths. ## Inputs - `tag_id` (required, string): A specific category ID. The all-categories value `"0"` is not supported. - `end_date` (required, string): Reporting end date in `YYYYMMDD` format. Must be a Sunday for weekly reports or the last day of the month for monthly reports. - `period` (optional): `"week"` for weekly reporting (default) or `"month"` for monthly reporting. ## Results Video counts and proportions for each duration bucket. Documented examples include 0–15 seconds, 15–60 seconds, 60–180 seconds, and over 180 seconds. These are aggregate category statistics, not individual video records. Detailed result fields are not fixed by the response schema; interpret the bucket labels and values actually returned.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
A fixed charge of 2.07 credits applies per 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 (week | month) | No | 时间粒度/Period: week=周, month=月 | week |
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 | — |
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_duration' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"tag_id": "xxx",
"end_date": "xxx"
}
}'No response example available yet.

