ae_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}}

