Douyin Billboard Fetch Hot Account Fans Portrait List

2.07 credits/call
ae_douyin_billboard_fetch_hot_account_fans_portrait_list

Retrieve a Douyin account's fan profile for a selected audience dimension. Inputs: - sec_uid (required string): The account user's sec_id. - option (optional integer; default 1): Select the profile dimension: 1. Mobile phone price distribution 2. Gender distribution 3. Age distribution 4. Geographic distribution by province 5. Geographic distribution by city 6. City tier 7. Mobile phone brand distribution 8. Interest tag analysis, expressed as percentages Returns fan profile data for the selected dimension, rather than a list of individual fans. The detailed payload structure is unspecified, so available categories and values should be interpreted from the returned data.

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 手机品牌分布 8 兴趣标签分析 百分比1
sec_uidstringYes用户sec_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_account_fans_portrait_list' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "option": 2,
    "sec_uid": "MS4wLjABAAAAaMFzpNBhDUj_FO5Sbjtg5hdd_2At87LQEMVBKF3ncbs"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "code": 0,
    "data": {
      "option": "2",
      "portrait": {
        "key": "male",
        "portrait_data": [
          {
            "name": "male",
            "value": 0.7627058640270756
          }
        ]
      },
      "portrait_tgi": {
        "key": "male",
        "portrait_data": [
          {
            "name": "male",
            "value": 144.9242991313844
          }
        ]
      },
      "user_id": "MS4wLjABAAAAaMFzpNBhDUj_FO5Sbjtg5hdd_2At87LQEMVBKF3ncbs"
    },
    "extra": {
      "now": 1794389428000
    },
    "message": ""
  },
  "docs": "https://api.tikhub.io/#/Douyin-Billboard-API/fetch_hot_account_fans_portrait_list_api_v1_douyin_billboard_fetch_hot_account_fans_portrait_list_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "params": {
    "option": "2",
    "sec_uid": "MS4wLjABAAAAaMFzpNBhDUj_FO5Sbjtg5hdd_2At87LQEMVBKF3ncbs"
  }
}

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