Start building

Douyin Xingtu KOL Search (V2)

https://api.sandbase.ai/v1/api/douyin/xingtu/search-kol-v2

Searches Douyin Xingtu creators by keyword, content tags, and follower count ranges. Returns creator identifiers, task rate tiers, and qualification levels.

Try this APIGet API key
Price
$0.03USD / call
Method
POST
Response
JSON
Parameters
1 required · 2 optional
Production route

Try the model

Playground

Open playground
Input
Content tag (optional), for example tag-1 or tag_level_two-7.
Follower range (optional), for example 10-100 means 100,000 to 1,000,000 followers.
Keyword
OutputExample
Responseoutputs · 11.6 KB · 187 lines
[
  {
    "data": {
      "authors": [
        {
          "attribute_datas": {
            "author_avatar_frame_icon": "0",
            "author_ecom_level": "L0",
            "author_level_game": "Lv1",
            "author_level_other": "Lv1",
            "author_status": "1",
            "author_thin_mid_word_association_index": "{}",
            "author_type": "1",
            "avatar_uri": "https://p11.douyinpic.com/aweme/1080x1080/aweme-avatar/mosaic-legacy_2d0e800009edddfb02478.jpeg?from=3782654143",
            "brand_boost_vv": "0",
            "city": "",
            "core_user_id": "88710789301",
            "e_commerce_enable": "0",
            "ecom_video_product_num_30d": "0",
            "fans_increment_rate_within_15d": "-0.0014854426619132501",
            "fans_increment_within_30d": "-204",
            "follower": "63858",
            "game_type": "",
            "gender": "1",
            "grade": "0",
            "id": "6629665048593694723",
            "is_black_horse_author": "false",
            "is_cocreate_author": "false",
            "is_cpm_project_author": "0",
            "is_excellenct_author": "0",
            "is_short_drama": "0",
            "is_superstar": "False",
            "last_10_items": "[{\"comment_cnt\":\"6\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1567177957\",\"item_id\":\"6730973253587848455\",\"item_publish_time\":\"1567177957\",\"item_title\":\" #tabata \",\"like_cnt\":\"87\",\"share_cnt\":\"5\",\"vv\":\"5752\"},{\"comment_cnt\":\"1\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1566745326\",\"item_id\":\"6729119672081403149\",\"item_publish_time\":\"1566745326\",\"item_title\":\"和我一起全身燃脂吧！ #tabata  #燃脂 \",\"like_cnt\":\"155\",\"share_cnt\":\"20\",\"vv\":\"7839\"},{\"comment_cnt\":\"8\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1566464646\",\"item_id\":\"6727914181279960328\",\"item_publish_time\":\"1566464646\",\"item_title\":\"4分钟Tabata训练，腰腹燃脂第一弹！！走起 #tabata🔥🔥🔥 \",\"like_cnt\":\"353\",\"share_cnt\":\"48\",\"vv\":\"18243\"},{\"comment_cnt\":\"2\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1555495955\",\"item_id\":\"6680495917319146755\",\"item_publish_time\":\"1555495955\",\"item_title\":\"姑娘，不减掉一个颓废的自己，怎么成就以后完美的你\",\"like_cnt\":\"54\",\"share_cnt\":\"1\",\"vv\":\"6766\"},{\"comment_cnt\":\"52\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1550664095\",\"item_id\":\"6659713019192331534\",\"item_publish_time\":\"1550664095\",\"item_title\":\"#健身 只要心中有爱，没有完不成的减肥。❤️\",\"like_cnt\":\"717\",\"share_cnt\":\"5\",\"vv\":\"87996\"},{\"comment_cnt\":\"12\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1544369935\",\"item_id\":\"6633018362387500301\",\"item_publish_time\":\"1544369935\",\"item_title\":\"听说发第二遍会🔥🔥🔥\",\"like_cnt\":\"283\",\"share_cnt\":\"5\",\"vv\":\"29890\"},{\"comment_cnt\":\"17\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1543904877\",\"item_id\":\"6631020955026066692\",\"item_publish_time\":\"1543904877\",\"item_title\":\"关于【健身】你想知道的一切，来私信就可以找到我哦！#健身\",\"like_cnt\":\"179\",\"share_cnt\":\"7\",\"vv\":\"24228\"},{\"comment_cnt\":\"2\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1542935151\",\"item_id\":\"6626856014236880142\",\"item_publish_time\":\"1542935151\",\"item_title\":\"#健身 不是所有人都可以练到这样的背，但努力和毅力终究会达成目标。你觉得呢？\",\"like_cnt\":\"129\",\"share_cnt\":\"0\",\"vv\":\"18310\"},{\"comment_cnt\":\"4\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1540435612\",\"item_id\":\"6616120570511625486\",\"item_publish_time\":\"1540435612\",\"item_title\":\"#健身健身健身健身 你没有日复一日的苦苦坚持，又怎样能收获闪光灯下发亮出彩的自己？\",\"like_cnt\":\"74\",\"share_cnt\":\"2\",\"vv\":\"13335\"},{\"comment_cnt\":\"4\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1538899069\",\"item_id\":\"6609521172470041859\",\"item_publish_time\":\"1538899069\",\"item_title\":\"今天教大家训练手臂💪不要小看简单的动作，要认真观察肌肉发力的感觉和技巧。#哈尔滨\",\"like_cnt\":\"97\",\"share_cnt\":\"4\",\"vv\":\"17646\"}]",
            "link_convert_index": "0",
            "link_convert_index_by_industry": "0",
            "link_recommend_index_by_industry": "15.52",
            "link_shopping_index": "15.52",
            "link_spread_index": "11.96",
            "link_spread_index_by_industry": "11.96",
            "link_star_index": "13.04",
            "link_star_index_by_industry": "13.04",
            "local_lower_threshold_author": "false",
            "nick_name": "帅杨Example一起健身",
            "province": "",
            "star_excellent_author": "0",
            "star_index": "55.67570014308106",
            "star_qianchuan_high_potential": "0",
            "star_whispers_author": "1",
            "tags_relation": "{\"运动健身\":[\"健身\"]}"
          },
          "extra_data": {
            "content_query_from_word": "",
            "content_query_score": 0,
            "debug_info": "",
            "demander_behavior": {
              "added_author_list": false,
              "cooperated": false,
              "viewd_author_page": false
            },
            "recall_from": [
              "1_0"
            ],
            "recall_return_infos": {},
            "recommend_types": []
          },
          "items": [],
          "star_id": "6629665048593694723",
          "task_infos": [
            {
              "online_status": 1,
              "platform_source": 1,
              "price_infos": [
                {
                  "platform_source": 1,
                  "price": 0,
                  "task_category": 1,
                  "video_type": 2,
                  "video_type_status": 1
                },
                {
                  "platform_source": 1,
                  "price": 0,
                  "task_category": 1,
                  "video_type": 1,
                  "video_type_status": 1
                }
              ],
              "task_category": 1,
              "task_status": 1
            }
          ]
        },
        {
          "attribute_datas": {
            "author_avatar_frame_icon": "0",
            "author_level_game": "Lv1",
            "author_level_other": "Lv1",
            "author_status": "1",
            "author_thin_mid_word_association_index": "{}",
            "author_type": "1",
            "avatar_uri": "https://p11.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_3195f9529f01f34ea7058723e807fa67.jpeg?from=3782654143",
            "brand_boost_vv": "0",
            "city": "",
            "core_user_id": "3087037663548348",
            "e_commerce_enable": "0",
            "expected_natural_play_num": "834",
            "expected_play_num": "909",
            "fans_increment_rate_within_15d": "-0.0018808777429467085",
            "fans_increment_within_30d": "-48",
            "follower": "11148",
            "game_type": "{\"\\u4f11\\u95f2\": 1.0}",
            "gender": "2",
            "grade": "0",
            "id": "6870170846707580941",
            "is_black_horse_author": "false",
            "is_cocreate_author": "false",
            "is_cpm_project_author": "0",
            "is_excellenct_author": "0",
            "is_superstar": "False",
            "last_10_items": "[{\"comment_cnt\":\"1\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1759814489\",\"item_id\":\"7558345659175308563\",\"item_publish_time\":\"1759828800\",\"item_title\":\"思念#李现##李现warm小屋 @抖音小助手\",\"like_cnt\":\"92\",\"share_cnt\":\"1\",\"vv\":\"857\"},{\"comment_cnt\":\"0\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1756444443\",\"item_id\":\"7543871429494738195\",\"item_publish_time\":\"1756459800\",\"item_title\":\"直到我在他乡远地也见到了。七夕快乐#李现 #李现warm小屋 #七夕快乐永远幸福 @抖音小助手\",\"like_cnt\":\"84\",\"share_cnt\":\"0\",\"vv\":\"1156\"},{\"comment_cnt\":\"5\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1752126130\",\"item_id\":\"7525324408304913718\",\"item_publish_time\":\"1752126130\",\"item_title\":\"我们的第二次#锦绣芳华 #李现warm小屋 @抖音小助手\",\"like_cnt\":\"154\",\"share_cnt\":\"2\",\"vv\":\"2616\"},{\"comment_cnt\":\"2\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1751806939\",\"item_id\":\"7523953504387583295\",\"item_publish_time\":\"1751806939\",\"item_title\":\"第n天#李现 #李现warm小屋 @抖音小助手\",\"like_cnt\":\"109\",\"share_cnt\":\"1\",\"vv\":\"488\"},{\"comment_cnt\":\"3\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1750566685\",\"item_id\":\"7518626655422713099\",\"item_publish_time\":\"1750584600\",\"item_title\":\"又何尝不是呢#李现 #李现warm小屋 @抖音小助手\",\"like_cnt\":\"224\",\"share_cnt\":\"1\",\"vv\":\"1932\"},{\"comment_cnt\":\"3\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1748692685\",\"item_id\":\"7510577838853950731\",\"item_publish_time\":\"1748692685\",\"item_title\":\"向前走，不会在意时间走多快#李现 #李现warm小屋 @抖音小助手\",\"like_cnt\":\"177\",\"share_cnt\":\"4\",\"vv\":\"2619\"},{\"comment_cnt\":\"0\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1746369791\",\"item_id\":\"7500601052460191027\",\"item_publish_time\":\"1746437400\",\"item_title\":\"使我不能摆脱#李现 #李现warm小屋 @抖音小助手\",\"like_cnt\":\"226\",\"share_cnt\":\"1\",\"vv\":\"2444\"},{\"comment_cnt\":\"4\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1745117416\",\"item_id\":\"7495222144452840714\",\"item_publish_time\":\"1745141400\",\"item_title\":\"Look here#李现 #李现warm小屋 @抖音小助手\",\"like_cnt\":\"525\",\"share_cnt\":\"14\",\"vv\":\"9017\"},{\"comment_cnt\":\"0\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1743305477\",\"item_id\":\"7487439925072104731\",\"item_publish_time\":\"1743327000\",\"item_title\":\"我们的相约#李现 #李现warm小屋 @抖音小助手\",\"like_cnt\":\"126\",\"share_cnt\":\"1\",\"vv\":\"977\"},{\"comment_cnt\":\"0\",\"is_high_quality_item\":\"0\",\"item_create_time\":\"1742703398\",\"item_id\":\"7484854016870993162\",\"item_publish_time\":\"1742722200\",\"item_title\":\"祝我梦到有你的梦#李现 #李现warm小屋 @抖音小助手\",\"like_cnt\":\"61\",\"share_cnt\":\"1\",\"vv\":\"774\"}]",
            "link_convert_index": "0",
            "link_convert_index_by_industry": "0",
            "link_recommend_index_by_industry": "19.59",
            "link_shopping_index": "19.59",
            "link_spread_index": "15.16",
            "link_spread_index_by_industry": "15.16",
            "link_star_index": "13.08",
            "link_star_index_by_industry": "13.08",
            "local_lower_threshold_author": "false",
            "nick_name": "Example.X💭",
            "pic_expected_play_num": "909",
            "promotion_prospective_vv": "627",
            "province": "",
            "sn_expected_play_num": "909",
            "star_excellent_author": "0",
            "star_qianchuan_high_potential": "0",
            "star_whispers_author": "1",
            "tags_relation": "{\"影视娱乐\":[\"综艺混剪\"]}"
          },
          "extra_data": {
            "content_query_from_word": "",
            "content_query_score": 0,
            "debug_info": "",
            "demander_behavior": {
              "added_author_list": false,
              "cooperated": false,
              "viewd_author_page": false
            },
            "recall_from": [
              "1_0"
            ],
            "recall_return_infos": {},
            "recommend_types": []
          },
          "items": [
            {
              "item_id": "7558345659175308563",
              "video_tag": 3,
              "vv": 707
            }
          ],
          "star_id": "6870170846707580941",
          "task_infos": []
        }
      ],
      "base_resp": {
        "status_code": 0,
        "status_message": ""
      },
      "extra_data": {
        "intent_score": 0.3005458116531372,
        "is_cpm_project_search": false,
        "is_intent_consistent": true,
        "search_author_count": 0,
        "search_item_count": 0,
        "search_session_id": "7676047448942673974",
        "speaker_live_base_dis": []
      },
      "pagination": {
        "has_more": false,
        "limit": 20,
        "page": 1,
        "total_count": 2
      }
    }
  }
]

