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".
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 |
|---|---|---|---|---|
period | enum (week | month) | No | 时间粒度/Period: week or month | month |
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-KeyNo response example available yet.

