Douyin Index Fetch Content Creative Duration

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

VideoSocial
2.07 credits/call

Pricing

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

ParameterTypeRequiredDescriptionDefault
periodenum (week | month)No时间粒度/Period: week=周, month=月week
tag_idstringYes垂类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_datestringYes结束日期/End date YYYYMMDD—

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_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.