Examples

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

Model card

Specifications

Pricing

Base price
$0.03 / run

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

keyword
string · required
contentTag
string · optional
followerRange
string · optional

Access

Provider
Douyin
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/douyin/xingtu/search-kol-v2
Authentication
Bearer API key

API README

Douyin Xingtu KOL Search (V2) API

Query Douyin Xingtu creator profiles by specifying a keyword alongside optional content tags and follower thresholds.

Use cases

  • Discover Douyin creators matching specific niche topics or keywords.
  • Filter potential influencer partnerships by audience size brackets.
  • Evaluate creator task tier assignments and performance levels.

Request

curl -X POST "https://api.sandbase.ai/v1/api/douyin/xingtu/search-kol-v2" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "人工智能"}'

Parameters

NameTypeRequiredDescription
keywordstringYesKeyword
contentTagstringNoContent tag (optional), for example tag-1 or tag_level_two-7.
followerRangestringNoFollower range (optional), for example 10-100 means 100,000 to 1,000,000 followers.

Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

{
  "authors": [
    {
      "star_id": "6669294384883695629",
      "attribute_datas": {
        "assign_cpm_suggest_price": "105",
        "assign_task_price_list": "[97500,150000,172000]",
        "author_ecom_level": "L0",
        "author_level_game": "Lv1",
        "author_level_other": "Lv1",
        "author_status": "1"
      }
    }
  ]
}

