Douyin Fetch Item Audience Portrait
## Purpose Retrieve the aggregate audience profile for a specific Douyin item to support content planning and audience analysis. ## Required inputs Provide a `request_body` object with both string fields: - `cookie`: A valid Douyin Creator Platform Cookie. This is a sensitive session credential; handle it confidentially. - `item_id`: The ID of the item to analyze. ## Result meaning The response contains audience statistics in `data` when available: - `active`: Activity-period shares. Keys `2`, `3`, `4`, and `-1` mean morning, afternoon, evening, and other/unclassified periods respectively. - `gender`, `province`, and `age`: Audience composition by gender, province, and age group. `ratio_list` contains group shares as fractions from 0 to 1, while `tgi_list` contains Target Group Index values. TGI of 100 matches the platform average; above or below 100 indicates higher or lower representation relative to that average. - `career`, `city_level`, and `new_user`: Additional career, city-level, and new-user dimensions, which may be empty. This is a direct data query, not a background task. Check response status and data availability before drawing conclusions. Some dimensions may be empty or zero because of limited samples or unavailable statistics, and updates may be delayed. Results describe aggregate viewers of the selected item, not individual viewers or the account's overall followers.
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 |
|---|---|---|---|---|
request_body | object | Yes | 作品观众数据分析请求参数/Item audience portrait request parameters | — |
request_body.cookie | string | Yes | 用户Cookie/User Cookie | — |
request_body.item_id | string | Yes | 作品ID/Item ID | — |
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_fetch_item_audience_portrait' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"cookie": "Your_Cookie_Here",
"item_id": "7559536212910853422"
}
}
}'No response example available yet.

