Douyin Xingtu Search Anchor

2.07 credits/call
ae_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.

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
tagstring | nullNo达人类型ID,多个用逗号分隔,如`1,6`/Creator category IDs, comma-separated—
pageintegerNo页码/Page number1
genderinteger | nullNo达人性别,1=男,2=女/Creator gender, 1=male, 2=female—
cpe_maxnumber | nullNo预期CPE上限/Maximum expected CPE—
cpe_minnumber | nullNo预期CPE下限/Minimum expected CPE—
cpm_maxnumber | nullNo预期CPM上限/Maximum expected CPM—
cpm_minnumber | nullNo预期CPM下限/Minimum expected CPM—
keywordstringYes搜索关键词,可为主播昵称、抖音号、星图ID或直播内容词/Search keyword: nickname, Douyin ID, Xingtu ID or live content word—
fans_maxinteger | nullNo粉丝数上限/Maximum followers—
fans_mininteger | nullNo粉丝数下限/Minimum followers—
price_maxinteger | nullNo主播报价上限,提供时必须同时提供price_type/Maximum anchor price—
price_mininteger | nullNo主播报价下限,提供时必须同时提供price_type/Minimum anchor price—
sort_typeintegerNo排序方式,1=升序,2=降序/Sort type, 1=asc, 2=desc2
price_typeunknown | nullNo直播报价类型,固定为9;仅与price_min/price_max配合使用/Live-stream price type, fixed to 9—
sort_fieldstringNo排序字段,默认score综合排序/Sort field, default score (comprehensive)score
extra_filterstring | nullNo额外画像筛选的JSON数组字符串,每项必须包含非空字符串field_name和field_value;支持内容主题、观众/粉丝画像、八大人群和地域等维度/Extra profile filters as a JSON-array string; field_name and field_value must be non-empty strings—
persona_tagsstring | nullNo达人人设/学历/认证/调性ID。逗号分隔=满足任一;分号分组=每组都要满足,如`1129,110401;110213`/Persona IDs. Comma=match any, semicolon=group AND—
task_categoryintegerNo合作对象/Cooperation target6
author_list_idstring | nullNo主题推荐达人清单ID/Featured creator list ID—
marketing_targetintegerNo营销目标/Marketing target3
expected_play_maxinteger | nullNo预期播放量上限/Maximum expected plays—
expected_play_mininteger | nullNo预期播放量下限/Minimum expected plays—
first_industry_idinteger | nullNo适配行业ID/Industry ID—
interact_rate_maxnumber | nullNo互动率上限,0-1小数/Maximum interaction rate, 0-1 decimal—
interact_rate_minnumber | nullNo互动率下限,0-1小数,0.02=2%/Minimum interaction rate, 0-1 decimal—
play_over_rate_maxnumber | nullNo完播率上限,0-1小数/Maximum play-completion rate, 0-1 decimal—
play_over_rate_minnumber | nullNo完播率下限,0-1小数/Minimum play-completion rate, 0-1 decimal—
burst_text_rate_maxnumber | nullNo爆文率上限,0-1小数/Maximum viral-post rate, 0-1 decimal—
burst_text_rate_minnumber | nullNo爆文率下限,0-1小数/Minimum viral-post rate, 0-1 decimal—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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": "姜小菟🥕"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.