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}}
Pricing
| Condition | Charge |
|---|---|
| Each call | 20.65 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | No | # [中文] ### 搜索方式: - `nickname_or_mids`: 按 UP 主昵称或 UID 搜索,多个值可用英文逗号分隔。 - `main_search`: 按内容关键词搜索,并在结果中返回命中的稿件信息。 - `mids` / `upper_mid`: 按一个或多个 UID 精确匹配。 ### 筛选字段: - **基础与归属**:性别、粉丝数、地域、内容分区、MCN、服务商及账号类型。 - **粉丝画像**:年龄、性别、地域倾向和粉丝黏性。 - **报价与效果**:任务报价、互动率、播放中位数、CPM、CPC、CPE、进店成本。 - **内容与合作**:稿件数量、爆款比例、视频时长、稿件荣誉、行业及合作经验。 - **带货能力**:带货权限、等级、类目、GPM、组件点击率和商品均价。 - **人群包与标签**:DMP 人群包、特色标签、内容类型树和高潜标签。 所有字段均可选。比例字段按页面展示值传入,例如 `0.05` 表示 5%; 金额字段按页面使用的人民币数值传入。筛选项的动态 ID 可通过 `square_static_info`、`upper_label_tree` 及相应下拉列表接口取得。 # [English] ### Search modes: - `nickname_or_mids`: Search by creator nickname or UID; separate multiple terms with commas. - `main_search`: Search by content keyword and include matched videos in the response. - `mids` / `upper_mid`: Match one or more creator UIDs exactly. ### Filter groups: - **Profile and affiliation**: gender, followers, region, content category, MCN, service provider, and account type. - **Audience profile**: age, gender, region affinity, and follower loyalty. - **Pricing and performance**: quote, engagement rate, median views, CPM, CPC, CPE, and store-entry cost. - **Content and cooperation**: post count, viral-post ratio, video duration, honors, industries, and cooperation experience. - **Commerce**: permission, level, categories, GPM, component CTR, and average product price. - **Audience packages and labels**: DMP packages, feature tags, content-type trees, and high-potential tags. Every field is optional. Send ratio fields as decimal values (for example, `0.05` for 5%) and monetary fields as the RMB values displayed by Huahuo. Dynamic IDs are available from `square_static_info`, `upper_label_tree`, and the corresponding dropdown endpoints. # [示例/Example] ```json { "nickname_or_mids": "2233,小电视", "marketing_target": 1, "panel_type": 0, "min_fans_num": 100000, "max_fans_num": 1000000, "min_interact_rate": 0.03, "play_median_traffic_type": 1, "play_median_cycle": 3, "price_info": [{ "cooperation_type": 1, "creative_skill": [], "include_content": [], "price_min": 1000, "price_max": 10000, "price_right": [] }], "goods_ctr_type": 1, "page": 1 } ``` | — |
request_body.mids | array | null | No | 批量精确匹配的 UP 主 UID 列表 / List of creator UIDs to match exactly | — |
request_body.page | integer | null | No | 页码,从 1 开始,每页返回 20 条 / One-based page number; each page returns 20 records | — |
request_body.sort | string | null | No | 排序方向:desc=降序,asc=升序 / Sort direction: desc=descending, asc=ascending | — |
request_body.cpe_lt | integer | number | string | null | No | CPE 上限,即花费除以有效互动次数 / Maximum CPE, calculated as spend divided by valid engagements | — |
request_body.gender | string | null | No | UP 主性别,取值见 /api/v1/bilibili/huahuo/square_static_info 返回的 gender_info / Creator gender from gender_info returned by /api/v1/bilibili/huahuo/square_static_info | — |
request_body.cpe_gte | integer | number | string | null | No | CPE 下限,即花费除以有效互动次数 / Minimum CPE, calculated as spend divided by valid engagements | — |
request_body.max_cpc | integer | number | string | null | No | CPC 上限,即花费除以组件点击次数 / Maximum CPC, calculated as spend divided by component clicks | — |
request_body.max_cpm | integer | number | string | null | No | CPM 上限,即花费除以播放量再乘1000 / Maximum CPM, calculated as spend divided by views times 1,000 | — |
request_body.mcn_ids | array | null | No | MCN 机构 ID 列表,取值见 /api/v1/bilibili/huahuo/mcn_drop / MCN organization IDs from /api/v1/bilibili/huahuo/mcn_drop | — |
request_body.min_cpc | integer | number | string | null | No | CPC 下限,即花费除以组件点击次数 / Minimum CPC, calculated as spend divided by component clicks | — |
request_body.min_cpm | integer | number | string | null | No | CPM 下限,即花费除以播放量再乘1000 / Minimum CPM, calculated as spend divided by views times 1,000 | — |
request_body.av_honor | unknown | null | No | 稿件荣誉没有独立选项接口,取值见 search_upper 文档;honor_type 始终为可多选数组 / Video honors have no separate options endpoint; use the search_upper documentation and always send honor_type as an array | — |
request_body.av_honor.honor_type | array | null | No | 荣誉类型数组,可多选:HOT=热门、MZBK=每周必看、QZPHB=全站排行榜 / Multi-select honor types: HOT, MZBK, and QZPHB | — |
request_body.av_honor.honor_count | integer | null | No | 获奖次数:0=不限,1=1次,2=2次,3=3次及以上 / Honor count: 0=all, 1=once, 2=twice, 3=three or more | — |
request_body.av_honor.time_period | integer | null | No | 统计周期:0=不限,30/90/180=近对应天数 / Time period: 0=all, or the most recent 30, 90, or 180 days | — |
request_body.cpm_type | integer | null | No | CPM 流量口径:1=全部流量,2=自然流量 / CPM traffic scope: 1=all traffic, 2=organic traffic | — |
request_body.order_by | string | null | No | 排序字段,例如 fans_num、play_median、interactive_rate / Sort field, such as fans_num, play_median, or interactive_rate | — |
request_body.av_active | integer | null | No | 近期投稿活跃开关:1=启用,0=不限 / Recent-publishing activity switch: 1=enabled, 0=all | — |
request_body.cpc_cycle | integer | null | No | CPC 统计周期:1=7天,2=15天,3=30天 / CPC window: 1=7 days, 2=15 days, 3=30 days | — |
request_body.cpe_cycle | integer | null | No | CPE 统计周期:1=7天,3=30天 / CPE window: 1=7 days, 3=30 days | — |
request_body.cpm_cycle | integer | null | No | CPM 统计周期:1=7天,2=15天,3=30天 / CPM window: 1=7 days, 2=15 days, 3=30 days | — |
request_body.folder_id | integer | string | null | No | 已保存 UP 主文件夹 ID,用于限定文件夹内搜索 / Saved-creator folder ID used to limit the search | — |
request_body.region_id | array | null | No | 先调用 /api/v1/bilibili/huahuo/region_drop;把选中一级地域的 value 放入此数组 / Call /api/v1/bilibili/huahuo/region_drop first, then put selected primary-region values in this array | — |
request_body.spark_tag | array | null | No | 花火能力标签;通用面板合作次数使用 cooperate=有合作经验或 coo_frequent=合作经验丰富,并与 /api/v1/bilibili/huahuo/square_static_info 返回的行业树字段配合使用 / Huahuo capability tags; general-panel cooperation count uses cooperate or coo_frequent together with industry-tree values from /api/v1/bilibili/huahuo/square_static_info | — |
request_body.upper_mid | integer | string | null | No | 单个 UP 主 UID 精确筛选 / Single creator UID for an exact match | — |
request_body.fans_stick | integer | null | No | 粉丝黏性筛选值,0=不限,其他值取自静态筛选项 / Follower-loyalty filter; 0=all, otherwise use a static-option value | — |
request_body.panel_type | integer | null | No | 行业策略面板:0=通用,1=游戏,2=美妆,3=数码,4=汽车,5=效果,6=食饮,8=网服 / Strategy panel: 0=general, 1=gaming, 2=beauty, 3=digital, 4=automotive, 5=performance, 6=food, 8=internet | — |
request_body.price_info | array | null | No | 合作报价筛选数组;先调用 /api/v1/bilibili/huahuo/square_static_info 并读取 price_info_options,每次搜索传一个合作类型,每项固定包含六个字段,不适用或未选择的数组传 [] / Cooperation-pricing filters from price_info_options returned by /api/v1/bilibili/huahuo/square_static_info; send one type per search, include all six fields, and use [] for unavailable arrays | — |
request_body.price_info[].price_max | integer | number | string | null | No | 该合作形式的报价上限,单位为人民币元;预设区间见 /api/v1/bilibili/huahuo/square_static_info 返回的 price_info_options.price_range / Maximum quote in RMB; presets are returned in price_info_options.price_range by /api/v1/bilibili/huahuo/square_static_info | — |
request_body.price_info[].price_min | integer | number | string | null | No | 该合作形式的报价下限,单位为人民币元;预设区间见 /api/v1/bilibili/huahuo/square_static_info 返回的 price_info_options.price_range / Minimum quote in RMB; presets are returned in price_info_options.price_range by /api/v1/bilibili/huahuo/square_static_info | — |
request_body.price_info[].price_right | array | null | No | 合作权益代码数组,例如 show_in_video_first_1p3、show_in_video_gte_30s、brand_over_30_percent、auth_secondary_creation、multi_cooperation_discount、give_preview、give_poster;完整取值及适用类型见 /api/v1/bilibili/huahuo/square_static_info 返回的 price_info_options.price_right,未选择或不适用时传 [] / Cooperation-right codes and applicable types from price_info_options.price_right returned by /api/v1/bilibili/huahuo/square_static_info; send [] when unselected or unavailable | — |
request_body.price_info[].creative_skill | array | null | No | 深度定制的创作技能 ID:1=海外拍摄,2=硬核技术解析,3=微电影或短片,4=真人综艺挑战,5=改造或DIY,6=访谈街采,7=TVC拍摄,8=特色剪辑方法,9=其他;取值见 /api/v1/bilibili/huahuo/square_static_info 返回的 price_info_options.creative_skill / Deep-customization skill IDs 1-9; options are returned in price_info_options.creative_skill | — |
request_body.price_info[].include_content | array | null | No | 定制视频、深度定制或播客专题定制的包含内容 ID:1=授权二创或分发,2=赠送预告片,3=自定义内容;取值见 /api/v1/bilibili/huahuo/square_static_info 返回的 price_info_options.include_content / Included-content IDs 1-3; options are returned in price_info_options.include_content | — |
request_body.price_info[].cooperation_type | integer | string | null | No | 合作类型:1=植入视频,2=定制视频,22=深度定制,23=播客专题定制,24=播客品牌植入,3=直发动态,4=转发动态;各类型支持的字段见 /api/v1/bilibili/huahuo/square_static_info 返回的 price_info_options.cooperation_type / Cooperation type: 1=embedded video, 2=custom video, 22=deep customization, 23=custom podcast, 24=podcast brand placement, 3=direct post, 4=repost; supported fields are returned in price_info_options.cooperation_type | — |
request_body.request_id | string | null | No | 搜索会话标识;同组条件翻页时复用,留空则生成新值 / Search-session ID; reuse it across pages of the same filter set | — |
request_body.is_boosting | integer | null | No | 是否筛选内容加热中的 UP 主:1=是,0=不限 / Boosting-status filter: 1=currently boosting, 0=all | — |
request_body.label_array | array | null | No | 先调用 /api/v1/bilibili/huahuo/upper_label_tree;把内容类型分组中所有已选节点的 value 放入同一个内层数组 / Call /api/v1/bilibili/huahuo/upper_label_tree first, then put all selected content-type values in one inner array | — |
request_body.main_search | string | null | No | 按内容关键词搜索,命中稿件会随结果返回 / Content-keyword query; matched videos are included in the result | — |
request_body.provider_id | array | null | No | 服务商 ID 列表,使用花火筛选项的可选值 / Service-provider IDs using values offered by the Huahuo filter | — |
request_body.upper_types | array | null | No | 账号类型:1或4=机构签约,3=个人 / Creator type: 1 or 4=MCN-affiliated, 3=independent | — |
request_body.dmp_group_id | integer | string | null | No | DMP 自定义人群包 ID,取值见 /api/v1/bilibili/huahuo/dmp_pkg_list / DMP custom audience-package ID from /api/v1/bilibili/huahuo/dmp_pkg_list | — |
request_body.dmp_pkg_name | string | null | No | DMP 特殊人群包名称关键词 / DMP special-audience package name query | — |
request_body.fans_age_tag | array | null | No | 粉丝年龄倾向标签,取值见 /api/v1/bilibili/huahuo/square_static_info / Audience age-affinity tags from /api/v1/bilibili/huahuo/square_static_info | — |
request_body.is_new_enter | integer | string | null | No | 是否筛选新入驻 UP 主 / Whether to filter for newly onboarded creators | — |
request_body.max_avid_cnt | integer | string | null | No | 近90天有效原创稿件数上限 / Maximum eligible original-video count in the last 90 days | — |
request_body.max_fans_num | integer | string | null | No | 粉丝数上限(含)/ Maximum follower count, inclusive | — |
request_body.min_avid_cnt | integer | string | null | No | 近90天有效原创稿件数下限 / Minimum eligible original-video count in the last 90 days | — |
request_body.min_fans_num | integer | string | null | No | 粉丝数下限(含)/ Minimum follower count, inclusive | — |
request_body.partition_id | integer | string | null | No | 内容一级分区 ID,取值见 /api/v1/bilibili/huahuo/partition_drop / Primary content-category ID from /api/v1/bilibili/huahuo/partition_drop | — |
request_body.special_tags | array | null | No | 特色标签列表,取值见 /api/v1/bilibili/huahuo/square_static_info / Feature-tag values from /api/v1/bilibili/huahuo/square_static_info | — |
request_body.av_active_tag | string | null | No | 近期投稿活跃档位,取值见 /api/v1/bilibili/huahuo/square_static_info 返回的 av_active_tag / Recent-publishing activity tier from av_active_tag returned by /api/v1/bilibili/huahuo/square_static_info | — |
request_body.bdata_tag_lv5 | array | null | No | B站五级内容标签筛选值列表 / Bilibili level-five content-tag filter values | — |
request_body.goods_ctr_max | integer | number | string | null | No | 带货组件点击率上限,即组件点击数除以曝光数 / Maximum commerce-component CTR, clicks divided by impressions | — |
request_body.goods_ctr_min | integer | number | string | null | No | 带货组件点击率下限,即组件点击数除以曝光数 / Minimum commerce-component CTR, clicks divided by impressions | — |
request_body.goods_gpm_max | integer | number | string | null | No | 近30天 GPM 上限,即每千次带货视频播放产生的支付 GMV / Maximum 30-day GPM, paid GMV per 1,000 commerce-video views | — |
request_body.goods_gpm_min | integer | number | string | null | No | 近30天 GPM 下限,即每千次带货视频播放产生的支付 GMV / Minimum 30-day GPM, paid GMV per 1,000 commerce-video views | — |
request_body.only_contract | integer | null | No | 仅看可签约账号:1=是,0=不限 / Contract-eligible filter: 1=only eligible creators, 0=all | — |
request_body.square_tag_in | array | null | No | 广场场景标签,例如 ad_partner_experienced / Marketplace scenario tags such as ad_partner_experienced | — |
request_body.draft_duration | integer | string | null | No | 主流视频时长:1=0-30秒,2=30-60秒,3=1-3分,4=3-5分,5=5-10分,6=10分以上 / Dominant video duration bucket from under 30 seconds to over 10 minutes | — |
request_body.entry_cost_max | integer | number | string | null | No | 近一年相关合作的进店成本上限 / Maximum store-entry cost for relevant cooperation in the last year | — |
request_body.entry_cost_min | integer | number | string | null | No | 近一年相关合作的进店成本下限 / Minimum store-entry cost for relevant cooperation in the last year | — |
request_body.goods_ctr_type | integer | null | No | 带货点击率组件口径:1=全部组件,2=评论区组件 / Commerce CTR component scope: 1=all components, 2=comment component | — |
request_body.is_treasure_up | integer | string | null | No | 是否筛选宝藏 UP 主 / Whether to filter for treasure creators | — |
request_body.max_task_price | integer | number | string | null | No | 标准合作报价上限,单位为人民币元 / Maximum standard cooperation quote in RMB | — |
request_body.min_task_price | integer | number | string | null | No | 标准合作报价下限,单位为人民币元 / Minimum standard cooperation quote in RMB | — |
request_body.blue_url_ctr_lt | integer | number | string | null | No | 蓝链点击率上限,即蓝链点击量除以视频播放量 / Maximum blue-link CTR, blue-link clicks divided by video views | — |
request_body.fans_gender_tag | array | null | No | 粉丝性别倾向标签,取值见 /api/v1/bilibili/huahuo/square_static_info / Audience gender-affinity tags from /api/v1/bilibili/huahuo/square_static_info | — |
request_body.fans_region_tag | array | null | No | 粉丝地域倾向标签,取值见 /api/v1/bilibili/huahuo/square_static_info / Audience region-affinity tags from /api/v1/bilibili/huahuo/square_static_info | — |
request_body.goods_up_levels | array | null | No | 带货 UP 主等级列表 / Commerce-creator level values | — |
request_body.max_play_median | integer | number | string | null | No | 播放量中位数上限;统计近180天且发布满7天的合格原创稿件 / Maximum median views for eligible original videos published at least seven days ago | — |
request_body.min_play_median | integer | number | string | null | No | 播放量中位数下限;统计近180天且发布满7天的合格原创稿件 / Minimum median views for eligible original videos published at least seven days ago | — |
request_body.blue_url_ctr_gte | integer | number | string | null | No | 蓝链点击率下限,即蓝链点击量除以视频播放量 / Minimum blue-link CTR, blue-link clicks divided by video views | — |
request_body.cpc_traffic_type | integer | null | No | CPC 流量口径:1=全部流量,2=自然流量 / CPC traffic scope: 1=all traffic, 2=organic traffic | — |
request_body.cpe_traffic_type | integer | null | No | CPE 流量口径:1=全部流量,2=自然流量 / CPE traffic scope: 1=all traffic, 2=organic traffic | — |
request_body.goods_permission | integer | null | No | 带货权限筛选:1=有权限,0=不限 / Commerce permission filter: 1=required, 0=all | — |
request_body.is_painter_order | boolean | null | No | 是否筛选画师约稿能力 / Whether to require illustration-commission capability | — |
request_body.marketing_target | integer | null | No | 营销目标:1=品牌曝光,2=心智种草,3=效果转化 / Marketing objective: 1=brand awareness, 2=consideration, 3=conversion | — |
request_body.nickname_or_mids | string | null | No | 按 UP 主昵称或 UID 搜索,多个关键词用英文逗号分隔 / Creator nickname or UID query; separate multiple terms with commas | — |
request_body.second_region_id | array | null | No | 先调用 /api/v1/bilibili/huahuo/region_drop;把选中一级地域 children 中的二级 value 放入此数组 / Call /api/v1/bilibili/huahuo/region_drop first, then put selected child-region values in this array | — |
request_body.max_hot_avid_rate | integer | number | string | null | No | 近90天爆款稿件占比上限 / Maximum viral-video ratio in the last 90 days | — |
request_body.max_interact_rate | integer | number | string | null | No | 互动率上限;近180天合格原创稿件互动量除以播放量 / Maximum engagement rate for eligible original videos in the last 180 days | — |
request_body.min_hot_avid_rate | integer | number | string | null | No | 近90天爆款稿件占比下限 / Minimum viral-video ratio in the last 90 days | — |
request_body.min_interact_rate | integer | number | string | null | No | 互动率下限;近180天合格原创稿件互动量除以播放量 / Minimum engagement rate for eligible original videos in the last 180 days | — |
request_body.play_median_cycle | integer | null | No | 播放中位数统计周期:1=7天,2=15天,3=30天 / Median-view window: 1=7 days, 2=15 days, 3=30 days | — |
request_body.category_dmp_label | string | null | No | 内容类目 DMP 人群包展示名称 / Display label for the content-category DMP audience package | — |
request_body.is_timely_response | integer | string | null | No | 是否筛选及时响应的 UP 主 / Whether to require timely-response creators | — |
request_body.goods_avg_price_max | integer | number | string | null | No | 近30天商品平均价格上限,单位为人民币元 / Maximum average product price in the last 30 days, in RMB | — |
request_body.goods_avg_price_min | integer | number | string | null | No | 近30天商品平均价格下限,单位为人民币元 / Minimum average product price in the last 30 days, in RMB | — |
request_body.high_potential_type | integer | null | No | 高潜类型:0=全部,1=已入驻,2=未入驻 / High-potential type: 0=all, 1=onboarded, 2=not onboarded | — |
request_body.is_x_plan_better_up | integer | string | null | No | 是否筛选 X 计划优选 UP 主 / Whether to filter for X Plan preferred creators | — |
request_body.second_partition_id | array | null | No | 内容二级分区 ID 列表,取值见 /api/v1/bilibili/huahuo/partition_drop / Secondary content-category IDs from /api/v1/bilibili/huahuo/partition_drop | — |
request_body.dmp_pkg_fan_rate_gte | integer | number | string | null | No | DMP 人群关注度下限:粉丝中该人群占比 / Minimum DMP attention: matching audience members divided by all followers | — |
request_body.dmp_pkg_fan_rate_lte | integer | number | string | null | No | DMP 人群关注度上限:粉丝中该人群占比 / Maximum DMP attention: matching audience members divided by all followers | — |
request_body.category_dmp_group_id | integer | string | null | No | 内容类目 DMP 人群包 ID / Content-category DMP audience-package ID | — |
request_body.half_max_hot_avid_cnt | integer | string | null | No | 近半年爆款稿件数上限 / Maximum viral-video count in the last six months | — |
request_body.half_min_hot_avid_cnt | integer | string | null | No | 近半年爆款稿件数下限 / Minimum viral-video count in the last six months | — |
request_body.last_7_days_set_price | integer | null | No | 近7天是否设置过报价:1=是,0=不限 / Quote-updated-in-7-days filter: 1=yes, 0=all | — |
request_body.blue_url_click_cost_lt | integer | number | string | null | No | 蓝链点击成本上限,即合作及投流花费除以蓝链点击量 / Maximum blue-link click cost, cooperation and promotion spend divided by clicks | — |
request_body.last_14_days_set_price | integer | null | No | 近14天是否设置过报价:1=是,0=不限 / Quote-updated-in-14-days filter: 1=yes, 0=all | — |
request_body.last_30_days_set_price | integer | null | No | 近30天是否设置过报价:1=是,0=不限 / Quote-updated-in-30-days filter: 1=yes, 0=all | — |
request_body.blue_url_click_cost_gte | integer | number | string | null | No | 蓝链点击成本下限,即合作及投流花费除以蓝链点击量 / Minimum blue-link click cost, cooperation and promotion spend divided by clicks | — |
request_body.dmp_pkg_effect_rate_gte | integer | number | string | null | No | DMP 人群影响力下限:近30天相关观众占该人群总量比例 / Minimum DMP influence: recent matching viewers divided by the audience population | — |
request_body.dmp_pkg_effect_rate_lte | integer | number | string | null | No | DMP 人群影响力上限:近30天相关观众占该人群总量比例 / Maximum DMP influence: recent matching viewers divided by the audience population | — |
request_body.custom_video_pricing_set | integer | string | null | No | 是否已设置定制视频报价 / Whether custom-video pricing has been configured | — |
request_body.goods_category_first_ids | array | null | No | 带货一级类目 ID 列表,取值见 /api/v1/bilibili/huahuo/effect_goods_drop / Primary commerce-category IDs from /api/v1/bilibili/huahuo/effect_goods_drop | — |
request_body.play_median_traffic_type | integer | null | No | 播放中位数流量口径:1=全部流量,2=自然流量 / Median-view traffic scope: 1=all traffic, 2=organic traffic | — |
request_body.cooperate_experience_type | integer | string | null | No | 非通用行业策略面板的合作经验类型:1=有当前行业经验,2=当前行业经验丰富,3=无当前行业经验,4=有其他行业经验;选择行业时仅使用1或2,通用面板改用 spark_tag / Experience type for non-general strategy panels: 1=experienced, 2=extensive, 3=none in current industry, 4=experience in other industries; use 1 or 2 with selected industries, while the general panel uses spark_tag | — |
request_body.dmp_pkg_vertical_rate_gte | integer | number | string | null | No | DMP 人群垂直度下限:相关视频数占总视频数比例 / Minimum DMP verticality: matching videos divided by all videos | — |
request_body.dmp_pkg_vertical_rate_lte | integer | number | string | null | No | DMP 人群垂直度上限:相关视频数占总视频数比例 / Maximum DMP verticality: matching videos divided by all videos | — |
request_body.goods_category_second_ids | array | null | No | 带货二级类目 ID 列表,取值见 /api/v1/bilibili/huahuo/effect_goods_drop / Secondary commerce-category IDs from /api/v1/bilibili/huahuo/effect_goods_drop | — |
request_body.huahuo_first_industry_ids | array | null | No | 通用面板先调用 /api/v1/bilibili/huahuo/square_static_info;把 industry_tree 选中路径的一级 ID 放入此数组 / For the general panel, call /api/v1/bilibili/huahuo/square_static_info and put selected primary industry_tree IDs here | — |
request_body.huahuo_third_industry_ids | array | null | No | 通用面板先调用 /api/v1/bilibili/huahuo/square_static_info;把 industry_tree 选中路径的三级 ID 放入此数组 / For the general panel, call /api/v1/bilibili/huahuo/square_static_info and put selected tertiary industry_tree IDs here | — |
request_body.huahuo_second_industry_ids | array | null | No | 通用面板先调用 /api/v1/bilibili/huahuo/square_static_info;把 industry_tree 选中路径的二级 ID 放入此数组 / For the general panel, call /api/v1/bilibili/huahuo/square_static_info and put selected secondary industry_tree IDs here | — |
request_body.goods_is_high_fans_play_permeate | integer | string | null | No | 高粉丝播放渗透筛选 / High follower-view penetration filter | — |
request_body.cooperate_experience_industry_ids | array | null | No | 非通用行业面板先调用 /api/v1/bilibili/huahuo/cooperate_experience_industry,再把选中行业 ID 放入此数组;通用面板不使用此字段 / For non-general panels, call /api/v1/bilibili/huahuo/cooperate_experience_industry first and put selected IDs here; unused by the general panel | — |
request_body.goods_is_high_video_play_permeate | integer | string | null | No | 高视频播放渗透筛选,近30天播放用户占粉丝数比例居前20% / High video-view penetration filter, top 20% by recent viewers per follower | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_bilibili_huahuo_search_upper' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"main_search": "科技",
"marketing_target": 1,
"page": 1,
"panel_type": 0
}
}
}'{
"code": 200,
"data": {
"data": [
{
"active_status": 1,
"app_vv_percent": 0.4754,
"app_vv_percent_desc": "<50%",
"arcurl": "http://www.bilibili.com/video/av117626202294795",
"average_play_cnt": 245989,
"avg_acu_30d": "--"
}
],
"page": 1,
"total_count": 366
},
"docs": "https://api.tikhub.io/#/Bilibili-Huahuo-API/search_upper_api_v1_bilibili_huahuo_search_upper_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "f6c21aaa-87ea-4780-9d51-89eef6be0b33"
}This example shows part of the response. Copied content is valid JSON.

