Douyin Xingtu Kol Conversion Ability Analysis V1
Retrieve V1 conversion ability analysis for a Douyin Xingtu creator over the last 7, 30, or 90 days. Required inputs: kolId (string), the creator's Xingtu KOL identifier; and _range (string), set to _1 for the last 7 days, _2 for the last 30 days, or _3 for the last 90 days. If you only have uid, sec_user_id, or unique_id, first use a KOL ID lookup to obtain kolId. The response's data field contains the conversion ability analysis for the selected creator and period and may be null. Individual metrics and their structure are not specified in the documented response; use the returned content without assuming particular metrics.
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 | — |
_range | string | Yes | 时间范围/Time Range | — |
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_conversion_ability_analysis_v1' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"_range": "90",
"kolId": "7498263536691314739"
}
}'{
"code": 200,
"data": {
"avg_sales_amount_range": "0",
"base_resp": {
"status_code": 0,
"status_message": ""
},
"component_click_cnt_range": "0",
"component_click_rate_range": "0",
"gpm_range": "0",
"rec_product_cnt": {
"value": "1"
}
},
"docs": "https://api.tikhub.io/#/Douyin-Xingtu-API/kol_conversion_ability_analysis_v1_api_v1_douyin_xingtu_kol_conversion_ability_analysis_v1_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"_range": "90",
"kolId": "7498263536691314739"
}
}This example shows part of the response. Copied content is valid JSON.

