Douyin Index Fetch Content Consumer Portrait
Get the audience portrait for people who watch Douyin videos in a specific content category. Here, “consumers” means viewers, not purchasers; this tool describes the audience rather than content creators. Inputs: - tag_id (required): A specific category ID as a string. "0" (all categories) is not supported. Category IDs can be obtained from the category filter options. - end_date (required): End date in YYYYMMDD format, aligned with the selected period. - period (optional): "week" or "month"; defaults to "month". Weekly dates must be Sundays, and monthly dates must be the last day of the month. Returns audience distributions such as gender, age group, region, interests, and devices. The detailed structure of the returned data is not specified, so available fields should be read from the actual result. 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
Copy the request and explore its response example.
/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_consumer_portrait' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"end_date": "20261031",
"period": "month",
"tag_id": "624"
}
}'{
"code": 200,
"data": {
"BaseResp": {
"StatusCode": 0
},
"interaction_data": [
{
"label_list": [
{
"label_id": "null",
"name_zh": "18-23",
"rate": 0.13451873599580996,
"tgi": 98.5440889505163
}
],
"name_en": "age"
}
],
"play_data": [
{
"label_list": [
{
"label_id": "null",
"name_zh": "18-23",
"rate": 0.12203667375895681,
"tgi": 98.15384103835459
}
],
"name_en": "age"
}
]
},
"docs": "https://api.tikhub.io/#/Douyin-Index-API/fetch_content_consumer_portrait_api_v1_douyin_index_fetch_content_consumer_portrait_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "d96aa61c-9d52-4626-8dda-e8e87624ac14"
}This example shows part of the response. Copied content is valid JSON.

