Douyin Index Fetch Item User Profile
## Purpose Get the audience profile for a specific Douyin video over a chosen date range. ## Required inputs - `item_id`: The video's Douyin aweme ID, provided as a numeric string. - `start_date`: Start date as a string in `YYYYMMDD` format. - `end_date`: End date as a string in `YYYYMMDD` format. ## Result Returns audience distributions such as gender, age, region, and interests. These describe the video's audience composition, not individual viewers' personal profiles. The detailed data structure is not specified; use the dimensions and values actually returned. ## Example inputs ```json {"item_id":"7660090930283744575","start_date":"20260704","end_date":"20260710"} ```
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 |
|---|---|---|---|---|
item_id | string | Yes | 视频ID(抖音 aweme id,纯数字)/Video ID (Douyin aweme id, numeric). Example: 7660090930283744575 | — |
end_date | string | Yes | 结束日期/End date YYYYMMDD | — |
start_date | string | Yes | 开始日期/Start 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_item_user_profile' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"end_date": "20260710",
"item_id": "7660090930283744575",
"start_date": "20260704"
}
}'{
"code": 200,
"data": {
"data": [
{
"label_list": [
{
"label_id": "110010410",
"name_zh": "18-23",
"tgi": 0,
"value": 0
}
],
"name_en": "age",
"name_zh": "年龄"
}
]
},
"docs": "https://api.tikhub.io/#/Douyin-Index-API/fetch_item_user_profile_api_v1_douyin_index_fetch_item_user_profile_post",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

