---
title: "UP主广场搜索（搜UP主 / 搜内容）/Search Huahuo creators or content"
method: POST
path: "/api/v1/bilibili/huahuo/search_upper"
tags: ["Bilibili-Huahuo-API"]
---

# UP主广场搜索（搜UP主 / 搜内容）/Search Huahuo creators or content

`POST /api/v1/bilibili/huahuo/search_upper`

## Request

- Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tikhub.io/api/v1/bilibili/huahuo/search_upper`
- Auth: HTTP bearer

# [中文]
### 用途:
- 在花火内容合作广场按 UP 主、UID 或内容关键词检索创作者。
- 可组合基础属性、粉丝画像、报价与效果、内容表现、DMP 人群包、行业标签、
  合作经验和带货能力等筛选条件。
- `nickname_or_mids` 与 `main_search` 分别对应“搜 UP 主”和“搜内容”，建议二选一。

### 参数:

#### 基础搜索参数:
- `nickname_or_mids`: 按昵称或 UID 搜索 UP 主；多个词使用英文逗号分隔。
- `main_search`: 按内容关键词搜索；命中的稿件随 UP 主结果返回。通常与
  `nickname_or_mids` 二选一。
- `mids`: 批量精确匹配的 UID 列表；`upper_mid`: 单个 UID 精确匹配。
- `folder_id`: 将结果限定在指定的已保存 UP 主文件夹内。
- `marketing_target`: 营销目标，`1`=品牌曝光、`2`=心智种草、`3`=效果转化。
- `panel_type`: 行业策略面板，`0`=通用、`1`=游戏、`2`=美妆、`3`=数码、
  `4`=汽车、`5`=效果、`6`=食饮、`8`=网服。
- `order_by`: 排序字段，例如 `fans_num`、`play_median`、`interactive_rate`；
  `sort`: `desc`=降序、`asc`=升序。
- `page`: 从 `1` 开始的页码，每页返回 20 条；`request_id`: 可选搜索会话标识，
  同组条件翻页时可复用。

#### UP 主属性与归属参数:
- `gender`: UP 主性别，使用 `square_static_info.gender_info` 的值。
- `min_fans_num` / `max_fans_num`: 粉丝数下限和上限，边界值包含在内。
- `region_id` / `second_region_id`: 常驻地域一级、二级 ID 列表，取值见 `region_drop`。
  北京、上海、福建，以及福建下的厦门和福州多选示例为
  `{"region_id":[4,5,23],"second_region_id":[51,50]}`。
- `partition_id` / `second_partition_id`: 内容一级、二级分区 ID，取值见
  `partition_drop`。
- `mcn_ids`: MCN 机构 ID 列表，取值见 `mcn_drop`；`provider_id`: 服务商 ID 列表。
- `upper_types`: 账号类型，`1` 或 `4`=机构签约，`3`=个人。
- `only_contract`: `1`=仅查看可签约账号，`0`=不限。
- `is_painter_order`: 是否要求 UP 主具备画师约稿能力。

#### 粉丝画像与 DMP 参数:
- `fans_age_tag`、`fans_gender_tag`、`fans_region_tag`: 粉丝年龄、性别、地域
  倾向标签，取值见 `square_static_info`。
- `fans_stick`: 粉丝黏性档位；`0`=不限，其它值使用静态筛选项。
- `av_active`: 是否启用近期投稿活跃筛选；`av_active_tag`: 活跃档位，取值见
  `square_static_info.av_active_tag`。
- `dmp_group_id`: 自定义 DMP 人群包 ID。
- `category_dmp_group_id` / `category_dmp_label`: 内容类目 DMP 人群包 ID
  及其展示名称。
- `dmp_pkg_name`: 特殊人群包名称关键词。
- `dmp_pkg_vertical_rate_gte` / `dmp_pkg_vertical_rate_lte`: 人群垂直度下限和上限，
  垂直度为近 180 天相关视频数占总视频数的比例。
- `dmp_pkg_effect_rate_gte` / `dmp_pkg_effect_rate_lte`: 人群影响力下限和上限，
  影响力为近 30 天相关观众占该人群总量的比例。
- `dmp_pkg_fan_rate_gte` / `dmp_pkg_fan_rate_lte`: 人群关注度下限和上限，
  关注度为粉丝中该人群的占比。

#### 报价与效果参数:
- `min_task_price` / `max_task_price`: 标准合作报价区间，单位为人民币元。
- `price_info`: 按合作形式设置的报价条件数组；当前页面每次搜索提交一个选中的
  合作类型。每项包含以下字段：
    - `cooperation_type`: 视频合作为 `1`=植入视频、`2`=定制视频、`22`=深度定制；
      播客合作为 `23`=专题定制、`24`=品牌植入；动态合作为 `3`=直发动态、
      `4`=转发动态。植入类允许在内容中部分植入品牌信息；定制类按客户营销需求
      制作内容；深度定制强调更丰富的个性化内容与权益；动态合作分别表示直接发布
      商业动态或转发指定动态。
    - `price_min` / `price_max`: 该合作类型的人民币报价区间。
    - `creative_skill`: 仅深度定制使用的创作技能 ID 数组，`1-9` 分别表示
      海外拍摄、硬核技术解析、微电影/短片、真人综艺挑战、改造/DIY、访谈街采、
      TVC 拍摄、特色剪辑方法和其他。
    - `include_content`: 定制视频、深度定制、播客专题定制可用的包含内容 ID 数组，
      `1`=授权二创/分发、`2`=赠送预告片、`3`=自定义内容。
    - `price_right`: 合作权益代码数组。类型 `1/2/23/24` 可用
      `show_in_video_first_1p3`、`show_in_video_gte_30s`；类型 `22` 可用
      `brand_over_30_percent`、`auth_secondary_creation`、
      `multi_cooperation_discount`、`give_preview`、`give_poster`；类型 `3/4`
      不支持该字段并传空数组。
  - 每个 `price_info` 项固定包含上述 6 个字段。不适用于该合作类型，或用户未选择
    的 `creative_skill`、`include_content`、`price_right`，均传空数组 `[]`；
    “10万以上”传 `"price_min":100000,"price_max":""`。
  - 深度定制示例：
    `{"price_info":[{"cooperation_type":22,"creative_skill":[1,2,3],`
    `"include_content":[1,2,3],"price_min":100000,"price_max":"",`
    `"price_right":[]}]}`。
  - 植入视频示例：
    `{"price_info":[{"cooperation_type":1,"creative_skill":[],`
    `"include_content":[],"price_min":100000,"price_max":"","price_right":[]}]}`。
  - 播客专题定制示例：
    `{"price_info":[{"cooperation_type":23,"creative_skill":[],`
    `"include_content":[1],"price_min":100000,"price_max":"","price_right":[]}]}`。
  - 直发动态示例：
    `{"price_info":[{"cooperation_type":3,"creative_skill":[],`
    `"include_content":[],"price_min":100000,"price_max":"","price_right":[]}]}`。
  - 先调用 `GET /api/v1/bilibili/huahuo/square_static_info`，从
    `data.price_info_options` 读取合作类型、报价区间、权益、包含内容和创作技能；
    `cooperation_type[].supported_fields` 标明每种合作类型可使用的字段。
- `last_7_days_set_price`、`last_14_days_set_price`、`last_30_days_set_price`:
  对应周期内是否设置过报价；`1`=是，`0`=不限。
- `min_interact_rate` / `max_interact_rate`: 互动率区间。互动率为近 180 天
  合格原创稿件的点赞、收藏、评论、分享、弹幕和投币总量除以播放量。
- `blue_url_ctr_gte` / `blue_url_ctr_lt`: 蓝链 CTR 下限和上限，即蓝链点击量
  除以视频播放量。
- `blue_url_click_cost_gte` / `blue_url_click_cost_lt`: 蓝链点击成本下限和上限，
  即合作金额与投流花费之和除以蓝链点击量。
- `min_play_median` / `max_play_median`: 播放量中位数区间；统计近 180 天内
  发布满 7 天的合格原创稿件。
- `play_median_traffic_type`: 播放口径，`1`=全部流量、`2`=自然流量；
  `play_median_cycle`: `1`=7天、`2`=15天、`3`=30天。
  “30万-50万、15天、自然流量”示例为
  `{"min_play_median":"300000","max_play_median":"500000",`
  `"play_median_traffic_type":2,"play_median_cycle":2}`。
- `min_cpm` / `max_cpm`: CPM 区间，即花费除以播放量再乘 1000；
  `cpm_type`: `1`=全部流量、`2`=自然流量；`cpm_cycle`: `1/2/3`=7/15/30天。
- `min_cpc` / `max_cpc`: CPC 区间，即花费除以组件点击次数；
  `cpc_traffic_type`: `1`=全部流量、`2`=自然流量；`cpc_cycle`: `1/2/3`=7/15/30天。
- `cpe_gte` / `cpe_lt`: CPE 下限和上限，即花费除以有效互动次数；
  `cpe_traffic_type`: `1`=全部流量、`2`=自然流量；`cpe_cycle`: `1`=7天、`3`=30天。

#### 内容表现与合作经验参数:
- `draft_duration`: 主流视频时长，`1`=0-30秒、`2`=30-60秒、`3`=1-3分钟、
  `4`=3-5分钟、`5`=5-10分钟、`6`=10分钟以上。
- `min_avid_cnt` / `max_avid_cnt`: 近 90 天有效原创稿件数区间。
- `min_hot_avid_rate` / `max_hot_avid_rate`: 近 90 天爆款稿件占比区间。
- `half_min_hot_avid_cnt` / `half_max_hot_avid_cnt`: 近半年爆款稿件数区间。
- `entry_cost_min` / `entry_cost_max`: 近一年相关合作的进店成本区间。
- `av_honor`: 稿件荣誉条件对象。`honor_type` 是可多选数组：`HOT`（热门）、
  `MZBK`（每周必看）、`QZPHB`（全站排行榜）；`time_period` 可选
  `0/30/90/180` 天；`honor_count` 为 `0`=不限、`1`=1次、`2`=2次、
  `3`=3次及以上。多选示例：
  `{"av_honor":{"honor_type":["HOT","QZPHB"],"time_period":90,`
  `"honor_count":2}}`。
- 通用面板的“合作次数”使用 `spark_tag`，可选 `cooperate`=有合作经验、
  `coo_frequent`=合作经验丰富；二选一。合作行业来自
  `square_static_info.industry_tree`，按所选路径分别把一、二、三级 ID 传入
  `huahuo_first_industry_ids`、`huahuo_second_industry_ids`、
  `huahuo_third_industry_ids`。选择“房地产/全部且有合作经验”时可传：
  `{"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"]}`。多行业选择时，将各选中路径的 ID 合并到对应层级数组。
- 非通用行业策略面板使用 `cooperate_experience_industry_ids` 和
  `cooperate_experience_type`。未选行业时，类型可选 `3`=无当前行业合作经验、
  `1`=有当前行业合作经验、`2`=当前行业合作经验丰富、`4`=有其他行业合作经验；
  选中行业后仅使用 `1` 或 `2`；行业值由 `cooperate_experience_industry` 返回。

#### 标签与行业参数:
- `special_tags`: 特色标签，取值见 `square_static_info`。
- `spark_tag`: 花火能力标签，例如 `cooperate`、`grow`、`hot_frequent`。
- `square_tag_in`: 广场场景标签，例如 `ad_partner_experienced`。
- `label_array`: 仅承载 `upper_label_tree`“内容类型”分组中选中节点的 `value`。
  所有已选内容类型放在同一个内层数组；不传父级路径。单选“户外探险”：
  `{"label_array":[[794]]}`；多选“户外探险、AI短片、AI整活”：
  `{"label_array":[[794,747,748]]}`。
- `bdata_tag_lv5`: B站五级内容标签筛选值列表。
- `huahuo_first_industry_ids`、`huahuo_second_industry_ids`、
  `huahuo_third_industry_ids`: 花火一、二、三级行业 ID 列表，取值见
  `square_static_info.industry_tree`。

#### 带货能力参数:
- `goods_permission`: `1`=仅筛选有带货权限的 UP 主，`0`=不限。
- `goods_up_levels`: 带货 UP 主等级列表。
- `goods_category_first_ids` / `goods_category_second_ids`: 带货一、二级类目 ID 列表。
- `goods_gpm_min` / `goods_gpm_max`: 近 30 天 GPM 区间，即每千次带货视频播放
  产生的支付 GMV。
- `goods_ctr_min` / `goods_ctr_max`: 带货组件点击率区间，即组件点击量除以曝光量；
  `goods_ctr_type`: `1`=全部组件、`2`=评论区组件。
- `goods_avg_price_min` / `goods_avg_price_max`: 近 30 天商品平均价格区间，单位为元。
- `goods_is_high_video_play_permeate`: 是否要求视频播放渗透率处于高位；
  `goods_is_high_fans_play_permeate`: 是否要求粉丝播放渗透率处于高位。

#### 状态与高潜参数:
- `is_boosting`: `1`=仅筛选内容加热中的 UP 主，`0`=不限。
- `is_treasure_up`: 是否筛选宝藏 UP 主；`is_timely_response`: 是否要求及时响应。
- `is_new_enter`: 是否筛选新入驻 UP 主；`custom_video_pricing_set`: 是否已设置
  定制视频报价。
- `is_x_plan_better_up`: 是否筛选 X 计划优选 UP 主。
- `high_potential_type`: 高潜类型，`0`=全部、`1`=已入驻、`2`=未入驻。

#### 筛选值来源:
- 内容类型：先调用 `GET /api/v1/bilibili/huahuo/upper_label_tree?panel_type=0`，
  从“内容类型”分组读取节点 `value`，再组装 `label_array`。
- 常驻地域：先调用 `GET /api/v1/bilibili/huahuo/region_drop`；一级 `value`
  填入 `region_id`，选中一级节点的子级 `value` 填入 `second_region_id`。
- 通用面板合作行业：先调用 `GET /api/v1/bilibili/huahuo/square_static_info`，
  从 `data.industry_tree` 读取三级行业路径，分别填入三个 `huahuo_*_industry_ids`。
  合作次数同时用 `spark_tag`：`cooperate` 或 `coo_frequent`。
- 非通用行业面板合作经验：先调用
  `GET /api/v1/bilibili/huahuo/cooperate_experience_industry?industry_type=<TYPE>`，
  将选中 ID 填入 `cooperate_experience_industry_ids`，并设置
  `cooperate_experience_type`。
- 合作报价：调用 `GET /api/v1/bilibili/huahuo/square_static_info`，读取
  `data.price_info_options` 并组装 `price_info`。播放量中位数和稿件荣誉使用
  本接口文档中的固定枚举、字段规则和 Request Payload Example。
- 其它动态取值接口：粉丝画像、性别、活跃档位和特色标签调用
  `GET /api/v1/bilibili/huahuo/square_static_info`；一、二级稿件分区调用
  `GET /api/v1/bilibili/huahuo/partition_drop`；MCN 调用
  `GET /api/v1/bilibili/huahuo/mcn_drop?name=`；DMP 自定义人群包调用
  `GET /api/v1/bilibili/huahuo/dmp_pkg_list`；带货一、二级类目调用
  `GET /api/v1/bilibili/huahuo/effect_goods_drop`。

### 返回:
- `page`: 当前页码。
- `total_count`: 匹配结果总数，最大显示为 10000。
- `data`: UP 主列表。常见字段包括 `upper_mid`、`nickname`、`fans_num`、
  `play_median`、`interactive_rate`、合作报价、内容与行业标签、DMP 指标及带货指标；
  内容搜索还会返回匹配稿件。

### 计费:
- 0.01 USD / 次。

# [English]
### 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.

### Billing:
- 0.01 USD per request.

# [示例/Example]
```json
{
  "main_search": "智能手机",
  "marketing_target": 1,
  "panel_type": 3,
  "min_fans_num": 100000,
  "max_fans_num": 1000000,
  "min_play_median": 50000,
  "play_median_traffic_type": 1,
  "play_median_cycle": 3,
  "goods_ctr_type": 1,
  "order_by": "play_median",
  "sort": "desc",
  "page": 1
}
```

## Request body

- UpperSearchBody: # [中文] ### 搜索方式: - `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 } ```
  - `nickname_or_mids` string, nullable: 按 UP 主昵称或 UID 搜索，多个关键词用英文逗号分隔 / Creator nickname or UID query; separate multiple terms with commas
  - `main_search` string, nullable: 按内容关键词搜索，命中稿件会随结果返回 / Content-keyword query; matched videos are included in the result
  - `mids` union[], nullable: 批量精确匹配的 UP 主 UID 列表 / List of creator UIDs to match exactly
    - union
      - integer
      - string
  - `upper_mid` union: 单个 UP 主 UID 精确筛选 / Single creator UID for an exact match
    - integer
    - string
  - `folder_id` union: 已保存 UP 主文件夹 ID，用于限定文件夹内搜索 / Saved-creator folder ID used to limit the search
    - integer
    - string
  - `marketing_target` integer, nullable: 营销目标：1=品牌曝光，2=心智种草，3=效果转化 / Marketing objective: 1=brand awareness, 2=consideration, 3=conversion
  - `panel_type` integer, nullable: 行业策略面板：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
  - `order_by` string, nullable: 排序字段，例如 fans_num、play_median、interactive_rate / Sort field, such as fans_num, play_median, or interactive_rate
  - `sort` string, nullable: 排序方向：desc=降序，asc=升序 / Sort direction: desc=descending, asc=ascending
  - `page` integer, nullable: 页码，从 1 开始，每页返回 20 条 / One-based page number; each page returns 20 records
  - `request_id` string, nullable: 搜索会话标识；同组条件翻页时复用，留空则生成新值 / Search-session ID; reuse it across pages of the same filter set
  - `gender` string, nullable: UP 主性别，取值见 /api/v1/bilibili/huahuo/square_static_info 返回的 gender_info / Creator gender from gender_info returned by /api/v1/bilibili/huahuo/square_static_info
  - `min_fans_num` union: 粉丝数下限（含）/ Minimum follower count, inclusive
    - integer
    - string
  - `max_fans_num` union: 粉丝数上限（含）/ Maximum follower count, inclusive
    - integer
    - string
  - `region_id` union[], nullable: 先调用 /api/v1/bilibili/huahuo/region_drop；把选中一级地域的 value 放入此数组 / Call /api/v1/bilibili/huahuo/region_drop first, then put selected primary-region values in this array
    - union
      - integer
      - string
  - `second_region_id` union[], nullable: 先调用 /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
    - union
      - integer
      - string
  - `partition_id` union: 内容一级分区 ID，取值见 /api/v1/bilibili/huahuo/partition_drop / Primary content-category ID from /api/v1/bilibili/huahuo/partition_drop
    - integer
    - string
  - `second_partition_id` union[], nullable: 内容二级分区 ID 列表，取值见 /api/v1/bilibili/huahuo/partition_drop / Secondary content-category IDs from /api/v1/bilibili/huahuo/partition_drop
    - union
      - integer
      - string
  - `mcn_ids` union[], nullable: MCN 机构 ID 列表，取值见 /api/v1/bilibili/huahuo/mcn_drop / MCN organization IDs from /api/v1/bilibili/huahuo/mcn_drop
    - union
      - integer
      - string
  - `provider_id` union[], nullable: 服务商 ID 列表，使用花火筛选项的可选值 / Service-provider IDs using values offered by the Huahuo filter
    - union
      - integer
      - string
  - `upper_types` union[], nullable: 账号类型：1或4=机构签约，3=个人 / Creator type: 1 or 4=MCN-affiliated, 3=independent
    - union
      - integer
      - string
  - `only_contract` integer, nullable: 仅看可签约账号：1=是，0=不限 / Contract-eligible filter: 1=only eligible creators, 0=all
  - `is_painter_order` boolean, nullable: 是否筛选画师约稿能力 / Whether to require illustration-commission capability
  - `fans_age_tag` string[], nullable: 粉丝年龄倾向标签，取值见 /api/v1/bilibili/huahuo/square_static_info / Audience age-affinity tags from /api/v1/bilibili/huahuo/square_static_info
  - `fans_gender_tag` string[], nullable: 粉丝性别倾向标签，取值见 /api/v1/bilibili/huahuo/square_static_info / Audience gender-affinity tags from /api/v1/bilibili/huahuo/square_static_info
  - `fans_region_tag` string[], nullable: 粉丝地域倾向标签，取值见 /api/v1/bilibili/huahuo/square_static_info / Audience region-affinity tags from /api/v1/bilibili/huahuo/square_static_info
  - `fans_stick` integer, nullable: 粉丝黏性筛选值，0=不限，其他值取自静态筛选项 / Follower-loyalty filter; 0=all, otherwise use a static-option value
  - `av_active` integer, nullable: 近期投稿活跃开关：1=启用，0=不限 / Recent-publishing activity switch: 1=enabled, 0=all
  - `av_active_tag` string, nullable: 近期投稿活跃档位，取值见 /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
  - `dmp_group_id` union: DMP 自定义人群包 ID，取值见 /api/v1/bilibili/huahuo/dmp_pkg_list / DMP custom audience-package ID from /api/v1/bilibili/huahuo/dmp_pkg_list
    - integer
    - string
  - `category_dmp_group_id` union: 内容类目 DMP 人群包 ID / Content-category DMP audience-package ID
    - integer
    - string
  - `category_dmp_label` string, nullable: 内容类目 DMP 人群包展示名称 / Display label for the content-category DMP audience package
  - `dmp_pkg_name` string, nullable: DMP 特殊人群包名称关键词 / DMP special-audience package name query
  - `dmp_pkg_vertical_rate_gte` union: DMP 人群垂直度下限：相关视频数占总视频数比例 / Minimum DMP verticality: matching videos divided by all videos
    - integer
    - number
    - string
  - `dmp_pkg_vertical_rate_lte` union: DMP 人群垂直度上限：相关视频数占总视频数比例 / Maximum DMP verticality: matching videos divided by all videos
    - integer
    - number
    - string
  - `dmp_pkg_effect_rate_gte` union: DMP 人群影响力下限：近30天相关观众占该人群总量比例 / Minimum DMP influence: recent matching viewers divided by the audience population
    - integer
    - number
    - string
  - `dmp_pkg_effect_rate_lte` union: DMP 人群影响力上限：近30天相关观众占该人群总量比例 / Maximum DMP influence: recent matching viewers divided by the audience population
    - integer
    - number
    - string
  - `dmp_pkg_fan_rate_gte` union: DMP 人群关注度下限：粉丝中该人群占比 / Minimum DMP attention: matching audience members divided by all followers
    - integer
    - number
    - string
  - `dmp_pkg_fan_rate_lte` union: DMP 人群关注度上限：粉丝中该人群占比 / Maximum DMP attention: matching audience members divided by all followers
    - integer
    - number
    - string
  - `min_task_price` union: 标准合作报价下限，单位为人民币元 / Minimum standard cooperation quote in RMB
    - integer
    - number
    - string
  - `max_task_price` union: 标准合作报价上限，单位为人民币元 / Maximum standard cooperation quote in RMB
    - integer
    - number
    - string
  - `price_info` UpperPriceFilter[], nullable: 合作报价筛选数组；先调用 /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
    - `cooperation_type` union: 合作类型：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
      - integer
      - string
    - `creative_skill` integer[], nullable: 深度定制的创作技能 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
    - `include_content` integer[], nullable: 定制视频、深度定制或播客专题定制的包含内容 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
    - `price_min` union: 该合作形式的报价下限，单位为人民币元；预设区间见 /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
      - integer
      - number
      - string
    - `price_max` union: 该合作形式的报价上限，单位为人民币元；预设区间见 /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
      - integer
      - number
      - string
    - `price_right` string[], nullable: 合作权益代码数组，例如 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
  - `last_7_days_set_price` integer, nullable: 近7天是否设置过报价：1=是，0=不限 / Quote-updated-in-7-days filter: 1=yes, 0=all
  - `last_14_days_set_price` integer, nullable: 近14天是否设置过报价：1=是，0=不限 / Quote-updated-in-14-days filter: 1=yes, 0=all
  - `last_30_days_set_price` integer, nullable: 近30天是否设置过报价：1=是，0=不限 / Quote-updated-in-30-days filter: 1=yes, 0=all
  - `min_interact_rate` union: 互动率下限；近180天合格原创稿件互动量除以播放量 / Minimum engagement rate for eligible original videos in the last 180 days
    - integer
    - number
    - string
  - `max_interact_rate` union: 互动率上限；近180天合格原创稿件互动量除以播放量 / Maximum engagement rate for eligible original videos in the last 180 days
    - integer
    - number
    - string
  - `blue_url_ctr_gte` union: 蓝链点击率下限，即蓝链点击量除以视频播放量 / Minimum blue-link CTR, blue-link clicks divided by video views
    - integer
    - number
    - string
  - `blue_url_ctr_lt` union: 蓝链点击率上限，即蓝链点击量除以视频播放量 / Maximum blue-link CTR, blue-link clicks divided by video views
    - integer
    - number
    - string
  - `blue_url_click_cost_gte` union: 蓝链点击成本下限，即合作及投流花费除以蓝链点击量 / Minimum blue-link click cost, cooperation and promotion spend divided by clicks
    - integer
    - number
    - string
  - `blue_url_click_cost_lt` union: 蓝链点击成本上限，即合作及投流花费除以蓝链点击量 / Maximum blue-link click cost, cooperation and promotion spend divided by clicks
    - integer
    - number
    - string
  - `min_play_median` union: 播放量中位数下限；统计近180天且发布满7天的合格原创稿件 / Minimum median views for eligible original videos published at least seven days ago
    - integer
    - number
    - string
  - `max_play_median` union: 播放量中位数上限；统计近180天且发布满7天的合格原创稿件 / Maximum median views for eligible original videos published at least seven days ago
    - integer
    - number
    - string
  - `play_median_traffic_type` integer, nullable: 播放中位数流量口径：1=全部流量，2=自然流量 / Median-view traffic scope: 1=all traffic, 2=organic traffic
  - `play_median_cycle` integer, nullable: 播放中位数统计周期：1=7天，2=15天，3=30天 / Median-view window: 1=7 days, 2=15 days, 3=30 days
  - `min_cpm` union: CPM 下限，即花费除以播放量再乘1000 / Minimum CPM, calculated as spend divided by views times 1,000
    - integer
    - number
    - string
  - `max_cpm` union: CPM 上限，即花费除以播放量再乘1000 / Maximum CPM, calculated as spend divided by views times 1,000
    - integer
    - number
    - string
  - `cpm_type` integer, nullable: CPM 流量口径：1=全部流量，2=自然流量 / CPM traffic scope: 1=all traffic, 2=organic traffic
  - `cpm_cycle` integer, nullable: CPM 统计周期：1=7天，2=15天，3=30天 / CPM window: 1=7 days, 2=15 days, 3=30 days
  - `min_cpc` union: CPC 下限，即花费除以组件点击次数 / Minimum CPC, calculated as spend divided by component clicks
    - integer
    - number
    - string
  - `max_cpc` union: CPC 上限，即花费除以组件点击次数 / Maximum CPC, calculated as spend divided by component clicks
    - integer
    - number
    - string
  - `cpc_traffic_type` integer, nullable: CPC 流量口径：1=全部流量，2=自然流量 / CPC traffic scope: 1=all traffic, 2=organic traffic
  - `cpc_cycle` integer, nullable: CPC 统计周期：1=7天，2=15天，3=30天 / CPC window: 1=7 days, 2=15 days, 3=30 days
  - `cpe_gte` union: CPE 下限，即花费除以有效互动次数 / Minimum CPE, calculated as spend divided by valid engagements
    - integer
    - number
    - string
  - `cpe_lt` union: CPE 上限，即花费除以有效互动次数 / Maximum CPE, calculated as spend divided by valid engagements
    - integer
    - number
    - string
  - `cpe_traffic_type` integer, nullable: CPE 流量口径：1=全部流量，2=自然流量 / CPE traffic scope: 1=all traffic, 2=organic traffic
  - `cpe_cycle` integer, nullable: CPE 统计周期：1=7天，3=30天 / CPE window: 1=7 days, 3=30 days
  - `draft_duration` union: 主流视频时长：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
    - integer
    - string
  - `min_avid_cnt` union: 近90天有效原创稿件数下限 / Minimum eligible original-video count in the last 90 days
    - integer
    - string
  - `max_avid_cnt` union: 近90天有效原创稿件数上限 / Maximum eligible original-video count in the last 90 days
    - integer
    - string
  - `min_hot_avid_rate` union: 近90天爆款稿件占比下限 / Minimum viral-video ratio in the last 90 days
    - integer
    - number
    - string
  - `max_hot_avid_rate` union: 近90天爆款稿件占比上限 / Maximum viral-video ratio in the last 90 days
    - integer
    - number
    - string
  - `half_min_hot_avid_cnt` union: 近半年爆款稿件数下限 / Minimum viral-video count in the last six months
    - integer
    - string
  - `half_max_hot_avid_cnt` union: 近半年爆款稿件数上限 / Maximum viral-video count in the last six months
    - integer
    - string
  - `entry_cost_min` union: 近一年相关合作的进店成本下限 / Minimum store-entry cost for relevant cooperation in the last year
    - integer
    - number
    - string
  - `entry_cost_max` union: 近一年相关合作的进店成本上限 / Maximum store-entry cost for relevant cooperation in the last year
    - integer
    - number
    - string
  - `av_honor` UpperHonorFilter: UP 主稿件荣誉筛选 / Creator video-honor filter.
    - `honor_type` string[], nullable: 荣誉类型数组，可多选：HOT=热门、MZBK=每周必看、QZPHB=全站排行榜 / Multi-select honor types: HOT, MZBK, and QZPHB
    - `time_period` integer, nullable: 统计周期：0=不限，30/90/180=近对应天数 / Time period: 0=all, or the most recent 30, 90, or 180 days
    - `honor_count` integer, nullable: 获奖次数：0=不限，1=1次，2=2次，3=3次及以上 / Honor count: 0=all, 1=once, 2=twice, 3=three or more
  - `cooperate_experience_industry_ids` union[], nullable: 非通用行业面板先调用 /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
    - union
      - integer
      - string
  - `cooperate_experience_type` union: 非通用行业策略面板的合作经验类型：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
    - integer
    - string
  - `special_tags` string[], nullable: 特色标签列表，取值见 /api/v1/bilibili/huahuo/square_static_info / Feature-tag values from /api/v1/bilibili/huahuo/square_static_info
  - `spark_tag` string[], nullable: 花火能力标签；通用面板合作次数使用 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
  - `square_tag_in` string[], nullable: 广场场景标签，例如 ad_partner_experienced / Marketplace scenario tags such as ad_partner_experienced
  - `label_array` array[], nullable: 先调用 /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
    - union[]
      - union
        - integer
        - string
  - `bdata_tag_lv5` unknown[], nullable: B站五级内容标签筛选值列表 / Bilibili level-five content-tag filter values
    - unknown
  - `huahuo_first_industry_ids` union[], nullable: 通用面板先调用 /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
    - union
      - integer
      - string
  - `huahuo_second_industry_ids` union[], nullable: 通用面板先调用 /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
    - union
      - integer
      - string
  - `huahuo_third_industry_ids` union[], nullable: 通用面板先调用 /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
    - union
      - integer
      - string
  - `goods_permission` integer, nullable: 带货权限筛选：1=有权限，0=不限 / Commerce permission filter: 1=required, 0=all
  - `goods_up_levels` union[], nullable: 带货 UP 主等级列表 / Commerce-creator level values
    - union
      - integer
      - string
  - `goods_category_first_ids` union[], nullable: 带货一级类目 ID 列表，取值见 /api/v1/bilibili/huahuo/effect_goods_drop / Primary commerce-category IDs from /api/v1/bilibili/huahuo/effect_goods_drop
    - union
      - integer
      - string
  - `goods_category_second_ids` union[], nullable: 带货二级类目 ID 列表，取值见 /api/v1/bilibili/huahuo/effect_goods_drop / Secondary commerce-category IDs from /api/v1/bilibili/huahuo/effect_goods_drop
    - union
      - integer
      - string
  - `goods_gpm_min` union: 近30天 GPM 下限，即每千次带货视频播放产生的支付 GMV / Minimum 30-day GPM, paid GMV per 1,000 commerce-video views
    - integer
    - number
    - string
  - `goods_gpm_max` union: 近30天 GPM 上限，即每千次带货视频播放产生的支付 GMV / Maximum 30-day GPM, paid GMV per 1,000 commerce-video views
    - integer
    - number
    - string
  - `goods_ctr_min` union: 带货组件点击率下限，即组件点击数除以曝光数 / Minimum commerce-component CTR, clicks divided by impressions
    - integer
    - number
    - string
  - `goods_ctr_max` union: 带货组件点击率上限，即组件点击数除以曝光数 / Maximum commerce-component CTR, clicks divided by impressions
    - integer
    - number
    - string
  - `goods_ctr_type` integer, nullable: 带货点击率组件口径：1=全部组件，2=评论区组件 / Commerce CTR component scope: 1=all components, 2=comment component
  - `goods_avg_price_min` union: 近30天商品平均价格下限，单位为人民币元 / Minimum average product price in the last 30 days, in RMB
    - integer
    - number
    - string
  - `goods_avg_price_max` union: 近30天商品平均价格上限，单位为人民币元 / Maximum average product price in the last 30 days, in RMB
    - integer
    - number
    - string
  - `goods_is_high_video_play_permeate` union: 高视频播放渗透筛选，近30天播放用户占粉丝数比例居前20% / High video-view penetration filter, top 20% by recent viewers per follower
    - integer
    - string
  - `goods_is_high_fans_play_permeate` union: 高粉丝播放渗透筛选 / High follower-view penetration filter
    - integer
    - string
  - `is_boosting` integer, nullable: 是否筛选内容加热中的 UP 主：1=是，0=不限 / Boosting-status filter: 1=currently boosting, 0=all
  - `is_treasure_up` union: 是否筛选宝藏 UP 主 / Whether to filter for treasure creators
    - integer
    - string
  - `is_timely_response` union: 是否筛选及时响应的 UP 主 / Whether to require timely-response creators
    - integer
    - string
  - `is_new_enter` union: 是否筛选新入驻 UP 主 / Whether to filter for newly onboarded creators
    - integer
    - string
  - `custom_video_pricing_set` union: 是否已设置定制视频报价 / Whether custom-video pricing has been configured
    - integer
    - string
  - `is_x_plan_better_up` union: 是否筛选 X 计划优选 UP 主 / Whether to filter for X Plan preferred creators
    - integer
    - string
  - `high_potential_type` integer, nullable: 高潜类型：0=全部，1=已入驻，2=未入驻 / High-potential type: 0=all, 1=onboarded, 2=not onboarded

## Response `200`

Successful Response

- ResponseModel
  - `code` integer: HTTP status code | HTTP状态码
  - `request_id` string, nullable: Unique request identifier | 唯一请求标识符
  - `message` string: Response message (EN-US) | 响应消息 (English)
  - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文)
  - `support` string: Support message | 支持消息
  - `time` string: The time the response was generated | 生成响应的时间
  - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳
  - `time_zone` string: The timezone of the response time | 响应时间的时区
  - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接
  - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English)
  - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文)
  - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL
  - `router` string: The endpoint that generated this response | 生成此响应的端点
  - `params` unknown
  - `data` unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-08** `96a122a5f220`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-09-07** `d25a8fa949ad`: 3 breaking, 3 info
  - request property `av_honor/anyOf[subschema #1: UpperHonorFilter]/honor_type` list-of-types was narrowed by removing types `string` from media type `application/json`
  - the `av_honor/anyOf[subschema #1: UpperHonorFilter]/honor_type/anyOf[subschema #1]/` request property type changed from `string` to `array`
  - the `label_array/anyOf[subschema #1]/items/` request property type changed from no type to `array`
  - added `subschema #1, subschema #2` to the `price_info/anyOf[subschema #1]/items/creative_skill` request property `anyOf` list
  - …2 more
- **2026-09-05** `eab99e8bfe5b`: 90 info
  - added the new optional request property `av_active`
  - added the new optional request property `av_active_tag`
  - added the new optional request property `av_honor`
  - added the new optional request property `bdata_tag_lv5`
  - …86 more
- **2026-09-01** `50f9ec6e1cd3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/bilibili/huahuo/search_upper/post.md)

---

[API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)