Douyin Xingtu Search Anchor
## Purpose Search for Douyin live-stream anchors by nickname, Douyin ID, Xingtu ID, or a live-content keyword, then narrow the results for creator discovery and cooperation planning. ## Inputs - **Required:** `keyword` (string). - **Paging and sorting:** `page` defaults to `1`; `sort_field` defaults to `score` (overall ranking); `sort_type` is `1` for ascending or `2` for descending, with `2` as the default. - **Cooperation:** `task_category` (default `6`), `marketing_target` (default `3`), `first_industry_id`, and `author_list_id` (featured creator list ID). - **Creator fit:** `tag` accepts comma-separated category IDs. `persona_tags` accepts persona, education, certification, or style IDs: commas mean match any, while semicolon-separated groups must all match. `gender` is `1` for male or `2` for female; `fans_min` and `fans_max` set follower bounds. - **Live-stream quotes:** `price_min` and `price_max` are nonnegative integers. If either is provided, also supply `price_type=9`. These parameters filter anchor quotes, not the cost of using this tool. - **Performance:** optional minimum/maximum pairs for `expected_play`, `cpm`, `cpe`, `interact_rate`, `play_over_rate`, and `burst_text_rate` filter expected plays, expected CPM/CPE, interaction rate, completion rate, and viral-post rate. Rate values are decimals from `0` to `1`; `0.02` means 2%. - **Audience/profile criteria:** `extra_filter` is a JSON-array **string**, not a native array. Each item must contain non-empty string values for `field_name` and `field_value`; `rel_id` is optional. Use documented field names, category IDs, and encoded values rather than free-form labels. For example, the string `[{"field_name":"watcher_gender_female_rate_v2__ge","field_value":"0.6"}]` expresses a documented female audience share threshold. ## Results Returns search response data for matching anchors. Documented information includes anchor details, live-stream quotes, ACU/PCU (average/peak concurrent viewers), and average viewers per session, when available. The result data has no fixed detailed schema and may be null; individual metrics are not guaranteed. This tool discovers anchors; it does not book cooperation or play live streams. ## Example `{"keyword":"游戏","page":1,"gender":2,"fans_min":10000}` searches using the gaming keyword with female-creator and minimum-follower filters.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call 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 |
|---|---|---|---|---|
tag | string | null | No | 达人类型ID,多个用逗号分隔,如`1,6`/Creator category IDs, comma-separated | — |
page | integer | No | 页码/Page number | 1 |
gender | integer | null | No | 达人性别,1=男,2=女/Creator gender, 1=male, 2=female | — |
cpe_max | number | null | No | 预期CPE上限/Maximum expected CPE | — |
cpe_min | number | null | No | 预期CPE下限/Minimum expected CPE | — |
cpm_max | number | null | No | 预期CPM上限/Maximum expected CPM | — |
cpm_min | number | null | No | 预期CPM下限/Minimum expected CPM | — |
keyword | string | Yes | 搜索关键词,可为主播昵称、抖音号、星图ID或直播内容词/Search keyword: nickname, Douyin ID, Xingtu ID or live content word | — |
fans_max | integer | null | No | 粉丝数上限/Maximum followers | — |
fans_min | integer | null | No | 粉丝数下限/Minimum followers | — |
price_max | integer | null | No | 主播报价上限,提供时必须同时提供price_type/Maximum anchor price | — |
price_min | integer | null | No | 主播报价下限,提供时必须同时提供price_type/Minimum anchor price | — |
sort_type | integer | No | 排序方式,1=升序,2=降序/Sort type, 1=asc, 2=desc | 2 |
price_type | unknown | null | No | 直播报价类型,固定为9;仅与price_min/price_max配合使用/Live-stream price type, fixed to 9 | — |
sort_field | string | No | 排序字段,默认score综合排序/Sort field, default score (comprehensive) | score |
extra_filter | string | null | No | 额外画像筛选的JSON数组字符串,每项必须包含非空字符串field_name和field_value;支持内容主题、观众/粉丝画像、八大人群和地域等维度/Extra profile filters as a JSON-array string; field_name and field_value must be non-empty strings | — |
persona_tags | string | null | No | 达人人设/学历/认证/调性ID。逗号分隔=满足任一;分号分组=每组都要满足,如`1129,110401;110213`/Persona IDs. Comma=match any, semicolon=group AND | — |
task_category | integer | No | 合作对象/Cooperation target | 6 |
author_list_id | string | null | No | 主题推荐达人清单ID/Featured creator list ID | — |
marketing_target | integer | No | 营销目标/Marketing target | 3 |
expected_play_max | integer | null | No | 预期播放量上限/Maximum expected plays | — |
expected_play_min | integer | null | No | 预期播放量下限/Minimum expected plays | — |
first_industry_id | integer | null | No | 适配行业ID/Industry ID | — |
interact_rate_max | number | null | No | 互动率上限,0-1小数/Maximum interaction rate, 0-1 decimal | — |
interact_rate_min | number | null | No | 互动率下限,0-1小数,0.02=2%/Minimum interaction rate, 0-1 decimal | — |
play_over_rate_max | number | null | No | 完播率上限,0-1小数/Maximum play-completion rate, 0-1 decimal | — |
play_over_rate_min | number | null | No | 完播率下限,0-1小数/Minimum play-completion rate, 0-1 decimal | — |
burst_text_rate_max | number | null | No | 爆文率上限,0-1小数/Maximum viral-post rate, 0-1 decimal | — |
burst_text_rate_min | number | null | No | 爆文率下限,0-1小数/Minimum viral-post rate, 0-1 decimal | — |
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_search_anchor' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"keyword": "姜小菟🥕"
}
}'{
"code": 200,
"data": {
"authors": [
{
"attribute_datas": {
"acu": "123",
"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_9fbf8734031649a8a455539399e51192.jpeg?from=3782654143",
"avg_sale_amount_range": "0"
},
"extra_data": {
"assign_live_restrict_tip": "当前账号暂无法向该达人发起任务",
"assign_live_restricted": true,
"content_query_score": 0,
"recall_from": [
"1_0"
]
},
"star_id": "7275583335542292536",
"task_infos": [
{
"online_status": 1,
"platform_source": 1,
"price_infos": [],
"task_category": 6,
"task_status": 1
}
]
}
]
},
"docs": "https://api.tikhub.io/#/Douyin-Xingtu-V2-API/search_anchor_api_v1_douyin_xingtu_v2_search_anchor_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "7e01ae13-6b0b-43f8-89db-bca09fa6a996"
}This example shows part of the response. Copied content is valid JSON.

