kolIdstringrequired
User kolId, can be obtained from the following interfaces: `douyin/xingtu/xingtu-kolid-by-uid`; `douyin/xingtu/xingtu-kolid-by-sec-user-id`; `douyin/xingtu/xingtu-kolid-by-unique-id`
https://api.sandbase.ai/v1/api/douyin/xingtu/kol-base-info-v1Get the XingTu (Douyin creator marketplace) profile of a KOL: followers, location, category tags, online status and available collaboration types.
[
{
"data": {
"abandon_sign_result": 0,
"appeal_id": "0",
"author_avatar_frame_icon": 20,
"author_type": 1,
"avatar_uri": "https://p26.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_8c900db621ce282dd6a0037531ea104a.jpeg?from=3782654143",
"avg_play": 0,
"aweme_tags": [],
"base64_qrcode": "iVBORw0KGgoAAAANSUhEUgAAAWgAAAFoAQAAAABSnlx4AAACZElEQVR4nO2bzW7DMAyDySHv/8rcQT+2010KOK09qxjaNPkOhCowtOJReOP18w5cdNFFF130g/QFALRjUQAIUYQAgCIUVx9WcgZ9AYAXN94oq71Xvru6ju7NadKrLQgCQRDKlic/puQsmrB2NmPxv68oOYF+yeLi+H1R3RvR5t9e6ehuwkpt1tL9Duvo3pW2ekcbi6AoiGIc95ayju5d6Qto/SuAEUlkOQWDy6yje1fa87fguS/yH6F0bypMZR3du9Lew/n5x3oHRHxfR/fWNAkRtPQndxJapwtU/hqL6d6VlsDIInR3cY+xE24pq+nekL7iIHxbNEcBrLHNumt9OYmOeZXPS7LSFsHtnDX400rOoNlWOm01KUveflKs9c40OmvJuDO2cOKxpMXBhXRvThOyfKJIKOkxBBVZfDnd29H0nB03R435u5unPK3kDDrul1ZxjSnFLJ01r5pNi6DV+Ja/mVc/pOS/05FPbCKoLgl2q3nU/GQWHYW1NTtv+RuwoaGfXkj3rnQuJPuTff7OWdXTSo6iCUGS4pmOv/sZlH/PojMP5mFb7Jh9R6eXf8+gc4uPt/U4//YAXv49jc75SZdLuuZGe/LztJKzaEHSS/5WPCwu/55ENz9J5wDu829Eh6+je1e6zVqRc/B+/h2x/HklZ9D9BpNs55ZKfEBb/j2L7pNgNPUw/04Przw4g/bnl7H7pBvByncj54/wsJIDaTGyiW9Mvm0CWlX31vSw/yS8RZUHp9KS+bjwuv9EbWfbcrq3o8f9sb4tNv+TJzcQ+j11Hd270kP+/qqSoosuuuii33n9AnkQMuaOjt+GAAAAAElFTkSuQmCC",
"base_resp": {
"status_code": 0,
"status_message": "Success"
},
"category_id": "1",
"city": "长沙市",
"content_theme_labels": [
"宠物猫日常",
"猫咪萌态",
"可爱猫咪",
"宠物与主人",
"宠物猫食",
"猫咪娱乐",
"萌宠乐趣",
"宠物知识",
"宠物歌舞",
"猫咪健康"
],
"core_user_id": "93153724393",
"create_time": "1638802586",
"creator_type": 0,
"e_commerce_enable": false,
"follower": 886798,
"gender": 2,
"grade": 0,
"has_phone": true,
"id": "7038603512770461703",
"industry_list": [],
"is_cpm_project_author": false,
"is_game_author": false,
"is_online": true,
"is_plan_author": false,
"is_star": true,
"is_visible": false,
"lowest_price": 0,
"mcn_introduction": "",
"mcn_logo": "",
"mcn_name": "",
"modify_time": "1791220894",
"nick_name": "是甜口的鸭蛋",
"online_status": 1,
"opened_task_category": "[103, 1, 6, 52, 120, 133, 157]",
"platform": [
1,
5
],
"platform_channel": [
1,
10
],
"platform_source": 1,
"protocol_id": "20210530",
"province": "湖南省",
"qrcode_url": "",
"sec_uid": "MS4wLjABAAAAXakJHNxB0cmKZ6c6FthE2_vA7he6kHmgSBp9YjggHR8",
"short_id": "3933239620",
"star_tags": [],
"status": 1,
"tags": "[\"\\u840c\\u5ba0\"]",
"tags_author_style": "[]",
"tags_ids": "[11]",
"tags_ids_level_two": "[12]",
"tags_level_two": "[\"\\u65e5\\u5e38\\u5ba0\\u7269\"]",
"tags_relation": {
"萌宠": [
"日常宠物"
]
},
"task_status": 2,
"unique_id": "malin337"
}
}
]Select an example to load its inputs and result into the playground.
This API returns the XingTu (Douyin creator marketplace) profile of one KOL. It needs a XingTu kolId and a platformChannel value (_1 for Douyin video, _10 for Douyin live).
core_user_id and id to join XingTu profiles with other creator records.curl -X POST "https://api.sandbase.ai/v1/api/douyin/xingtu/kol-base-info-v1" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kolId": "7038603512770461703", "platformChannel": "_1"}'
The result is returned in outputs[0].data.
| Name | Type | Required | Description |
|---|---|---|---|
kolId | string | Yes | User kolId, can be obtained from the following interfaces: douyin/xingtu/xingtu-kolid-by-uid; douyin/xingtu/xingtu-kolid-by-sec-user-id; douyin/xingtu/xingtu-kolid-by-unique-id |
platformChannel | string | Yes | Platform channel, supports the following parameters: _1: Douyin Video; _10: Douyin Live |
Real response for the request above, trimmed: lists keep their first item and long strings are cut.
{
"abandon_sign_result": 0,
"appeal_id": "0",
"author_avatar_frame_icon": 20,
"author_type": 1,
"avatar_uri": "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_8c900db621…",
"avg_play": 0,
"aweme_tags": [],
"base64_qrcode": "iVBORw0KGgoAAAANSUhEUgAAAWgAAAFoAQAAAABSnlx4AAACZElEQVR4nO2bzW7DMAyDySHv/8rcQT+2…",
"base_resp": {
"status_code": 0,
"status_message": "Success"
},
"category_id": "1",
"city": "长沙市",
"content_theme_labels": [
"宠物猫日常"
]
}
| Field | Meaning |
|---|---|
id | The XingTu kolId of the creator. It matches the kolId you sent. |
nick_name | Display name of the creator. |
follower | Follower count of the creator. |
city | City of the creator, as a Chinese place name. |
content_theme_labels[] | Content theme tags for the creator, such as pet cat topics. |
is_online / online_status | Returned online-state flags in this snapshot; not a guarantee of current availability. is_online is boolean and online_status numeric. |
is_star / e_commerce_enable / is_game_author | Flags for creator type: XingTu star author, e-commerce enabled, and game author. |
opened_task_category | List of task category IDs open for collaboration. It is returned as a string that holds a list. |
platform_channel[] | Returned channel codes. Numeric 1/10 differ from request strings _1/_10 and do not certify present availability or a newly tested live channel. |
create_time / modify_time | Unix timestamps in seconds as strings. |
kolId from Douyin XingTu kolId Lookup, Douyin XingTu KOL ID by User ID or Douyin XingTu KOL ID by Unique ID.platformChannel accepts _1 for Douyin video and _10 for Douyin live.$0.02 per successful call. Failed calls are not charged.
Send exact-string kolId and platformChannel. Current documentation lists _1 for Douyin Video and _10 for Douyin Live; the saved example uses _1. A Douyin UID, sec_user_id, handle or nickname is not a kolId substitute. A separately chosen resolver would require its own validated contract and budget. This task does not run it or certify a new _10 response.
After business validation, check flat id matches the selected kolId before attaching follower, nick_name and theme fields. The October 7 saved profile is an independent pet-content creator, with integer follower 886798. It is not a selected result from the saved keyword example search. The shortened README omits later identity fields due to trimming; that is not proof those fields are absent from the full capture.
Keep is_online, online_status and has_phone as returned flags, not proof of current availability, responsiveness or a usable phone number. Do not extract contact material from MCN introductions or QR references into a shared report. The saved capture has no mcn_id; missing membership evidence stays unknown. Reported avg_play 0 does not establish that the creator has no views.
opened_task_category and tags are JSON-encoded strings, while content_theme_labels is an array. Preserve their raw forms and decode only known string fields with guarded parsing. Response platform_channel [1,10] is distinct from request strings _1 and _10. create_time and modify_time describe the record, not this review's observation time or verified account age. Keep identity fields separate and do not join creators by display name.
Stop after the selected profile. Price, audience, performance and resolver endpoints are separate tasks with separate costs; the old seven-call evaluation is historical, not an automatic continuation. For an unselected creator, keyword candidates are an independent first task, not a guaranteed identity lookup.
Choose creator candidates or a known profile before making a request. Give your agent the setup Skill, Markdown quickstart, selected endpoint and desired result. Keep SANDBASE_API_KEY locally and use POST /v1/api/ with Bearer authentication. Do not automatically follow the first candidate, resolve identifiers, retrieve prices or contact a creator.
Require completed SandBase status and an object at outputs[0].data. Check base_resp.status_code is integer 0; false, string 0 or a missing status is not success. Search has authors while the profile is a flat object with id. Preserve missing and null data instead of reporting zero, no MCN affiliation or no fee. Successful status_message is empty in one saved search and Success in the profile, so do not require one guessed success string.
Pricing checked November 8 lists $0.02 per selected API request. Neither selected inspect result declares free_quota; do not promise that the general 100-call daily offer covers these routes. One deliberate request lists at $0.02 and two at $0.04 before any separately verified adjustment. These API charges are distinct from creator collaboration prices. No new business, paid, continuation, contact or media request was made. The Xingtu Python guide preserves the old multi-endpoint experiment as dated history and separates current contract checks and offline validation.
Start building
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/douyin/xingtu/kol-base-info-v1" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"kolId": "7038603512770461703",
"platformChannel": "_1"
}
SANDBASE_JSON
)
printf '%s\n' "$result"Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
kolIdstringrequiredUser kolId, can be obtained from the following interfaces: `douyin/xingtu/xingtu-kolid-by-uid`; `douyin/xingtu/xingtu-kolid-by-sec-user-id`; `douyin/xingtu/xingtu-kolid-by-unique-id`
platformChannelstringrequiredPlatform channel, supports the following parameters: _1: Douyin Video; _10: Douyin Live
Saved example response for this API; no live request is made when viewing it.
[
{
"data": {
"abandon_sign_result": 0,
"appeal_id": "0",
"author_avatar_frame_icon": 20,
"author_type": 1,
"avatar_uri": "https://p26.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_8c900db621ce282dd6a0037531ea104a.jpeg?from=3782654143",
"avg_play": 0,
"aweme_tags": [],
"base64_qrcode": "iVBORw0KGgoAAAANSUhEUgAAAWgAAAFoAQAAAABSnlx4AAACZElEQVR4nO2bzW7DMAyDySHv/8rcQT+2010KOK09qxjaNPkOhCowtOJReOP18w5cdNFFF130g/QFALRjUQAIUYQAgCIUVx9WcgZ9AYAXN94oq71Xvru6ju7NadKrLQgCQRDKlic/puQsmrB2NmPxv68oOYF+yeLi+H1R3RvR5t9e6ehuwkpt1tL9Duvo3pW2ekcbi6AoiGIc95ayju5d6Qto/SuAEUlkOQWDy6yje1fa87fguS/yH6F0bypMZR3du9Lew/n5x3oHRHxfR/fWNAkRtPQndxJapwtU/hqL6d6VlsDIInR3cY+xE24pq+nekL7iIHxbNEcBrLHNumt9OYmOeZXPS7LSFsHtnDX400rOoNlWOm01KUveflKs9c40OmvJuDO2cOKxpMXBhXRvThOyfKJIKOkxBBVZfDnd29H0nB03R435u5unPK3kDDrul1ZxjSnFLJ01r5pNi6DV+Ja/mVc/pOS/05FPbCKoLgl2q3nU/GQWHYW1NTtv+RuwoaGfXkj3rnQuJPuTff7OWdXTSo6iCUGS4pmOv/sZlH/PojMP5mFb7Jh9R6eXf8+gc4uPt/U4//YAXv49jc75SZdLuuZGe/LztJKzaEHSS/5WPCwu/55ENz9J5wDu829Eh6+je1e6zVqRc/B+/h2x/HklZ9D9BpNs55ZKfEBb/j2L7pNgNPUw/04Przw4g/bnl7H7pBvByncj54/wsJIDaTGyiW9Mvm0CWlX31vSw/yS8RZUHp9KS+bjwuv9EbWfbcrq3o8f9sb4tNv+TJzcQ+j11Hd270kP+/qqSoosuuuii33n9AnkQMuaOjt+GAAAAAElFTkSuQmCC",
"base_resp": {
"status_code": 0,
"status_message": "Success"
},
"category_id": "1",
"city": "长沙市",
"content_theme_labels": [
"宠物猫日常",
"猫咪萌态",
"可爱猫咪",
"宠物与主人",
"宠物猫食",
"猫咪娱乐",
"萌宠乐趣",
"宠物知识",
"宠物歌舞",
"猫咪健康"
],
"core_user_id": "93153724393",
"create_time": "1638802586",
"creator_type": 0,
"e_commerce_enable": false,
"follower": 886798,
"gender": 2,
"grade": 0,
"has_phone": true,
"id": "7038603512770461703",
"industry_list": [],
"is_cpm_project_author": false,
"is_game_author": false,
"is_online": true,
"is_plan_author": false,
"is_star": true,
"is_visible": false,
"lowest_price": 0,
"mcn_introduction": "",
"mcn_logo": "",
"mcn_name": "",
"modify_time": "1791220894",
"nick_name": "是甜口的鸭蛋",
"online_status": 1,
"opened_task_category": "[103, 1, 6, 52, 120, 133, 157]",
"platform": [
1,
5
],
"platform_channel": [
1,
10
],
"platform_source": 1,
"protocol_id": "20210530",
"province": "湖南省",
"qrcode_url": "",
"sec_uid": "MS4wLjABAAAAXakJHNxB0cmKZ6c6FthE2_vA7he6kHmgSBp9YjggHR8",
"short_id": "3933239620",
"star_tags": [],
"status": 1,
"tags": "[\"\\u840c\\u5ba0\"]",
"tags_author_style": "[]",
"tags_ids": "[11]",
"tags_ids_level_two": "[12]",
"tags_level_two": "[\"\\u65e5\\u5e38\\u5ba0\\u7269\"]",
"tags_relation": {
"萌宠": [
"日常宠物"
]
},
"task_status": 2,
"unique_id": "malin337"
}
}
]Explore more
| API | Price | Response |
|---|---|---|
Douyin XingTu KOL ProfileThis API Douyin | $0.02 per call | JSON |
Douyin | $0.02 per call | JSON |
Douyin | $0.02 per call | JSON |
Douyin | $0.02 per call | JSON |
Douyin | $0.02 per call | JSON |
Douyin | $0.02 per call | JSON |
Questions
Send a POST request to https://api.sandbase.ai/v1/api/douyin/xingtu/kol-base-info-v1 with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
$0.02 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.
Required: kolId (string) and platformChannel (string). The Parameters table and the Playground on this page list every field.
A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.
No. Douyin XingTu KOL Profile runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Douyin API access separately.
The current schema lists _1 for Douyin Video and _10 for Douyin Live. The saved profile uses _1. Numeric response channel values or historical tests with string 1 do not replace these request strings, and no new _10 response was tested.
No. A phone or online flag is not a usable contact or a guarantee of current responsiveness. Missing mcn_id remains unknown, not false. This profile read does not extract or use contact material, send messages or place an order.
Neither selected inspect result declares free_quota. Each lists $0.02 per API call; do not promise the general 100-call offer applies. API charges differ from creator collaboration prices. Any additional lookup or price request is a separate deliberate task.