B站花火 · UP主广场搜索(搜UP主 / 搜内容)
/bilibili_huahuo_search_upperUP主广场搜索(搜UP主 / 搜内容)。按原始筛选条件读取社交媒体数据,并显式使用分页参数。
- 最近 7 天完成的调用
- 0
统计不包含取消的调用。执行时间仅统计成功调用。
通过你的 Agent 使用
请安装 https://www.agentrouter.to/SKILL.md,然后通过 AgentRouter 使用 TikHub 的 /bilibili_huahuo_search_upper 接口。
输入参数
nickname_or_mids选填- 按 UP 主昵称或 UID 搜索,多个关键词用英文逗号分隔
main_search选填- 按内容关键词搜索,命中稿件会随结果返回
mids选填- 批量精确匹配的 UP 主 UID 列表
upper_mid选填- 单个 UP 主 UID 精确筛选
folder_id选填- 已保存 UP 主文件夹 ID,用于限定文件夹内搜索
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选填- 搜索会话标识;同组条件翻页时复用,留空则生成新值
gender选填- UP 主性别,取值见 /api/v1/bilibili/huahuo/square_static_info 返回的 gender_info
min_fans_num选填- 粉丝数下限(含)
max_fans_num选填- 粉丝数上限(含)
region_id选填- 先调用 /api/v1/bilibili/huahuo/region_drop;把选中一级地域的 value 放入此数组
second_region_id选填- 先调用 /api/v1/bilibili/huahuo/region_drop;把选中一级地域 children 中的二级 value 放入此数组
partition_id选填- 内容一级分区 ID,取值见 /api/v1/bilibili/huahuo/partition_drop
second_partition_id选填- 内容二级分区 ID 列表,取值见 /api/v1/bilibili/huahuo/partition_drop
mcn_ids选填- MCN 机构 ID 列表,取值见 /api/v1/bilibili/huahuo/mcn_drop
provider_id选填- 服务商 ID 列表,使用花火筛选项的可选值
upper_types选填- 账号类型:1或4=机构签约,3=个人
only_contract选填- 仅看可签约账号:1=是,0=不限
is_painter_order选填- 是否筛选画师约稿能力
fans_age_tag选填- 粉丝年龄倾向标签,取值见 /api/v1/bilibili/huahuo/square_static_info
fans_gender_tag选填- 粉丝性别倾向标签,取值见 /api/v1/bilibili/huahuo/square_static_info
fans_region_tag选填- 粉丝地域倾向标签,取值见 /api/v1/bilibili/huahuo/square_static_info
fans_stick选填- 粉丝黏性筛选值,0=不限,其他值取自静态筛选项
av_active选填- 近期投稿活跃开关:1=启用,0=不限
av_active_tag选填- 近期投稿活跃档位,取值见 /api/v1/bilibili/huahuo/square_static_info 返回的 av_active_tag
dmp_group_id选填- DMP 自定义人群包 ID,取值见 /api/v1/bilibili/huahuo/dmp_pkg_list
category_dmp_group_id选填- 内容类目 DMP 人群包 ID
category_dmp_label选填- 内容类目 DMP 人群包展示名称
dmp_pkg_name选填- DMP 特殊人群包名称关键词
dmp_pkg_vertical_rate_gte选填- DMP 人群垂直度下限:相关视频数占总视频数比例
dmp_pkg_vertical_rate_lte选填- DMP 人群垂直度上限:相关视频数占总视频数比例
dmp_pkg_effect_rate_gte选填- DMP 人群影响力下限:近30天相关观众占该人群总量比例
dmp_pkg_effect_rate_lte选填- DMP 人群影响力上限:近30天相关观众占该人群总量比例
dmp_pkg_fan_rate_gte选填- DMP 人群关注度下限:粉丝中该人群占比
dmp_pkg_fan_rate_lte选填- DMP 人群关注度上限:粉丝中该人群占比
min_task_price选填- 标准合作报价下限,单位为人民币元
max_task_price选填- 标准合作报价上限,单位为人民币元
price_info选填- 合作报价筛选数组;先调用 /api/v1/bilibili/huahuo/square_static_info 并读取 price_info_options,每次搜索传一个合作类型,每项固定包含六个字段,不适用或未选择的数组传 []
last_7_days_set_price选填- 近7天是否设置过报价:1=是,0=不限
last_14_days_set_price选填- 近14天是否设置过报价:1=是,0=不限
last_30_days_set_price选填- 近30天是否设置过报价:1=是,0=不限
min_interact_rate选填- 互动率下限;近180天合格原创稿件互动量除以播放量
max_interact_rate选填- 互动率上限;近180天合格原创稿件互动量除以播放量
blue_url_ctr_gte选填- 蓝链点击率下限,即蓝链点击量除以视频播放量
blue_url_ctr_lt选填- 蓝链点击率上限,即蓝链点击量除以视频播放量
blue_url_click_cost_gte选填- 蓝链点击成本下限,即合作及投流花费除以蓝链点击量
blue_url_click_cost_lt选填- 蓝链点击成本上限,即合作及投流花费除以蓝链点击量
min_play_median选填- 播放量中位数下限;统计近180天且发布满7天的合格原创稿件
max_play_median选填- 播放量中位数上限;统计近180天且发布满7天的合格原创稿件
play_median_traffic_type选填- 播放中位数流量口径:1=全部流量,2=自然流量
play_median_cycle选填- 播放中位数统计周期:1=7天,2=15天,3=30天
min_cpm选填- CPM 下限,即花费除以播放量再乘 1000(1,000)。
max_cpm选填- CPM 上限,即花费除以播放量再乘 1000(1,000)。
cpm_type选填- CPM 流量口径:1=全部流量,2=自然流量
cpm_cycle选填- CPM 统计周期:1=7天,2=15天,3=30天
min_cpc选填- CPC 下限,即花费除以组件点击次数
max_cpc选填- CPC 上限,即花费除以组件点击次数
cpc_traffic_type选填- CPC 流量口径:1=全部流量,2=自然流量
cpc_cycle选填- CPC 统计周期:1=7天,2=15天,3=30天
cpe_gte选填- CPE 下限,即花费除以有效互动次数
cpe_lt选填- CPE 上限,即花费除以有效互动次数
cpe_traffic_type选填- CPE 流量口径:1=全部流量,2=自然流量
cpe_cycle选填- CPE 统计周期: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选填- 近90天有效原创稿件数下限
max_avid_cnt选填- 近90天有效原创稿件数上限
min_hot_avid_rate选填- 近90天爆款稿件占比下限
max_hot_avid_rate选填- 近90天爆款稿件占比上限
half_min_hot_avid_cnt选填- 近半年爆款稿件数下限
half_max_hot_avid_cnt选填- 近半年爆款稿件数上限
entry_cost_min选填- 近一年相关合作的进店成本下限
entry_cost_max选填- 近一年相关合作的进店成本上限
av_honor选填- 稿件荣誉没有独立选项接口,取值见 search_upper 文档;honor_type 始终为可多选数组
cooperate_experience_industry_ids选填- 非通用行业面板先调用 /api/v1/bilibili/huahuo/cooperate_experience_industry,再把选中行业 ID 放入此数组;通用面板不使用此字段
cooperate_experience_type选填- 非通用行业策略面板的合作经验类型:1=有当前行业经验,2=当前行业经验丰富,3=无当前行业经验,4=有其他行业经验;选择行业时仅使用1或2,通用面板改用 spark_tag
special_tags选填- 特色标签列表,取值见 /api/v1/bilibili/huahuo/square_static_info
spark_tag选填- 花火能力标签;通用面板合作次数使用 cooperate=有合作经验或 coo_frequent=合作经验丰富,并与 /api/v1/bilibili/huahuo/square_static_info 返回的行业树字段配合使用
square_tag_in选填- 广场场景标签,例如 ad_partner_experienced
label_array选填- 先调用 /api/v1/bilibili/huahuo/upper_label_tree;把内容类型分组中所有已选节点的 value 放入同一个内层数组
bdata_tag_lv5选填- B站五级内容标签筛选值列表
huahuo_first_industry_ids选填- 通用面板先调用 /api/v1/bilibili/huahuo/square_static_info;把 industry_tree 选中路径的一级 ID 放入此数组
huahuo_second_industry_ids选填- 通用面板先调用 /api/v1/bilibili/huahuo/square_static_info;把 industry_tree 选中路径的二级 ID 放入此数组
huahuo_third_industry_ids选填- 通用面板先调用 /api/v1/bilibili/huahuo/square_static_info;把 industry_tree 选中路径的三级 ID 放入此数组
goods_permission选填- 带货权限筛选:1=有权限,0=不限
goods_up_levels选填- 带货 UP 主等级列表
goods_category_first_ids选填- 带货一级类目 ID 列表,取值见 /api/v1/bilibili/huahuo/effect_goods_drop
goods_category_second_ids选填- 带货二级类目 ID 列表,取值见 /api/v1/bilibili/huahuo/effect_goods_drop
goods_gpm_min选填- 近 30 天 GPM 下限,即每千次(1,000 次)带货视频播放产生的支付 GMV。
goods_gpm_max选填- 近 30 天 GPM 上限,即每千次(1,000 次)带货视频播放产生的支付 GMV。
goods_ctr_min选填- 带货组件点击率下限,即组件点击数除以曝光数
goods_ctr_max选填- 带货组件点击率上限,即组件点击数除以曝光数
goods_ctr_type选填- 带货点击率组件口径:1=全部组件,2=评论区组件
goods_avg_price_min选填- 近30天商品平均价格下限,单位为人民币元
goods_avg_price_max选填- 近30天商品平均价格上限,单位为人民币元
goods_is_high_video_play_permeate选填- 高视频播放渗透筛选,近30天播放用户占粉丝数比例居前20%
goods_is_high_fans_play_permeate选填- 高粉丝播放渗透筛选
is_boosting选填- 是否筛选内容加热中的 UP 主:1=是,0=不限
is_treasure_up选填- 是否筛选宝藏 UP 主
is_timely_response选填- 是否筛选及时响应的 UP 主
is_new_enter选填- 是否筛选新入驻 UP 主
custom_video_pricing_set选填- 是否已设置定制视频报价
is_x_plan_better_up选填- 是否筛选 X 计划优选 UP 主
high_potential_type选填- 高潜类型:0=全部,1=已入驻,2=未入驻
输入示例
{
"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
}输出
原生社交数据和分页信息。超出安全整数范围的 ID 以字符串返回。请显式使用返回的游标继续读取;每一页都是一次新请求。