AgentRouter
Sign in
TikHubTikHub

B站花火 · 搜内容)/Search Huahuo creators or content

/bilibili_huahuo_search_upper

UP主广场搜索(搜UP主 / 搜内容)/Search Huahuo creators or content. Retrieve native social data with explicit pagination and original filters.

Finished calls, last 7 days
0

Cancellations excluded. Execution times cover successful calls.

Use it with your agent

Set up https://www.agentrouter.to/SKILL.md, then use TikHub’s /bilibili_huahuo_search_upper endpoint through AgentRouter.

Inputs

nickname_or_midsOptional
按 UP 主昵称或 UID 搜索,多个关键词用英文逗号分隔 / Creator nickname or UID query; separate multiple terms with commas
main_searchOptional
按内容关键词搜索,命中稿件会随结果返回 / Content-keyword query; matched videos are included in the result
midsOptional
批量精确匹配的 UP 主 UID 列表 / List of creator UIDs to match exactly
upper_midOptional
单个 UP 主 UID 精确筛选 / Single creator UID for an exact match
folder_idOptional
已保存 UP 主文件夹 ID,用于限定文件夹内搜索 / Saved-creator folder ID used to limit the search
marketing_targetOptional
营销目标:1=品牌曝光,2=心智种草,3=效果转化 / Marketing objective: 1=brand awareness, 2=consideration, 3=conversion
panel_typeOptional
行业策略面板: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_byOptional
排序字段,例如 fans_num、play_median、interactive_rate / Sort field, such as fans_num, play_median, or interactive_rate
sortOptional
排序方向:desc=降序,asc=升序 / Sort direction: desc=descending, asc=ascending
pageOptional
页码,从 1 开始,每页返回 20 条 / One-based page number; each page returns 20 records
request_idOptional
搜索会话标识;同组条件翻页时复用,留空则生成新值 / Search-session ID; reuse it across pages of the same filter set
genderOptional
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_numOptional
粉丝数下限(含)/ Minimum follower count, inclusive
max_fans_numOptional
粉丝数上限(含)/ Maximum follower count, inclusive
region_idOptional
先调用 /api/v1/bilibili/huahuo/region_drop;把选中一级地域的 value 放入此数组 / Call /api/v1/bilibili/huahuo/region_drop first, then put selected primary-region values in this array
second_region_idOptional
先调用 /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
partition_idOptional
内容一级分区 ID,取值见 /api/v1/bilibili/huahuo/partition_drop / Primary content-category ID from /api/v1/bilibili/huahuo/partition_drop
second_partition_idOptional
内容二级分区 ID 列表,取值见 /api/v1/bilibili/huahuo/partition_drop / Secondary content-category IDs from /api/v1/bilibili/huahuo/partition_drop
mcn_idsOptional
MCN 机构 ID 列表,取值见 /api/v1/bilibili/huahuo/mcn_drop / MCN organization IDs from /api/v1/bilibili/huahuo/mcn_drop
provider_idOptional
服务商 ID 列表,使用花火筛选项的可选值 / Service-provider IDs using values offered by the Huahuo filter
upper_typesOptional
账号类型:1或4=机构签约,3=个人 / Creator type: 1 or 4=MCN-affiliated, 3=independent
only_contractOptional
仅看可签约账号:1=是,0=不限 / Contract-eligible filter: 1=only eligible creators, 0=all
is_painter_orderOptional
是否筛选画师约稿能力 / Whether to require illustration-commission capability
fans_age_tagOptional
粉丝年龄倾向标签,取值见 /api/v1/bilibili/huahuo/square_static_info / Audience age-affinity tags from /api/v1/bilibili/huahuo/square_static_info
fans_gender_tagOptional
粉丝性别倾向标签,取值见 /api/v1/bilibili/huahuo/square_static_info / Audience gender-affinity tags from /api/v1/bilibili/huahuo/square_static_info
fans_region_tagOptional
粉丝地域倾向标签,取值见 /api/v1/bilibili/huahuo/square_static_info / Audience region-affinity tags from /api/v1/bilibili/huahuo/square_static_info
fans_stickOptional
粉丝黏性筛选值,0=不限,其他值取自静态筛选项 / Follower-loyalty filter; 0=all, otherwise use a static-option value
av_activeOptional
近期投稿活跃开关:1=启用,0=不限 / Recent-publishing activity switch: 1=enabled, 0=all
av_active_tagOptional
近期投稿活跃档位,取值见 /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_idOptional
DMP 自定义人群包 ID,取值见 /api/v1/bilibili/huahuo/dmp_pkg_list / DMP custom audience-package ID from /api/v1/bilibili/huahuo/dmp_pkg_list
category_dmp_group_idOptional
内容类目 DMP 人群包 ID / Content-category DMP audience-package ID
category_dmp_labelOptional
内容类目 DMP 人群包展示名称 / Display label for the content-category DMP audience package
dmp_pkg_nameOptional
DMP 特殊人群包名称关键词 / DMP special-audience package name query
dmp_pkg_vertical_rate_gteOptional
DMP 人群垂直度下限:相关视频数占总视频数比例 / Minimum DMP verticality: matching videos divided by all videos
dmp_pkg_vertical_rate_lteOptional
DMP 人群垂直度上限:相关视频数占总视频数比例 / Maximum DMP verticality: matching videos divided by all videos
dmp_pkg_effect_rate_gteOptional
DMP 人群影响力下限:近30天相关观众占该人群总量比例 / Minimum DMP influence: recent matching viewers divided by the audience population
dmp_pkg_effect_rate_lteOptional
DMP 人群影响力上限:近30天相关观众占该人群总量比例 / Maximum DMP influence: recent matching viewers divided by the audience population
dmp_pkg_fan_rate_gteOptional
DMP 人群关注度下限:粉丝中该人群占比 / Minimum DMP attention: matching audience members divided by all followers
dmp_pkg_fan_rate_lteOptional
DMP 人群关注度上限:粉丝中该人群占比 / Maximum DMP attention: matching audience members divided by all followers
min_task_priceOptional
标准合作报价下限,单位为人民币元 / Minimum standard cooperation quote in RMB
max_task_priceOptional
标准合作报价上限,单位为人民币元 / Maximum standard cooperation quote in RMB
price_infoOptional
合作报价筛选数组;先调用 /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
last_7_days_set_priceOptional
近7天是否设置过报价:1=是,0=不限 / Quote-updated-in-7-days filter: 1=yes, 0=all
last_14_days_set_priceOptional
近14天是否设置过报价:1=是,0=不限 / Quote-updated-in-14-days filter: 1=yes, 0=all
last_30_days_set_priceOptional
近30天是否设置过报价:1=是,0=不限 / Quote-updated-in-30-days filter: 1=yes, 0=all
min_interact_rateOptional
互动率下限;近180天合格原创稿件互动量除以播放量 / Minimum engagement rate for eligible original videos in the last 180 days
max_interact_rateOptional
互动率上限;近180天合格原创稿件互动量除以播放量 / Maximum engagement rate for eligible original videos in the last 180 days
blue_url_ctr_gteOptional
蓝链点击率下限,即蓝链点击量除以视频播放量 / Minimum blue-link CTR, blue-link clicks divided by video views
blue_url_ctr_ltOptional
蓝链点击率上限,即蓝链点击量除以视频播放量 / Maximum blue-link CTR, blue-link clicks divided by video views
blue_url_click_cost_gteOptional
蓝链点击成本下限,即合作及投流花费除以蓝链点击量 / Minimum blue-link click cost, cooperation and promotion spend divided by clicks
blue_url_click_cost_ltOptional
蓝链点击成本上限,即合作及投流花费除以蓝链点击量 / Maximum blue-link click cost, cooperation and promotion spend divided by clicks
min_play_medianOptional
播放量中位数下限;统计近180天且发布满7天的合格原创稿件 / Minimum median views for eligible original videos published at least seven days ago
max_play_medianOptional
播放量中位数上限;统计近180天且发布满7天的合格原创稿件 / Maximum median views for eligible original videos published at least seven days ago
play_median_traffic_typeOptional
播放中位数流量口径:1=全部流量,2=自然流量 / Median-view traffic scope: 1=all traffic, 2=organic traffic
play_median_cycleOptional
播放中位数统计周期:1=7天,2=15天,3=30天 / Median-view window: 1=7 days, 2=15 days, 3=30 days
min_cpmOptional
CPM 下限,即花费除以播放量再乘1000 / Minimum CPM, calculated as spend divided by views times 1,000
max_cpmOptional
CPM 上限,即花费除以播放量再乘1000 / Maximum CPM, calculated as spend divided by views times 1,000
cpm_typeOptional
CPM 流量口径:1=全部流量,2=自然流量 / CPM traffic scope: 1=all traffic, 2=organic traffic
cpm_cycleOptional
CPM 统计周期:1=7天,2=15天,3=30天 / CPM window: 1=7 days, 2=15 days, 3=30 days
min_cpcOptional
CPC 下限,即花费除以组件点击次数 / Minimum CPC, calculated as spend divided by component clicks
max_cpcOptional
CPC 上限,即花费除以组件点击次数 / Maximum CPC, calculated as spend divided by component clicks
cpc_traffic_typeOptional
CPC 流量口径:1=全部流量,2=自然流量 / CPC traffic scope: 1=all traffic, 2=organic traffic
cpc_cycleOptional
CPC 统计周期:1=7天,2=15天,3=30天 / CPC window: 1=7 days, 2=15 days, 3=30 days
cpe_gteOptional
CPE 下限,即花费除以有效互动次数 / Minimum CPE, calculated as spend divided by valid engagements
cpe_ltOptional
CPE 上限,即花费除以有效互动次数 / Maximum CPE, calculated as spend divided by valid engagements
cpe_traffic_typeOptional
CPE 流量口径:1=全部流量,2=自然流量 / CPE traffic scope: 1=all traffic, 2=organic traffic
cpe_cycleOptional
CPE 统计周期:1=7天,3=30天 / CPE window: 1=7 days, 3=30 days
draft_durationOptional
主流视频时长: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
min_avid_cntOptional
近90天有效原创稿件数下限 / Minimum eligible original-video count in the last 90 days
max_avid_cntOptional
近90天有效原创稿件数上限 / Maximum eligible original-video count in the last 90 days
min_hot_avid_rateOptional
近90天爆款稿件占比下限 / Minimum viral-video ratio in the last 90 days
max_hot_avid_rateOptional
近90天爆款稿件占比上限 / Maximum viral-video ratio in the last 90 days
half_min_hot_avid_cntOptional
近半年爆款稿件数下限 / Minimum viral-video count in the last six months
half_max_hot_avid_cntOptional
近半年爆款稿件数上限 / Maximum viral-video count in the last six months
entry_cost_minOptional
近一年相关合作的进店成本下限 / Minimum store-entry cost for relevant cooperation in the last year
entry_cost_maxOptional
近一年相关合作的进店成本上限 / Maximum store-entry cost for relevant cooperation in the last year
av_honorOptional
稿件荣誉没有独立选项接口,取值见 search_upper 文档;honor_type 始终为可多选数组 / Video honors have no separate options endpoint; use the search_upper documentation and always send honor_type as an array
cooperate_experience_industry_idsOptional
非通用行业面板先调用 /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
cooperate_experience_typeOptional
非通用行业策略面板的合作经验类型: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
special_tagsOptional
特色标签列表,取值见 /api/v1/bilibili/huahuo/square_static_info / Feature-tag values from /api/v1/bilibili/huahuo/square_static_info
spark_tagOptional
花火能力标签;通用面板合作次数使用 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_inOptional
广场场景标签,例如 ad_partner_experienced / Marketplace scenario tags such as ad_partner_experienced
label_arrayOptional
先调用 /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
bdata_tag_lv5Optional
B站五级内容标签筛选值列表 / Bilibili level-five content-tag filter values
huahuo_first_industry_idsOptional
通用面板先调用 /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
huahuo_second_industry_idsOptional
通用面板先调用 /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
huahuo_third_industry_idsOptional
通用面板先调用 /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
goods_permissionOptional
带货权限筛选:1=有权限,0=不限 / Commerce permission filter: 1=required, 0=all
goods_up_levelsOptional
带货 UP 主等级列表 / Commerce-creator level values
goods_category_first_idsOptional
带货一级类目 ID 列表,取值见 /api/v1/bilibili/huahuo/effect_goods_drop / Primary commerce-category IDs from /api/v1/bilibili/huahuo/effect_goods_drop
goods_category_second_idsOptional
带货二级类目 ID 列表,取值见 /api/v1/bilibili/huahuo/effect_goods_drop / Secondary commerce-category IDs from /api/v1/bilibili/huahuo/effect_goods_drop
goods_gpm_minOptional
近30天 GPM 下限,即每千次带货视频播放产生的支付 GMV / Minimum 30-day GPM, paid GMV per 1,000 commerce-video views
goods_gpm_maxOptional
近30天 GPM 上限,即每千次带货视频播放产生的支付 GMV / Maximum 30-day GPM, paid GMV per 1,000 commerce-video views
goods_ctr_minOptional
带货组件点击率下限,即组件点击数除以曝光数 / Minimum commerce-component CTR, clicks divided by impressions
goods_ctr_maxOptional
带货组件点击率上限,即组件点击数除以曝光数 / Maximum commerce-component CTR, clicks divided by impressions
goods_ctr_typeOptional
带货点击率组件口径:1=全部组件,2=评论区组件 / Commerce CTR component scope: 1=all components, 2=comment component
goods_avg_price_minOptional
近30天商品平均价格下限,单位为人民币元 / Minimum average product price in the last 30 days, in RMB
goods_avg_price_maxOptional
近30天商品平均价格上限,单位为人民币元 / Maximum average product price in the last 30 days, in RMB
goods_is_high_video_play_permeateOptional
高视频播放渗透筛选,近30天播放用户占粉丝数比例居前20% / High video-view penetration filter, top 20% by recent viewers per follower
goods_is_high_fans_play_permeateOptional
高粉丝播放渗透筛选 / High follower-view penetration filter
is_boostingOptional
是否筛选内容加热中的 UP 主:1=是,0=不限 / Boosting-status filter: 1=currently boosting, 0=all
is_treasure_upOptional
是否筛选宝藏 UP 主 / Whether to filter for treasure creators
is_timely_responseOptional
是否筛选及时响应的 UP 主 / Whether to require timely-response creators
is_new_enterOptional
是否筛选新入驻 UP 主 / Whether to filter for newly onboarded creators
custom_video_pricing_setOptional
是否已设置定制视频报价 / Whether custom-video pricing has been configured
is_x_plan_better_upOptional
是否筛选 X 计划优选 UP 主 / Whether to filter for X Plan preferred creators
high_potential_typeOptional
高潜类型:0=全部,1=已入驻,2=未入驻 / High-potential type: 0=all, 1=onboarded, 2=not onboarded

Example input

{
  "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
}

Output

Native social data and pagination. Unsafe integer IDs are strings. Follow returned cursors explicitly; each page is a new request.