douyin/xingtu-v2/search-creator

Search Creator

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]

page = 1 gender = 2 fans_min = 10000

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