Douyin Xingtu Kol Audience Portrait V1

41.31 credits/call
ae_douyin_xingtu_kol_audience_portrait_v1

Retrieve the V1 audience portrait for a Douyin Xingtu creator (KOL). Input: kolId is required and must be the creator's Xingtu KOL ID as a string, for example "7048929565493690398". If you only have a uid, sec_user_id, or unique_id, obtain the corresponding kolId with an ID lookup tool first. Result: The response's data contains the KOL audience portrait and may be null. The documented response does not specify individual portrait attributes or their structure, so available details depend on the returned data.

Social
41.31 credits/call

Pricing

41.31 credits/call
ConditionCharge
Each call41.31 credits/call

41.31 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
kolIdstringYes用户的kolId/User kolId—

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_xingtu_kol_audience_portrait_v1' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "kolId": "7048929565493690398"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "base_resp": {
      "status_code": 0
    },
    "distributions": [
      {
        "description": "苹果手机占比66%, 消费能力较好",
        "distribution_list": [
          {
            "distribution_key": "其他",
            "distribution_value": "1"
          }
        ],
        "image": [
          "苹果手机较多"
        ],
        "origin_type": 3,
        "type": 8,
        "type_display": "设备品牌分布"
      }
    ],
    "last_update_time": "1793785533"
  },
  "docs": "https://api.tikhub.io/#/Douyin-Xingtu-API/kol_audience_portrait_v1_api_v1_douyin_xingtu_kol_audience_portrait_v1_get",
  "message": "Request successful. This request will incur a charge."
}

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