主题
语言
POST每次请求 $0.013 · 每 1,000 次请求 $13.00

搜索主播

搜索 Huahuo 创作者或内容

Endpoint

POST https://getvibeapi.com/v1/social/bilibili/huahuo/search_upper

示例

curl -sS "https://getvibeapi.com/v1/social/bilibili/huahuo/search_upper" \
  -H "Authorization: Bearer $GETVIBE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{}'

在 Authorization: Bearer header 中发送你的密钥。你只需为数据提供商接受的请求付费。被拒绝的请求（错误、超时、无效参数）不会计费。平台返回空结果或未找到结果的有效请求将计费。

参数

nickname_or_mids

body · 字符串

创作者昵称或 UID 查询；多个词使用逗号分隔

main_search

body · 字符串

内容关键词查询；匹配的视频将包含在结果中

mids

body · 数组

需要精确匹配的创作者 UID 列表

upper_mid

body · 整数

用于精确匹配的单个创作者 UID

folder_id

body · 整数

用于限制搜索范围的已保存创作者文件夹 ID

marketing_target

body · 整数

Marketing objective: 1=brand awareness, 2=consideration, 3=conversion

panel_type

body · 整数

Strategy panel: 0=general, 1=gaming, 2=beauty, 3=digital, 4=automotive, 5=performance, 6=food, 8=internet

order_by

body · 字符串

排序字段，例如 fans_num、play_median 或 interactive_rate

sort

body · 字符串

Sort direction: desc=descending, asc=ascending

page

body · 整数

从 1 开始的页码；每页返回 20 条记录

request_id

body · 字符串

搜索会话 ID；在同一筛选条件集的不同页面之间重复使用

gender

body · 字符串

来自 /api/v1/bilibili/huahuo/square_static_info 返回的 gender_info 的创作者性别

min_fans_num

body · 整数

最低粉丝数（包含边界值）

max_fans_num

body · 整数

最高粉丝数（包含边界值）

region_id

body · 数组

先调用 /api/v1/bilibili/huahuo/region_drop，然后将选中的一级区域值放入此数组

second_region_id

body · 数组

先调用 /api/v1/bilibili/huahuo/region_drop，然后将选中的子区域值放入此数组

partition_id

body · 整数

api/v1/bilibili/huahuo/partition_drop / 来自 /api/v1/bilibili/huahuo/partition_drop 的一级内容类目 ID

second_partition_id

body · 数组

api/v1/bilibili/huahuo/partition_drop / 来自 /api/v1/bilibili/huahuo/partition_drop 的二级内容类目 ID

mcn_ids

body · 数组

api/v1/bilibili/huahuo/mcn_drop / 来自 /api/v1/bilibili/huahuo/mcn_drop 的 MCN 机构 ID

provider_id

body · 数组

使用 Huahuo 筛选器提供的值的服务提供商 ID

upper_types

body · 数组

Creator type: 1 or 4=MCN-affiliated, 3=independent

only_contract

body · 整数

合同符合条件筛选：1=仅符合条件的创作者，0=全部

is_painter_order

body · 布尔值

是否要求具备插画委托能力

fans_age_tag

body · 数组

api/v1/bilibili/huahuo/square_static_info / 来自 /api/v1/bilibili/huahuo/square_static_info 的受众年龄偏好标签

fans_gender_tag

body · 数组

api/v1/bilibili/huahuo/square_static_info / 来自 /api/v1/bilibili/huahuo/square_static_info 的受众性别偏好标签

fans_region_tag

body · 数组

api/v1/bilibili/huahuo/square_static_info / 来自 /api/v1/bilibili/huahuo/square_static_info 的受众地区偏好标签

fans_stick

body · 整数

粉丝忠诚度筛选；0=全部，否则使用静态选项值

av_active

body · 整数

近期发布活动开关：1=启用，0=全部

av_active_tag

body · 字符串

近期发布活动等级，来自 /api/v1/bilibili/huahuo/square_static_info 返回的 av_active_tag

dmp_group_id

body · 整数

api/v1/bilibili/huahuo/dmp_pkg_list / 来自 /api/v1/bilibili/huahuo/dmp_pkg_list 的 DMP 自定义受众包 ID

category_dmp_group_id

body · 整数

内容类别 DMP 受众包 ID

