达人搜索/Search Creator

[中文]

用途:

• 达人搜索(抖音短视频达人广场)，按关键词搜索抖音短视频达人，支持完整筛选条件
• 价格：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 粉丝数
• 性价比: price_type/price_min/price_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 爆文率
• 主题推荐: 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岁居多) 其它维度(粉丝画像/受众画像/所在地域/连接用户数)的 field_name 与取值，可在达人广场 选中对应筛选后，从其搜索请求(search_for_author_square)的 attribute_filter 中获取。 示例: extra_filter=[{"field_name":"watcher_gender_female_rate_v2__ge","field_value":"0.5"}]
• 说明: tag/persona_tags 的可选ID可通过get_author_market_fields接口获取；比率类参数为0-1小数(0.02=2%)

返回:

• 达人搜索结果数据（含达人信息、报价、粉丝数、预期播放量等）

[English]

Purpose:

• Search Douyin short-video creators in the creator marketplace by keyword, with full filtering
• Price: 0.002$ / time

Parameters:

• keyword: Search keyword: nickname, Douyin ID, Xingtu ID or 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: price_type/price_min/price_max, expected_play_min/max, cpm_min/max, cpe_min/max, interact_rate_min/max, play_over_rate_min/max, burst_text_rate_min/max
• 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), appended as-is to the upstream filter. Verified 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) For other dimensions (fans profile / region / connected-users), obtain the field_name & value from the attribute_filter of the search_for_author_square request after selecting that filter in the creator marketplace. 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; rate params are 0-1 decimals (0.02=2%)

Return:

• Creator search result data (creator info, price, followers, expected plays, etc.)

[示例/Example]

keyword = "健身" page = 1 gender = 2 fans_min = 10000

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.