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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 41.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
kolId | string | Yes | 用户的kolId/User kolId | — |
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_audience_portrait_v1' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"kolId": "7048929565493690398"
}
}'{
"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.

