Douyin XingTu KOL Profile

API docs
https://api.sandbase.ai/v1/api/douyin/xingtu/kol-base-info-v1

Get the XingTu (Douyin creator marketplace) profile of a KOL: followers, location, category tags, online status and available collaboration types.

Price
$0.02USD / call
Method
POST
Response
JSON
Parameters
2 required · 0 optional

Playground

Input
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`
Platform channel, supports the following parameters: _1: Douyin Video; _10: Douyin Live
OutputExample
Responseoutputs · 2.9 KB · 84 lines
[
  {
    "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"
    }
  }
]

Examples

Select an example to load its inputs and result into the playground.

API README

Douyin XingTu KOL Profile API

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).

Use cases

  • Check follower count and city of a Douyin creator before adding them to a campaign shortlist.
  • Filter creators by content theme labels such as pet or cat content.
  • Preserve returned is_online and has_phone flags; they do not establish present availability, contactability or a usable phone number.
  • Store core_user_id and id to join XingTu profiles with other creator records.

Request

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.

Parameters

NameTypeRequiredDescription
kolIdstringYesUser 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
platformChannelstringYesPlatform channel, supports the following parameters: _1: Douyin Video; _10: Douyin Live

Example response

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": [
    "宠物猫日常"
  ]
}

Response fields

FieldMeaning
idThe XingTu kolId of the creator. It matches the kolId you sent.
nick_nameDisplay name of the creator.
followerFollower count of the creator.
cityCity 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_statusReturned 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_authorFlags for creator type: XingTu star author, e-commerce enabled, and game author.
opened_task_categoryList 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_timeUnix timestamps in seconds as strings.

Notes

Pricing

$0.02 per successful call. Failed calls are not charged.

Read a Xingtu creator ID you selected

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.

Give your agent one Xingtu task

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.

Explore more

Related APIs

All APIs
APIPriceResponse
Douyin$0.02 per callJSON
Douyin$0.02 per callJSON
Douyin$0.02 per callJSON
Douyin$0.02 per callJSON
Douyin$0.02 per callJSON
Douyin$0.02 per callJSON

Questions

FAQ

How do I use the Douyin XingTu KOL Profile API?

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.

How much does the Douyin XingTu KOL Profile API cost?

$0.02 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the Douyin XingTu KOL Profile API accept?

Required: kolId (string) and platformChannel (string). The Parameters table and the Playground on this page list every field.

What does the Douyin XingTu KOL Profile API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a Douyin developer account or API key?

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.

Which platformChannel values are documented now?

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.

Do phone, online and missing MCN fields establish availability?

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.

Are these Xingtu requests covered by the general daily free quota?

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.