category_dmp_label

body · 字符串

内容类别 DMP 受众包的显示标签

dmp_pkg_name

body · 字符串

DMP 特殊受众包名称查询

dmp_pkg_vertical_rate_gte

body · 整数

最低 DMP 垂直度：匹配视频数除以全部视频数

dmp_pkg_vertical_rate_lte

body · 整数

最高 DMP 垂直度：匹配视频数除以全部视频数

dmp_pkg_effect_rate_gte

body · 整数

最低 DMP 影响力：近期匹配观看者数除以受众规模

dmp_pkg_effect_rate_lte

body · 整数

最高 DMP 影响力：近期匹配观看者数除以受众规模

dmp_pkg_fan_rate_gte

body · 整数

最低 DMP 关注度：匹配受众成员数除以全部粉丝数

dmp_pkg_fan_rate_lte

body · 整数

最高 DMP 关注度：匹配受众成员数除以全部粉丝数

min_task_price

body · 整数

最低标准合作报价，单位为 RMB

max_task_price

body · 整数

最高标准合作报价，单位为 RMB

price_info

body · 数组

来自 /api/v1/bilibili/huahuo/square_static_info 返回的 price_info_options 的合作报价筛选条件；每次搜索发送一个类型，包含全部六个字段，不可用的数组使用 []

last_7_days_set_price

body · 整数

Quote-updated-in-7-days filter: 1=yes, 0=all

last_14_days_set_price

body · 整数

Quote-updated-in-14-days filter: 1=yes, 0=all

last_30_days_set_price

body · 整数

Quote-updated-in-30-days filter: 1=yes, 0=all

min_interact_rate

body · 整数

过去 180 天符合条件的原创视频的最低互动率

max_interact_rate

body · 整数

过去 180 天符合条件的原创视频的最高互动率

blue_url_ctr_gte

body · 整数

最低蓝链 CTR，蓝链点击次数除以视频观看次数

blue_url_ctr_lt

body · 整数

最高蓝链 CTR，蓝链点击次数除以视频观看次数

blue_url_click_cost_gte

body · 整数

最低蓝链点击成本，合作和推广支出除以点击次数

blue_url_click_cost_lt

body · 整数

最高蓝链点击成本，合作和推广支出除以点击次数

min_play_median

body · 整数

发布时间至少七天的符合条件的原创视频的最低中位观看次数

max_play_median

body · 整数

发布时间至少七天的符合条件的原创视频的最高中位观看次数

play_median_traffic_type

body · 整数

中位观看量流量范围：1=全部流量，2=自然流量

play_median_cycle

body · 整数

中位观看量时间范围：1=7 天，2=15 天，3=30 天

min_cpm

body · 整数

最低 CPM，计算方式为支出除以观看次数再乘以 1,000

max_cpm

body · 整数

最高 CPM，计算方式为支出除以观看次数再乘以 1,000

cpm_type

body · 整数

CPM 流量范围：1=全部流量，2=自然流量

cpm_cycle

body · 整数

CPM 时间窗口：1=7 天，2=15 天，3=30 天

min_cpc

body · 整数

最低 CPC，计算方式为支出除以组件点击次数

max_cpc

body · 整数

最高 CPC，计算方式为支出除以组件点击次数

cpc_traffic_type

body · 整数

CPC 流量范围：1=全部流量，2=自然流量

cpc_cycle

body · 整数

CPC 窗口：1=7 天，2=15 天，3=30 天

cpe_gte

body · 整数

最低 CPE，计算方式为支出除以有效互动次数

cpe_lt

body · 整数

最高 CPE，计算方式为支出除以有效互动次数

cpe_traffic_type

body · 整数

CPE 流量范围：1=全部流量，2=自然流量

cpe_cycle

body · 整数

CPE 时间窗口：1=7 天，3=30 天

draft_duration

body · 整数

从少于 30 秒到超过 10 分钟的主要视频时长区间

min_avid_cnt

body · 整数

过去 90 天的最低符合条件的原创视频数量

max_avid_cnt

body · 整数

过去 90 天的最高符合条件的原创视频数量

min_hot_avid_rate

body · 整数

过去 90 天的最低爆款视频比例

max_hot_avid_rate

body · 整数

过去 90 天的最高爆款视频比例

half_min_hot_avid_cnt

