ae_bilibili_huahuo_search_upper
### Purpose: - Search creators by nickname, UID, or content keyword in the Huahuo marketplace. - Combine profile, audience, pricing, performance, DMP, industry, cooperation-experience, and commerce filters. - `nickname_or_mids` and `main_search` correspond to creator search and content search respectively; normally choose one per request. ### Parameters: #### Basic search parameters: - `nickname_or_mids`: Creator nickname or UID query; separate multiple terms with commas. - `main_search`: Content-keyword query with matched videos included in the result. Normally use either this field or `nickname_or_mids`. - `mids`: Exact UID list; `upper_mid`: One exact UID; `folder_id`: Saved-creator folder ID. - `marketing_target`: `1`=brand awareness, `2`=consideration, `3`=conversion. - `panel_type`: `0`=general, `1`=gaming, `2`=beauty, `3`=digital, `4`=automotive, `5`=performance, `6`=food, `8`=internet services. - `order_by`: Sort field; `sort`: `desc` or `asc`; `page`: One-based page number with 20 results per page; `request_id`: Optional search-session ID that can be reused across pages with the same filters. #### Creator profile and affiliation parameters: - `gender`: Value from `square_static_info.gender_info`. - `min_fans_num` / `max_fans_num`: Inclusive follower-count range. - `region_id` / `second_region_id`: Primary and secondary residence-region IDs from `region_drop`. The Beijing, Shanghai, Fujian, Xiamen, and Fuzhou selection is `{"region_id":[4,5,23],"second_region_id":[51,50]}`. - `partition_id` / `second_partition_id`: Primary and secondary content-category IDs. - `mcn_ids`: MCN IDs; `provider_id`: Service-provider IDs. - `upper_types`: `1` or `4`=MCN-affiliated, `3`=independent. - `only_contract`: `1`=contract-eligible creators only, `0`=all. - `is_painter_order`: Require illustration-commission capability. #### Audience and DMP parameters: - `fans_age_tag`, `fans_gender_tag`, `fans_region_tag`: Audience age, gender, and region affinity tags; `fans_stick`: Follower-loyalty tier. - `av_active`: Enable recent-publishing filtering; `av_active_tag`: Activity tier. - `dmp_group_id`: Custom DMP package ID; `category_dmp_group_id` and `category_dmp_label`: Category-package ID and display label. - `dmp_pkg_name`: Special-audience package name query. - `dmp_pkg_vertical_rate_gte` / `dmp_pkg_vertical_rate_lte`: DMP verticality range, measured as matching videos divided by all videos in the last 180 days. - `dmp_pkg_effect_rate_gte` / `dmp_pkg_effect_rate_lte`: DMP influence range, measured as recent matching viewers divided by that audience population. - `dmp_pkg_fan_rate_gte` / `dmp_pkg_fan_rate_lte`: DMP attention range, measured as matching audience members divided by all followers. #### Pricing and performance parameters: - `min_task_price` / `max_task_price`: Standard cooperation quote range in RMB. - `price_info`: Cooperation-specific pricing array; the current UI submits one selected cooperation type per search. Each item contains: - `cooperation_type`: Video cooperation uses `1`=embedded video, `2`=custom video, and `22`=deep customization; podcast cooperation uses `23`=custom podcast and `24`=podcast brand placement; dynamic cooperation uses `3`=direct post and `4`=repost. Placement formats embed brand material in the content, custom formats are produced for the client's marketing needs, and dynamic formats publish or repost the requested commercial post. - `price_min` / `price_max`: Quote range in RMB for that cooperation type. - `creative_skill`: Deep-customization skill IDs `1-9`, covering overseas filming, technical analysis, microfilm, live-action challenge, renovation/DIY, interview, TVC filming, special editing, and other. - `include_content`: Included-content IDs for custom video, deep customization, or custom podcast: `1`=secondary creation/distribution license, `2`=bonus preview, `3`=custom content. - `price_right`: Cooperation-right codes. Types `1/2/23/24` support `show_in_video_first_1p3` and `show_in_video_gte_30s`; type `22` supports `brand_over_30_percent`, `auth_secondary_creation`, `multi_cooperation_discount`, `give_preview`, and `give_poster`. Types `3/4` do not support this field and use `[]`. - Every `price_info` item contains all six fields. Send `[]` for an unavailable or unselected `creative_skill`, `include_content`, or `price_right`. “RMB 100,000 or more” is `"price_min":100000,"price_max":""`. - Deep-custom example: `{"price_info":[{"cooperation_type":22,"creative_skill":[1,2,3],` `"include_content":[1,2,3],"price_min":100000,"price_max":"",` `"price_right":[]}]}`. - Embedded-video example: `{"price_info":[{"cooperation_type":1,"creative_skill":[],` `"include_content":[],"price_min":100000,"price_max":"","price_right":[]}]}`. - Custom-podcast example: `{"price_info":[{"cooperation_type":23,"creative_skill":[],` `"include_content":[1],"price_min":100000,"price_max":"","price_right":[]}]}`. - Direct-post example: `{"price_info":[{"cooperation_type":3,"creative_skill":[],` `"include_content":[],"price_min":100000,"price_max":"","price_right":[]}]}`. - Call `GET /api/v1/bilibili/huahuo/square_static_info` first and read `data.price_info_options` for cooperation types, price ranges, rights, included content, and creative skills. Each item in `cooperation_type` declares its usable request fields in `supported_fields`. - `last_7_days_set_price`, `last_14_days_set_price`, `last_30_days_set_price`: `1` requires a quote set in the selected period; `0` means unrestricted. - `min_interact_rate` / `max_interact_rate`: Engagement-rate range for eligible original videos in the last 180 days. - `blue_url_ctr_gte` / `blue_url_ctr_lt`: Blue-link CTR range; `blue_url_click_cost_gte` / `blue_url_click_cost_lt`: Blue-link click-cost range. - `min_play_median` / `max_play_median`: Median-view range for eligible original videos published at least seven days ago. - `play_median_traffic_type`: `1`=all, `2`=organic; `play_median_cycle`: `1/2/3`=7/15/30 days. Example for “300,000-500,000, 15 days, organic”: `{"min_play_median":"300000","max_play_median":"500000",` `"play_median_traffic_type":2,"play_median_cycle":2}`. - `min_cpm` / `max_cpm`: CPM range; `cpm_type`: `1`=all, `2`=organic; `cpm_cycle`: `1/2/3`=7/15/30 days. - `min_cpc` / `max_cpc`: CPC range; `cpc_traffic_type`: `1`=all, `2`=organic; `cpc_cycle`: `1/2/3`=7/15/30 days. - `cpe_gte` / `cpe_lt`: CPE range; `cpe_traffic_type`: `1`=all, `2`=organic; `cpe_cycle`: `1`=7 days, `3`=30 days. #### Content and cooperation parameters: - `draft_duration`: Dominant video duration: `1`=0-30s, `2`=30-60s, `3`=1-3m, `4`=3-5m, `5`=5-10m, `6`=over 10m. - `min_avid_cnt` / `max_avid_cnt`: Eligible original-video count range over 90 days. - `min_hot_avid_rate` / `max_hot_avid_rate`: Viral-video ratio range over 90 days. - `half_min_hot_avid_cnt` / `half_max_hot_avid_cnt`: Viral-video count range over six months. - `entry_cost_min` / `entry_cost_max`: Store-entry cost range over the last year. - `av_honor`: Honor filter containing a multi-select `honor_type` array (`HOT`, `MZBK`, and/or `QZPHB`), `time_period` (`0/30/90/180` days), and `honor_count` (`0/1/2/3`, where 3 means 3+). Multi-select example: `{"av_honor":{"honor_type":["HOT","QZPHB"],"time_period":90,` `"honor_count":2}}`. - The general panel's cooperation-count filter uses `spark_tag`: `cooperate`=experienced or `coo_frequent`=extensive experience; choose one. Cooperation industries come from `square_static_info.industry_tree`; send selected paths in `huahuo_first_industry_ids`, `huahuo_second_industry_ids`, and `huahuo_third_industry_ids`. For “real estate/all with experience”: `{"spark_tag":["cooperate"],"huahuo_first_industry_ids":["388"],` `"huahuo_second_industry_ids":["389","393","399","401","403"],` `"huahuo_third_industry_ids":["390","394","395","396","398",` `"400","402","404"]}`. Merge IDs from all selected paths for a multi-industry request. - Non-general strategy panels use `cooperate_experience_industry_ids` with `cooperate_experience_type`. Without selected industries, the type options are `3`=no current-industry experience, `1`=experienced, `2`=extensive experience, and `4`=experience in other industries. With selected industries, use `1` or `2`. `cooperate_experience_industry` supplies those strategy-panel industry values. #### Labels and industry parameters: - `special_tags`: Feature tags; `spark_tag`: Capability tags such as `cooperate`, `grow`, and `hot_frequent`; `square_tag_in`: Marketplace scenario tags. - `label_array`: Contains only selected node `value`s from the “Content type” group returned by `upper_label_tree`. Put all selected content types in one inner array without parent-path values. Single “Outdoor adventure” selection: `{"label_array":[[794]]}`; multiple “Outdoor adventure, AI short film, AI entertainment” selections: `{"label_array":[[794,747,748]]}`. - `bdata_tag_lv5`: Bilibili level-five content-tag values. - `huahuo_first_industry_ids`, `huahuo_second_industry_ids`, `huahuo_third_industry_ids`: Primary, secondary, and tertiary Huahuo industry IDs. #### Commerce parameters: - `goods_permission`: `1`=require commerce permission, `0`=all; `goods_up_levels`: Commerce-creator levels. - `goods_category_first_ids` / `goods_category_second_ids`: Commerce-category IDs. - `goods_gpm_min` / `goods_gpm_max`: 30-day paid GMV per 1,000 commerce-video views. - `goods_ctr_min` / `goods_ctr_max`: Component CTR range; `goods_ctr_type`: `1`=all components, `2`=comment component. - `goods_avg_price_min` / `goods_avg_price_max`: 30-day average product-price range in RMB. - `goods_is_high_video_play_permeate`: Require high video-view penetration; `goods_is_high_fans_play_permeate`: Require high follower-view penetration. #### Status and high-potential parameters: - `is_boosting`: Require currently boosted creators; `is_treasure_up`: Treasure creators; `is_timely_response`: Timely-response creators; `is_new_enter`: Newly onboarded creators. - `custom_video_pricing_set`: Require configured custom-video pricing; `is_x_plan_better_up`: X Plan preferred creators. - `high_potential_type`: `0`=all, `1`=onboarded, `2`=not onboarded. #### Filter value sources: - Content types: call `GET /api/v1/bilibili/huahuo/upper_label_tree?panel_type=0`, read node `value`s from the Content type group, and build `label_array`. - Residence regions: call `GET /api/v1/bilibili/huahuo/region_drop`; use primary `value`s in `region_id` and selected child `value`s in `second_region_id`. - General-panel cooperation industries: call `GET /api/v1/bilibili/huahuo/square_static_info`, read the three-level `data.industry_tree`, and fill the matching `huahuo_*_industry_ids` arrays. Use `spark_tag` with `cooperate` or `coo_frequent` for cooperation count. - Non-general-panel cooperation experience: call `GET /api/v1/bilibili/huahuo/cooperate_experience_industry?industry_type=<TYPE>`, then set `cooperate_experience_industry_ids` and `cooperate_experience_type`. - Cooperation pricing: call `GET /api/v1/bilibili/huahuo/square_static_info`, read `data.price_info_options`, and build `price_info`. Median views and video honors use the fixed enums and Request Payload Examples documented here. - Other dynamic sources: call `GET /api/v1/bilibili/huahuo/square_static_info` for audience, gender, activity, and feature tags; `GET /api/v1/bilibili/huahuo/partition_drop` for first- and second-level video categories; `GET /api/v1/bilibili/huahuo/mcn_drop?name=` for MCNs; `GET /api/v1/bilibili/huahuo/dmp_pkg_list` for custom DMP packages; and `GET /api/v1/bilibili/huahuo/effect_goods_drop` for commerce categories. ### Returns: - `page`: Current page number. - `total_count`: Total matching records, displayed up to 10,000. - `data`: Creator records commonly containing `upper_mid`, `nickname`, `fans_num`, `play_median`, `interactive_rate`, pricing, content and industry labels, DMP measurements, and commerce metrics. Content-search results also include matched videos. AE input example: {"request_body":{"main_search":"科技","page":1,"marketing_target":1,"panel_type":0}}