Notes

  • Format followerRange as min-max values in tens of thousands, such as 10-100 for 100,000 to 1,000,000 followers.
  • Supply contentTag values using category identifiers like tag-1 or tag_level_two-7.

Related APIs

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/douyin/xingtu/search-kol-v2
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# 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/search-kol-v2" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "keyword": "example"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
Douyin Xingtu KOL Search (V2)This API
Douyin		$0.03 per callJSONJul 31, 2026
Douyin Xingtu Author Hot Comment Keywords
Douyin		$0.03 per callJSONJul 31, 2026
Douyin Xingtu Author Hot Comment Tokens (Xingtu)
Douyin		$0.03 per callJSONJul 31, 2026
Douyin Xingtu KOL Audience Portrait (V1)
Douyin		$0.03 per callJSONJul 31, 2026
Douyin XingTu KOL Profile
Douyin		$0.03 per callJSONJul 31, 2026
Douyin Xingtu KOL Conversion Video Display
Douyin		$0.03 per callJSONJul 31, 2026

Questions

FAQ

How do I use the Douyin Xingtu KOL Search (V2) API?

Send a POST request to https://api.sandbase.ai/v1/api/douyin/xingtu/search-kol-v2 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 Search (V2) API cost?

$0.03 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 Search (V2) API accept?

Required: keyword (string). Optional: contentTag (string) and followerRange (string). The Parameters table and the Playground on this page list every field.

What does the Douyin Xingtu KOL Search (V2) 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 Search (V2) 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.