Douyin Index Fetch Item User Profile

2.07 credits/call
ae_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"} ```

SocialVideo
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
item_idstringYes视频ID(抖音 aweme id,纯数字)/Video ID (Douyin aweme id, numeric). Example: 7660090930283744575—
end_datestringYes结束日期/End date YYYYMMDD—
start_datestringYes开始日期/Start date YYYYMMDD—

Invocation example

Copy the request and explore its response example.

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_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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.