Douyin Index Fetch Content Author Portrait

2.07 credits/call
ae_douyin_index_fetch_content_author_portrait

Retrieve the aggregate profile of creators who publish Douyin videos in a specific content category. This describes the creators, not their viewers or an individual account. Inputs: - tag_id (required string): A specific content category ID. "0" (all categories) is not supported; choose a nonzero ID from the category filter options. - end_date (required string): The period's end date in YYYYMMDD format. - period (optional): "week" or "month"; defaults to "month". Weekly requests require a Sunday end_date; monthly requests require the last day of the month. The result provides creator portrait distributions such as gender, age group, region, device, and active time. The exact data fields depend on the returned payload, which may be null; no fixed portrait field structure is documented. Example: tag_id="601", period="month", end_date="20260331".

Social
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 (week | month)No时间粒度/Period: week or monthmonth
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_author_portrait' \
  --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.