Douyin Xingtu Kol Fans Portrait V1

41.31 credits/call
ae_douyin_xingtu_kol_fans_portrait_v1

Retrieve a Douyin Xingtu KOL's fan portrait (V1). Inputs: - kolId (required, string): The KOL's Xingtu identifier. If you only have a UID, sec_user_id, or unique_id, obtain the corresponding kolId first. - fansType (optional, string): '_1' for the general fan portrait (default), '_2' for the fan club portrait, or '_5' for the iron-fan portrait. Returns: The portrait for the selected fan category in the response's data field, along with response metadata. Detailed portrait fields are not specified in the documented schema; data may be null. This is a portrait lookup, not an individual fan list. Example input: {"kolId":"7048929565493690398","fansType":"_1"}.

Social
41.31 credits/call

Pricing

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

Each call has a fixed charge of 41.31 credits. 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—
fansTypestringNo粉丝类型/Fans Type_1

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_fans_portrait_v1' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "fansType": "_1",
    "kolId": "7285224814678114362"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "base_resp": {
      "status_code": 0,
      "status_message": ""
    },
    "distributions": [
      {
        "description": "分布最多的1个城市北京(12%)",
        "distribution_list": [
          {
            "distribution_key": "北京",
            "distribution_value": "8389"
          }
        ],
        "image": [
          "北京居多"
        ],
        "origin_type": 8,
        "type": 256,
        "type_display": "城市分布"
      }
    ],
    "last_update_time": "1794486444"
  },
  "docs": "https://api.tikhub.io/#/Douyin-Xingtu-API/kol_fans_portrait_v1_api_v1_douyin_xingtu_kol_fans_portrait_v1_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "params": {
    "fansType": "_1",
    "kolId": "7285224814678114362"
  }
}

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