Douyin Xingtu Anchor Search
https://api.sandbase.ai/v1/api/douyin/xingtu-v2/search-anchorSearch Douyin Xingtu anchors matching a specific query keyword, with filtering options for audience metrics, follower counts, and engagement rates.
- Price
- $0.0015USD / callFirst 100 calls per day free (shared per organization)
- Method
- POST
- Response
- JSON
- Parameters
- 1 required · 28 optional
Production route
Try the model
Playground
Input
Maximum viral-post rate, 0-1 decimal
Minimum viral-post rate, 0-1 decimal
Maximum expected CPE
Minimum expected CPE
Maximum expected CPM
Minimum expected CPM
Maximum expected plays
Minimum expected plays
Extra profile filters (JSON array) for audience/fans profile, region, etc.
Maximum followers
Minimum followers
Industry ID
Creator gender, 1=male, 2=female
Maximum interaction rate, 0-1 decimal
Minimum interaction rate, 0-1 decimal
Search keyword: nickname, Douyin ID, Xingtu ID or live content word
Marketing target
Page number, default 1
Maximum play-completion rate, 0-1 decimal
Minimum play-completion rate, 0-1 decimal
Maximum creator price
Minimum creator price
Price tier by video length
Sort field, default `score` (comprehensive sort)
Sort type, 1=asc, 2=desc, default 2
Creator category IDs, comma-separated
Cooperation target
OutputExample
[
{
"data": {
"authors": [
{
"attribute_datas": {
"author_avatar_frame_icon": "0",
"author_status": "1",
"author_type": "1",
"avatar_uri": "https://p11.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-0813_oUESIAAA9z5EAqDpfFAgfoOGaylAaEAgCzsJCh.jpeg?from=3782654143",
"city": "杭州",
"core_user_id": "107079995228697",
"expected_play_num": "302",
"fans_increment_rate_within_15d": "-0.0041981528127623844",
"fans_increment_within_15d": "-10",
"follower": "2372",
"gender": "0",
"grade": "0",
"id": "7559507767346610227",
"is_live_game_author": "0",
"is_plan_author": "false",
"is_prefer_author": "false",
"live_median_game_item_component_click_90_days": "0",
"live_median_game_item_cpc_90_days": "0",
"live_room_cnt_30d": "0",
"live_tag_content_v2": "[{\"label\":{\"label_index\":10704,\"label_type\":107,\"name\":\"科技\",\"parent_index\":0,\"level\":1},\"children_label\":[{\"label_index\":1070401,\"label_type\":107,\"name\":\"科技产品\",\"parent_index\":10704,\"level\":2}]}]",
"live_watch_ucnt_30d": "0",
"nick_name": "张冬的人工智能机器人学生",
"order_complete_cnt": "3",
"province": "",
"star_excellent_author": "0",
"star_live_order_cnt": "3",
"tags_relation": "{}"
},
"extra_data": {
"content_query_from_word": "",
"content_query_score": 0,
"debug_info": "",
"recall_from": [
"1_0"
],
"recall_return_infos": {},
"recommend_types": []
},
"items": [],
"star_id": "7559507767346610227",
"task_infos": [
{
"online_status": 1,
"platform_source": 1,
"price_infos": [
{
"end_time": "2145916800",
"platform_source": 1,
"price": 6000,
"price_extra_info": {},
"start_time": "1760798231",
"task_category": 6,
"video_type": 56,
"video_type_status": 1
},
{
"end_time": "2145916800",
"platform_source": 1,
"price": 1000,
"price_extra_info": {},
"start_time": "1760798231",
"task_category": 6,
"video_type": 9,
"video_type_status": 1
}
],
"task_category": 6,
"task_status": 1
}
]
},
{
"attribute_datas": {
"author_avatar_frame_icon": "0",
"author_status": "1",
"author_type": "1",
"avatar_uri": "https://p26.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-0813_90c067a8d6014b3c8f1fecdf38508a79.jpeg?from=3782654143",
"city": "广州",
"core_user_id": "2876766982011597",
"expected_play_num": "396",
"fans_increment_rate_within_15d": "-0.0018281535648994515",
"fans_increment_within_15d": "-1",
"follower": "546",
"gender": "1",
"grade": "0",
"id": "7130165467762671623",
"is_live_game_author": "0",
"is_plan_author": "false",
"is_prefer_author": "false",
"live_median_game_item_component_click_90_days": "0",
"live_median_game_item_cpc_90_days": "0",
"live_room_cnt_30d": "0",
"live_tag_content_v2": "[{\"label\":{\"label_index\":10724,\"label_type\":107,\"name\":\"其他\",\"parent_index\":0,\"level\":1},\"children_label\":[{\"label_index\":1072401,\"label_type\":107,\"name\":\"其他\",\"parent_index\":10724,\"level\":2}]}]",
"live_watch_ucnt_30d": "0",
"nick_name": "人工智能AI绘画阿杨",
"province": "",
"star_excellent_author": "0",
"star_live_order_cnt": "0",
"tags_relation": "{}"
},
"extra_data": {
"content_query_from_word": "",
"content_query_score": 0,
"debug_info": "",
"recall_from": [
"1_0"
],
"recall_return_infos": {},
"recommend_types": []
},
"items": [],
"star_id": "7130165467762671623",
"task_infos": [
{
"online_status": 1,
"platform_source": 1,
"price_infos": [
{
"end_time": "2145916800",
"platform_source": 1,
"price": 1000,
"price_extra_info": {},
"start_time": "1660121076",
"task_category": 6,
"video_type": 9,
"video_type_status": 1
},
{
"end_time": "2145916800",
"platform_source": 1,
"price": 6000,
"price_extra_info": {},
"start_time": "1660121076",
"task_category": 6,
"video_type": 56,
"video_type_status": 1
}
],
"task_category": 6,
"task_status": 1
}
]
},
{
"attribute_datas": {
"acu": "1",
"author_avatar_frame_icon": "0",
"author_status": "1",
"author_type": "3",
"avatar_uri": "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-0813c000-ce_okAR5ewgDIBnxt6ZAeFAQt78UFfZUAJEE9gAB2.jpeg?from=3782654143",
"avg_sale_amount_range": "0",
"city": "赣州市",
"core_user_id": "76294547357",
"ecom_amt_avg_30d": "0",
"ecom_gpm_30days_range": "0",
"ecom_live_days_30d": "0",
"ecom_live_product_num_30d": "0",
"ecom_main_price_30days_range": "0",
"expected_play_num": "41",
"fans_increment_rate_within_15d": "-0.002103049421661409",
"fans_increment_within_15d": "-4",
"follower": "1898",
"gender": "1",
"grade": "0",
"id": "6882718277890473991",
"is_live_game_author": "0",
"is_plan_author": "false",
"is_prefer_author": "false",
"live_avg_watch_duration_30d": "33",
"live_comment_rate_avg_30d": "0.0161",
"live_duration_avg_30d": "3940",
"live_interact_rate_avg_30d": "0.6324",
"live_interaction_rate_medium_30d": "0.03704",
"live_like_rate_avg_30d": "0.0359",
"live_median_game_item_component_click_90_days": "0",
"live_median_game_item_cpc_90_days": "0",
"live_pcu_30d": "11",
"live_room_cnt_30d": "16",
"live_sn_comment_rate_avg_30d": "0.0161",
"live_sn_fans_watch_rate_30d": "0.0375",
"live_sn_follow_ucnt_avg_30d": "0",
"live_sn_like_rate_avg_30d": "0.0359",
"live_sn_watch_cnt_avg_30d": "60",
"live_sn_watch_ucnt_avg_30d": "55",
"live_tag_content_v2": "[{\"label\":{\"label_index\":10717,\"label_type\":107,\"name\":\"教育\",\"parent_index\":0,\"level\":1},\"children_label\":[{\"label_index\":1071702,\"label_type\":107,\"name\":\"职场校园教学\",\"parent_index\":10717,\"level\":2}]}]",
"live_watch_cnt_avg_30d": "60",
"live_watch_ucnt_30d": "0",
"live_watch_ucnt_avg_30d": "55",
"nick_name": "科升起-赣大人工智能产教融合报名服务平台",
"province": "江西省",
"star_excellent_author": "0",
"star_live_order_cnt": "0",
"tags_relation": "{\"\\u6559\\u80b2\": [\"\\u804c\\u573a\\u6821\\u56ed\\u6559\\u5b66\"]}"
},
"extra_data": {
"content_query_from_word": "",
"content_query_score": 0,
"debug_info": "",
"recall_from": [
"1_0"
],
"recall_return_infos": {},
"recommend_types": []
},
"items": [],
"star_id": "6882718277890473991",
"task_infos": [
{
"online_status": 1,
"platform_source": 1,
"price_infos": [
{
"end_time": "2145916800",
"platform_source": 1,
"price": 500,
"price_extra_info": {},
"start_time": "1725273730",
"task_category": 52,
"video_type": 53,
"video_type_status": 1
},
{
"end_time": "2145916800",
"platform_source": 1,
"price": 1000,
"price_extra_info": {},
"start_time": "1725273730",
"task_category": 52,
"video_type": 52,
"video_type_status": 1
}
],
"task_category": 52,
"task_status": 1
},
{
"online_status": 1,
"platform_source": 1,
"price_infos": [
{
"end_time": "2145916800",
"platform_source": 1,
"price": 1700,
"price_extra_info": {},
"start_time": "1725273784",
"task_category": 6,
"video_type": 9,
"video_type_status": 1
},
{
"end_time": "2145916800",
"platform_source": 1,
"price": 10200,
"price_extra_info": {},
"start_time": "1725273784",
"task_category": 6,
"video_type": 56,
"video_type_status": 1
}
],
"task_category": 6,
"task_status": 1
}
]
},
{
"attribute_datas": {
"author_avatar_frame_icon": "0",
"author_status": "1",
"author_type": "1",
"avatar_uri": "https://p11.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-i-0813_67d79083b759481aa0cbf9713d20585d.jpeg?from=3782654143",
"avg_sale_amount_range": "0",
"city": "杭州",
"core_user_id": "61640158928",
"ecom_amt_avg_30d": "0",
"ecom_gpm_30days_range": "0",
"ecom_live_days_30d": "0",
"ecom_live_product_num_30d": "0",
"ecom_main_price_30days_range": "0",
"expected_play_num": "79",
"fans_increment_rate_within_15d": "0",
"fans_increment_within_15d": "0",
"follower": "2318",
"gender": "1",
"grade": "0",
"id": "7009910334597103624",
"is_live_game_author": "0",
"is_plan_author": "false",
"is_prefer_author": "false",
"live_duration_avg_30d": "0",
"live_interaction_rate_medium_30d": "0",
"live_median_game_item_component_click_90_days": "0",
"live_median_game_item_cpc_90_days": "0",
"live_room_cnt_30d": "0",Examples
Select an example to load its inputs and result into the playground.
Model card
Specifications
Pricing
- Base price
- $0.0015 / run
- Daily free calls
- First 100 calls per day free (shared per organization)
Request & response
- Method
- POST
- Request body
- application/json
- Response
- application/json
- Execution
- sync
Parameters
- keyword
- string · required
- author_list_id
- any · optional
- burst_text_rate_max
- any · optional
- burst_text_rate_min
- any · optional
- cpe_max
- any · optional
- cpe_min
- any · optional
- cpm_max
- any · optional
- cpm_min
- any · optional
- expected_play_max
- any · optional
- expected_play_min
- any · optional
- extra_filter
- any · optional
- fans_max
- any · optional
- More
- +17 optional parameters
Access
- Provider
- Douyin
- API
- Platform API
- Base URL
- https://api.sandbase.ai
- Endpoint
- /v1/api/douyin/xingtu-v2/search-anchor
- Authentication
- Bearer API key
API README
Douyin Xingtu Anchor Search API
Query Douyin Xingtu anchors by providing a search term in keyword. Refine results using filters for follower counts, engagement rates, and industry categories.
Use cases
- Find Douyin anchors matching brand campaign requirements.
- Filter potential creators by follower volume and audience engagement metrics.
- Identify relevant talent using specific niche keywords and industry tags.
Request
curl -X POST "https://api.sandbase.ai/v1/api/douyin/xingtu-v2/search-anchor" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword": "人工智能"}'
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
keyword | string | Yes | Search keyword: nickname, Douyin ID, Xingtu ID or live content word |
tag | string | No | Creator category IDs, comma-separated |
page | integer | No | Page number, default 1 |
gender | string | No | Creator gender, 1=male, 2=female |
cpe_max | string | No | Maximum expected CPE |
cpe_min | string | No | Minimum expected CPE |
cpm_max | string | No | Maximum expected CPM |
cpm_min | string | No | Minimum expected CPM |
fans_max | string | No | Maximum followers |
fans_min | string | No | Minimum followers |
price_max | string | No | Maximum creator price |
price_min | string | No | Minimum creator price |
sort_type | integer | No | Sort type, 1=asc, 2=desc, default 2 |
price_type | string | No | Price tier by video length |
sort_field | string | No | Sort field, default score (comprehensive sort) |
extra_filter | string | No | Extra profile filters (JSON array) for audience/fans profile, region, etc. |
persona_tags | string | No | Persona IDs. |
task_category | integer | No | Cooperation target |
author_list_id | string | No | Featured creator list ID |
marketing_target | integer | No | Marketing target |
expected_play_max | string | No | Maximum expected plays |
expected_play_min | string | No | Minimum expected plays |
first_industry_id | string | No | Industry ID |
interact_rate_max | string | No | Maximum interaction rate, 0-1 decimal |
interact_rate_min | string | No | Minimum interaction rate, 0-1 decimal |
play_over_rate_max | string | No | Maximum play-completion rate, 0-1 decimal |
play_over_rate_min | string | No | Minimum play-completion rate, 0-1 decimal |
burst_text_rate_max | string | No | Maximum viral-post rate, 0-1 decimal |
burst_text_rate_min | string | No | Minimum viral-post rate, 0-1 decimal |
Example response
Real response for the request above, trimmed to the main fields. User names and long IDs are masked.
{
"authors": [
{
"star_id": "7481538995130728485",
"attribute_datas": {
"author_status": "1",
"author_type": "1",
"core_user_id": "1379225338382761",
"fans_increment_rate_within_15d": "-0.027777777777777776",
"id": "7481538995130728485",
"nick_name": "<user>"
}
}
]
}
Notes
- Set
genderto 1 for male or 2 for female creators. - Use
sort_typewith 1 for ascending order and 2 for descending order (default 2). - Filter results using
pagefor pagination, which defaults to 1.
Related APIs
- Douyin Xingtu Author Audience Distribution: Returns audience profile distribution metrics for a specified Xingtu creator based on creator ID and link type, with selectable platform source and channel opt…
- Douyin Xingtu Author Base Info: Returns basic creator profile data from Douyin Xingtu by author identifier, with options to include recommendation details and linkage information.
- Douyin Xingtu Author Business Card Info: Returns business card details for a Douyin Xingtu creator based on the specified author ID.
Start building
Send your first request
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-v2/search-anchor" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"page": 1,
"keyword": "人工智能",
"sort_type": 2,
"sort_field": "score",
"task_category": 6,
"marketing_target": 3
}
SANDBASE_JSON
)
printf '%s\n' "$result"Explore more
Related APIs
| API | Price | Response | Released |
|---|---|---|---|
Douyin Xingtu Anchor SearchThis API Douyin | $0.0015 per call | JSON | Jul 31, 2026 |
Douyin | $0.003 per call | JSON | Jul 31, 2026 |
Douyin | $0.0015 per call | JSON | Jul 31, 2026 |
Douyin | $0.0015 per call | JSON | Jul 31, 2026 |
Douyin | $0.0015 per call | JSON | Jul 31, 2026 |
Douyin | $0.003 per call | JSON | Jul 31, 2026 |
Questions
FAQ
How do I use the Douyin Xingtu Anchor Search API?
Send a POST request to https://api.sandbase.ai/v1/api/douyin/xingtu-v2/search-anchor 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 Anchor Search API cost?
$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.
What parameters does the Douyin Xingtu Anchor Search API accept?
Required: keyword (string). Optional: author_list_id (any), burst_text_rate_max (any), burst_text_rate_min (any), cpe_max (any), cpe_min (any) and cpm_max (any) and 22 more. The Parameters table and the Playground on this page list every field.
What does the Douyin Xingtu Anchor Search 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 Anchor Search 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.