body · 整数

过去六个月的最低爆款视频数量

half_max_hot_avid_cnt

body · 整数

过去六个月的最高爆款视频数量

entry_cost_min

body · 整数

过去一年相关合作的最低进店成本

entry_cost_max

body · 整数

过去一年相关合作的最高进店成本

av_honor

body · 对象

视频荣誉没有单独的选项接口；请使用 search_upper 文档，并始终将 honor_type 作为数组发送

cooperate_experience_industry_ids

body · 数组

对于非通用面板，先调用 /api/v1/bilibili/huahuo/cooperate_experience_industry，并将选中的 ID 填入此处；通用面板不使用

cooperate_experience_type

body · 整数

非通用策略面板的经验类型：1=有经验，2=经验丰富，3=当前行业无经验，4=其他行业有经验；选择行业时使用 1 或 2，通用面板使用 spark_tag

special_tags

body · 数组

api/v1/bilibili/huahuo/square_static_info / Feature-tag values from /api/v1/bilibili/huahuo/square_static_info

spark_tag

body · 数组

Huahuo 能力标签；通用面板合作次数使用 cooperate 或 coo_frequent，并结合 /api/v1/bilibili/huahuo/square_static_info 中的行业树值

square_tag_in

body · 数组

市场场景标签，例如 ad_partner_experienced

label_array

body · 数组

先调用 /api/v1/bilibili/huahuo/upper_label_tree，然后将所有选中的内容类型值放入一个内层数组

bdata_tag_lv5

body · 数组

Bilibili 五级内容标签筛选值

huahuo_first_industry_ids

body · 数组

对于通用面板，调用 /api/v1/bilibili/huahuo/square_static_info，并将选中的一级 industry_tree ID 填入此处

huahuo_second_industry_ids

body · 数组

对于通用面板，调用 /api/v1/bilibili/huahuo/square_static_info，并将选中的二级 industry_tree ID 填入此处

huahuo_third_industry_ids

body · 数组

对于通用面板，调用 /api/v1/bilibili/huahuo/square_static_info，并将选中的三级 industry_tree ID 填入此处

goods_permission

body · 整数

商业权限筛选：1=必需，0=全部

goods_up_levels

body · 数组

商业创作者等级值

goods_category_first_ids

body · 数组

api/v1/bilibili/huahuo/effect_goods_drop / 来自 /api/v1/bilibili/huahuo/effect_goods_drop 的一级商品类目 ID

goods_category_second_ids

body · 数组

api/v1/bilibili/huahuo/effect_goods_drop / 来自 /api/v1/bilibili/huahuo/effect_goods_drop 的二级商品类目 ID

goods_gpm_min

body · 整数

最低 30 天 GPM，每 1,000 次电商视频观看产生的付费 GMV

goods_gpm_max

body · 整数

最高 30 天 GPM，每 1,000 次电商视频观看产生的付费 GMV

goods_ctr_min

body · 整数

最低电商组件 CTR，点击次数除以展示次数

goods_ctr_max

body · 整数

最高电商组件 CTR，点击次数除以展示次数

goods_ctr_type

body · 整数

商业 CTR 组件范围：1=所有组件，2=评论组件

goods_avg_price_min

body · 整数

过去 30 天的最低平均商品价格，单位为 RMB

goods_avg_price_max

body · 整数

过去 30 天的最高平均商品价格，单位为 RMB

goods_is_high_video_play_permeate

body · 整数

高视频观看渗透率筛选器，按每位粉丝的近期观看者数量排名前 20%

goods_is_high_fans_play_permeate

body · 整数

高粉丝观看渗透率筛选器

is_boosting

body · 整数

加热状态筛选：1=当前正在加热，0=全部

is_treasure_up

body · 整数

是否筛选宝藏创作者

is_timely_response

body · 整数

是否要求及时响应的创作者

is_new_enter

body · 整数

是否筛选新入驻创作者

custom_video_pricing_set

body · 整数

是否已配置自定义视频定价

is_x_plan_better_up

body · 整数

是否筛选 X Plan 优选创作者

high_potential_type

body · 整数

High-potential type: 0=all, 1=onboarded, 2=not onboarded

获取 API 密钥所有 Bilibili 方法
搜索主播 — Bilibili API | GetVibe API