Douyin-Xingtu-V2-API

主播搜索/Search Anchor

Changed on

[中文]

用途:

  • 主播搜索(抖音直播广场),按关键词搜索抖音直播主播,支持完整筛选条件
  • 价格:0.002$ / 次

参数:

  • keyword: 搜索关键词,可为主播昵称、抖音号、星图ID或直播内容词
  • page: 页码,默认1
  • sort_field: 排序字段,默认score综合排序
  • sort_type: 排序方式,1=升序,2=降序,默认2
  • 合作诉求: task_category 合作对象、marketing_target 营销目标、first_industry_id 适配行业
  • 匹配度: tag 达人类型、persona_tags 达人人设/学历/认证/调性、gender 性别、fans_min/fans_max 粉丝数
  • 性价比: expected_play_min/expected_play_max 预期播放量、 cpm_min/cpm_max 预期CPM、cpe_min/cpe_max 预期CPE、interact_rate_min/interact_rate_max 互动率、 play_over_rate_min/play_over_rate_max 完播率、burst_text_rate_min/burst_text_rate_max 爆文率
  • 报价: price_type 固定为 9(直播报价);price_min/price_max 为主播报价区间, 提供任一边界时必须同时提供 price_type
  • 主题推荐: author_list_id 达人清单ID
  • 画像筛选 extra_filter: 观众/粉丝画像、受众画像、所在地域、连接用户数等维度靠它筛选。 传 JSON 数组字符串,每个元素形如 {"field_name":"字段名","field_value":"值"}(可选 rel_id), 常用字段:
    • 观众性别: watcher_gender_female_rate_v2__ge(女性占比阈值,取值 0.5/0.6/0.7/0.8), 男性用 watcher_gender_male_rate_v2__ge
    • 观众年龄: watcher_age_most_new(观众年龄居多,值为编码数组,如 [22]=24-30岁居多) 示例: extra_filter=[{"field_name":"watcher_gender_female_rate_v2__ge","field_value":"0.5"}]
  • 说明: tag/persona_tags 的可选ID可通过get_author_market_fields获取;动态画像字段和编码 可通过get_search_field_options获取;比率类参数为0-1小数(0.02=2%)

返回:

  • 主播搜索结果数据(含主播信息、直播报价、ACU/PCU、场均观看等)

[English]

Purpose:

  • Search Douyin live-stream anchors in the live marketplace by keyword, with full filtering
  • Price: 0.002$ / time

Parameters:

  • keyword: Search keyword: nickname, Douyin ID, Xingtu ID or live content word
  • page: Page number, default 1
  • sort_field: Sort field, default score (comprehensive sort)
  • sort_type: Sort type, 1=asc, 2=desc, default 2
  • Cooperation: task_category, marketing_target, first_industry_id
  • Match: tag (category), persona_tags, gender, fans_min/fans_max
  • Cost-performance: expected_play_min/max, cpm_min/max, cpe_min/max, interact_rate_min/max, play_over_rate_min/max, burst_text_rate_min/max
  • Price: price_type is fixed to 9 for live-stream pricing; price_min/price_max define the anchor-price range and require price_type when either bound is supplied
  • Featured: author_list_id
  • Profile filters extra_filter: for audience/fans profile, region, connected-users, etc. Pass a JSON-array string; each element is {"field_name":"...","field_value":"..."} (optional rel_id), Common fields:
    • Audience gender: watcher_gender_female_rate_v2__ge (female-ratio threshold 0.5/0.6/0.7/0.8), male uses watcher_gender_male_rate_v2__ge
    • Audience age: watcher_age_most_new (dominant audience age, encoded array, e.g. [22]=24-30) Example: extra_filter=[{"field_name":"watcher_gender_female_rate_v2__ge","field_value":"0.5"}]
  • Note: valid IDs for tag/persona_tags come from get_author_market_fields; dynamic profile fields and codes come from get_search_field_options; rate params are 0-1 decimals (0.02=2%)

Return:

  • Anchor search result data (anchor info, live price, ACU/PCU, avg viewers, etc.)

[示例/Example]

keyword = "游戏" page = 1 gender = 2 fans_min = 10000

get/api/v1/douyin/xingtu_v2/search_anchor

Request

  • Base URL
    https://api.tikhub.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Query parameters

keywordstring required

搜索关键词,可为主播昵称、抖音号、星图ID或直播内容词/Search keyword: nickname, Douyin ID, Xingtu ID or live content word

pageinteger

页码/Page number

sort_fieldstring

排序字段,默认score综合排序/Sort field, default score (comprehensive)

sort_typeinteger

排序方式,1=升序,2=降序/Sort type, 1=asc, 2=desc

task_categoryinteger

合作对象/Cooperation target

marketing_targetinteger

营销目标/Marketing target

first_industry_idinteger nullable

适配行业ID/Industry ID

author_list_idstring nullable

主题推荐达人清单ID/Featured creator list ID

price_type9

直播报价类型,固定为9;仅与price_min/price_max配合使用/Live-stream price type, fixed to 9

price_mininteger nullable

主播报价下限,提供时必须同时提供price_type/Minimum anchor price

price_maxinteger nullable

主播报价上限,提供时必须同时提供price_type/Maximum anchor price

tagstring nullable

达人类型ID,多个用逗号分隔,如1,6/Creator category IDs, comma-separated

persona_tagsstring nullable

达人人设/学历/认证/调性ID。逗号分隔=满足任一;分号分组=每组都要满足,如1129,110401;110213/Persona IDs. Comma=match any, semicolon=group AND

genderinteger nullable

达人性别,1=男,2=女/Creator gender, 1=male, 2=female

fans_mininteger nullable

粉丝数下限/Minimum followers

fans_maxinteger nullable

粉丝数上限/Maximum followers

expected_play_mininteger nullable

预期播放量下限/Minimum expected plays

expected_play_maxinteger nullable

预期播放量上限/Maximum expected plays

cpm_minnumber nullable

预期CPM下限/Minimum expected CPM

cpm_maxnumber nullable

预期CPM上限/Maximum expected CPM

cpe_minnumber nullable

预期CPE下限/Minimum expected CPE

cpe_maxnumber nullable

预期CPE上限/Maximum expected CPE

interact_rate_minnumber nullable

互动率下限,0-1小数,0.02=2%/Minimum interaction rate, 0-1 decimal

interact_rate_maxnumber nullable

互动率上限,0-1小数/Maximum interaction rate, 0-1 decimal

play_over_rate_minnumber nullable

完播率下限,0-1小数/Minimum play-completion rate, 0-1 decimal

play_over_rate_maxnumber nullable

完播率上限,0-1小数/Maximum play-completion rate, 0-1 decimal

burst_text_rate_minnumber nullable

爆文率下限,0-1小数/Minimum viral-post rate, 0-1 decimal

burst_text_rate_maxnumber nullable

爆文率上限,0-1小数/Maximum viral-post rate, 0-1 decimal

extra_filterstring nullable

额外画像筛选的JSON数组字符串,每项必须包含非空字符串field_name和field_value;支持内容主题、观众/粉丝画像、八大人群和地域等维度/Extra profile filters as a JSON-array string; field_name and field_value must be non-empty strings

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

Response message (EN-US) | 响应消息 (English)

message_zhstring

Response message (ZH-CN) | 响应消息 (中文)

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

The timezone of the response time | 响应时间的时区

docsstring nullable

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

Cache message (ZH-CN) | 缓存消息 (中文)

cache_urlstring nullable

The URL to access the cached result | 访问缓存结果的 URL

routerstring

The endpoint that generated this response | 生成此响应的端点

paramsunknown
dataunknown

Changes