Douyin Xingtu Get Kolid By Unique ID
Look up an account's XingTu visitor kolid from its Douyin account handle. Input: unique_id (required string), the Douyin account handle, which can be obtained from account profile information. Example: m6640150. Returns: a JSON response whose data contains the lookup result, together with response status information. The exact structure of data is not specified in the documented schema. The kolid is the XingTu identifier being looked up, not the input Douyin handle; this tool does not retrieve a full profile or analytics.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
Each call has a fixed charge of 2.07 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 |
|---|---|---|---|---|
unique_id | string | Yes | 抖音号/Douyin User unique_id | — |
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_get_kolid_by_unique_id' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"unique_id": "54569391888"
}
}'{
"code": 200,
"data": {
"avatar_uri": "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-c9aec8xkvj_d8e3348a3d4743e4a13e8fa70b0f178d.jpeg?from=3782654143",
"base_resp": {
"status_code": 0,
"status_message": "Success"
},
"core_user_id": "7682030020299097137",
"finish_rate_ovr": 0,
"id": "7696096144945840137",
"nick_name": "小周学长"
},
"docs": "https://api.tikhub.io/#/Douyin-Xingtu-API/get_xingtu_kolid_by_unique_id_api_v1_douyin_xingtu_get_xingtu_kolid_by_unique_id_get",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

