Douyin Billboard Fetch Hot User Portrait List

2.07 credits/call
ae_douyin_billboard_fetch_hot_user_portrait_list

Retrieve the audience profile of people who liked a specified work. Inputs: - aweme_id (required, string): The work ID. - option (optional, integer): Select the profile dimension: 1 = mobile phone price distribution; 2 = gender distribution; 3 = age distribution; 4 = province distribution; 5 = city distribution; 6 = city tier; 7 = mobile phone brand distribution. Defaults to 4 (province distribution). Returns: Response data describing the liking audience for the selected dimension. The detailed data structure is not specified. This profile concerns people who liked the work, rather than all viewers.

Social
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
optionintegerNo选项,1 手机价格分布 2 性别分布 3 年龄分布 4 地域分布-省份 5 地域分布-城市 6 城市等级 7 手机品牌分布4
aweme_idstringYes作品id—

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_billboard_fetch_hot_user_portrait_list' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "aweme_id": "7702397404621350821"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "code": 0,
    "data": {
      "item_id": "7702397404621350821",
      "option": "4",
      "portrait": {
        "key": "广东",
        "portrait_data": [
          {
            "name": "广东",
            "value": 0.11586581544523472
          }
        ]
      },
      "portrait_tgi": {
        "key": "西藏",
        "portrait_data": [
          {
            "name": "陕西",
            "value": 101.55199662050282
          }
        ]
      }
    },
    "extra": {
      "now": 1793786061000
    }
  },
  "docs": "https://api.tikhub.io/#/Douyin-Billboard-API/fetch_hot_user_portrait_list_api_v1_douyin_billboard_fetch_hot_user_portrait_list_get",
  "message": "Request successful. This request will incur a charge."
}

This example shows part of the response. Copied content is valid JSON.