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"}.
Pricing
| Condition | Charge |
|---|---|
| Each call | 41.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
kolId | string | Yes | 用户的kolId/User kolId | — |
fansType | string | No | 粉丝类型/Fans Type | _1 |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --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"
}
}'{
"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.

