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

