Douyin Xingtu Kol Conversion Ability Analysis V1

41.31 credits/call
ae_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.

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—
_rangestringYes时间范围/Time Range—

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_conversion_ability_analysis_v1' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "_range": "90",
    "kolId": "7498263536691314739"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.