主播搜索/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
Request
- Base URLhttps://api.tikhub.io (the document declares no server; this is the origin it was published from)
- AuthHTTP bearer
Query parameters
搜索关键词,可为主播昵称、抖音号、星图ID或直播内容词/Search keyword: nickname, Douyin ID, Xingtu ID or live content word
页码/Page number
排序字段,默认score综合排序/Sort field, default score (comprehensive)
排序方式,1=升序,2=降序/Sort type, 1=asc, 2=desc
合作对象/Cooperation target
营销目标/Marketing target
适配行业ID/Industry ID
主题推荐达人清单ID/Featured creator list ID
直播报价类型,固定为9;仅与price_min/price_max配合使用/Live-stream price type, fixed to 9
主播报价下限,提供时必须同时提供price_type/Minimum anchor price
主播报价上限,提供时必须同时提供price_type/Maximum anchor price
达人类型ID,多个用逗号分隔,如1,6/Creator category IDs, comma-separated
达人人设/学历/认证/调性ID。逗号分隔=满足任一;分号分组=每组都要满足,如1129,110401;110213/Persona IDs. Comma=match any, semicolon=group AND
达人性别,1=男,2=女/Creator gender, 1=male, 2=female
粉丝数下限/Minimum followers
粉丝数上限/Maximum followers
预期播放量下限/Minimum expected plays
预期播放量上限/Maximum expected plays
预期CPM下限/Minimum expected CPM
预期CPM上限/Maximum expected CPM
预期CPE下限/Minimum expected CPE
预期CPE上限/Maximum expected CPE
互动率下限,0-1小数,0.02=2%/Minimum interaction rate, 0-1 decimal
互动率上限,0-1小数/Maximum interaction rate, 0-1 decimal
完播率下限,0-1小数/Minimum play-completion rate, 0-1 decimal
完播率上限,0-1小数/Maximum play-completion rate, 0-1 decimal
爆文率下限,0-1小数/Minimum viral-post rate, 0-1 decimal
爆文率上限,0-1小数/Maximum viral-post rate, 0-1 decimal
额外画像筛选的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
Changes
- info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status
- info
- info
endpoint added
- info