Theme
Language
POST$0.013 per request · $13.00 per 1,000 requests

Search upper

Search Huahuo creators or content

Endpoint

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

Example

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

Send your key in the Authorization: Bearer header. You pay only for requests the data provider accepts. Requests it rejects (errors, timeouts, invalid parameters) are not billed. A valid request that returns an empty or not-found result from the platform is billed.

Parameters

nickname_or_mids

body · string

Creator nickname or UID query; separate multiple terms with commas

main_search

body · string

Content-keyword query; matched videos are included in the result

mids

body · array

List of creator UIDs to match exactly

upper_mid

body · integer

Single creator UID for an exact match

folder_id

body · integer

Saved-creator folder ID used to limit the search

marketing_target

body · integer

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

panel_type

body · integer

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

order_by

body · string

Sort field, such as fans_num, play_median, or interactive_rate

sort

body · string

Sort direction: desc=descending, asc=ascending

page

body · integer

One-based page number; each page returns 20 records

request_id

body · string

Search-session ID; reuse it across pages of the same filter set

gender

body · string

Creator gender from gender_info returned by /api/v1/bilibili/huahuo/square_static_info

min_fans_num

body · integer

Minimum follower count, inclusive

max_fans_num

body · integer

Maximum follower count, inclusive

region_id

body · array

Call /api/v1/bilibili/huahuo/region_drop first, then put selected primary-region values in this array

second_region_id

body · array

Call /api/v1/bilibili/huahuo/region_drop first, then put selected child-region values in this array

partition_id

body · integer

api/v1/bilibili/huahuo/partition_drop / Primary content-category ID from /api/v1/bilibili/huahuo/partition_drop

second_partition_id

body · array

api/v1/bilibili/huahuo/partition_drop / Secondary content-category IDs from /api/v1/bilibili/huahuo/partition_drop

mcn_ids

body · array

api/v1/bilibili/huahuo/mcn_drop / MCN organization IDs from /api/v1/bilibili/huahuo/mcn_drop

provider_id

body · array

Service-provider IDs using values offered by the Huahuo filter

upper_types

body · array

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

only_contract

body · integer

Contract-eligible filter: 1=only eligible creators, 0=all

is_painter_order

body · boolean

Whether to require illustration-commission capability

fans_age_tag

body · array

api/v1/bilibili/huahuo/square_static_info / Audience age-affinity tags from /api/v1/bilibili/huahuo/square_static_info

fans_gender_tag

body · array

api/v1/bilibili/huahuo/square_static_info / Audience gender-affinity tags from /api/v1/bilibili/huahuo/square_static_info

fans_region_tag

body · array

api/v1/bilibili/huahuo/square_static_info / Audience region-affinity tags from /api/v1/bilibili/huahuo/square_static_info

fans_stick

body · integer

Follower-loyalty filter; 0=all, otherwise use a static-option value

av_active

body · integer

Recent-publishing activity switch: 1=enabled, 0=all

av_active_tag

body · string

Recent-publishing activity tier from av_active_tag returned by /api/v1/bilibili/huahuo/square_static_info

dmp_group_id

body · integer

api/v1/bilibili/huahuo/dmp_pkg_list / DMP custom audience-package ID from /api/v1/bilibili/huahuo/dmp_pkg_list

category_dmp_group_id

body · integer

Content-category DMP audience-package ID

category_dmp_label

body · string

Display label for the content-category DMP audience package

dmp_pkg_name

body · string

DMP special-audience package name query

dmp_pkg_vertical_rate_gte

body · integer

Minimum DMP verticality: matching videos divided by all videos

dmp_pkg_vertical_rate_lte

body · integer

Maximum DMP verticality: matching videos divided by all videos

dmp_pkg_effect_rate_gte

body · integer

Minimum DMP influence: recent matching viewers divided by the audience population

dmp_pkg_effect_rate_lte

body · integer

Maximum DMP influence: recent matching viewers divided by the audience population

dmp_pkg_fan_rate_gte

body · integer

Minimum DMP attention: matching audience members divided by all followers

dmp_pkg_fan_rate_lte

body · integer

Maximum DMP attention: matching audience members divided by all followers

min_task_price

body · integer

Minimum standard cooperation quote in RMB

max_task_price

body · integer

Maximum standard cooperation quote in RMB

price_info

body · array

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_price

body · integer

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

last_14_days_set_price

body · integer

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

last_30_days_set_price

body · integer

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

min_interact_rate

body · integer

Minimum engagement rate for eligible original videos in the last 180 days

max_interact_rate

body · integer

Maximum engagement rate for eligible original videos in the last 180 days

blue_url_ctr_gte

body · integer

Minimum blue-link CTR, blue-link clicks divided by video views

blue_url_ctr_lt

body · integer

Maximum blue-link CTR, blue-link clicks divided by video views

blue_url_click_cost_gte

body · integer

Minimum blue-link click cost, cooperation and promotion spend divided by clicks

blue_url_click_cost_lt

body · integer

Maximum blue-link click cost, cooperation and promotion spend divided by clicks

min_play_median

body · integer

Minimum median views for eligible original videos published at least seven days ago

max_play_median

body · integer

Maximum median views for eligible original videos published at least seven days ago

play_median_traffic_type

body · integer

Median-view traffic scope: 1=all traffic, 2=organic traffic

play_median_cycle

body · integer

Median-view window: 1=7 days, 2=15 days, 3=30 days

min_cpm

body · integer

Minimum CPM, calculated as spend divided by views times 1,000

max_cpm

body · integer

Maximum CPM, calculated as spend divided by views times 1,000

cpm_type

body · integer

CPM traffic scope: 1=all traffic, 2=organic traffic

cpm_cycle

body · integer

CPM window: 1=7 days, 2=15 days, 3=30 days

min_cpc

body · integer

Minimum CPC, calculated as spend divided by component clicks

max_cpc

body · integer

Maximum CPC, calculated as spend divided by component clicks

cpc_traffic_type

body · integer

CPC traffic scope: 1=all traffic, 2=organic traffic

cpc_cycle

body · integer

CPC window: 1=7 days, 2=15 days, 3=30 days

cpe_gte

body · integer

Minimum CPE, calculated as spend divided by valid engagements

cpe_lt

body · integer

Maximum CPE, calculated as spend divided by valid engagements

cpe_traffic_type

body · integer

CPE traffic scope: 1=all traffic, 2=organic traffic

cpe_cycle

body · integer

CPE window: 1=7 days, 3=30 days

draft_duration

body · integer

Dominant video duration bucket from under 30 seconds to over 10 minutes

min_avid_cnt

body · integer

Minimum eligible original-video count in the last 90 days

max_avid_cnt

body · integer

Maximum eligible original-video count in the last 90 days

min_hot_avid_rate

body · integer

Minimum viral-video ratio in the last 90 days

max_hot_avid_rate

body · integer

Maximum viral-video ratio in the last 90 days

half_min_hot_avid_cnt

body · integer

Minimum viral-video count in the last six months

half_max_hot_avid_cnt

body · integer

Maximum viral-video count in the last six months

entry_cost_min

body · integer

Minimum store-entry cost for relevant cooperation in the last year

entry_cost_max

body · integer

Maximum store-entry cost for relevant cooperation in the last year

av_honor

body · object

Video honors have no separate options endpoint; use the search_upper documentation and always send honor_type as an array

cooperate_experience_industry_ids

body · array

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_type

body · integer

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_tags

body · array

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

spark_tag

body · array

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_in

body · array

Marketplace scenario tags such as ad_partner_experienced

label_array

body · array

Call /api/v1/bilibili/huahuo/upper_label_tree first, then put all selected content-type values in one inner array

bdata_tag_lv5

body · array

Bilibili level-five content-tag filter values

huahuo_first_industry_ids

body · array

For the general panel, call /api/v1/bilibili/huahuo/square_static_info and put selected primary industry_tree IDs here

huahuo_second_industry_ids

body · array

For the general panel, call /api/v1/bilibili/huahuo/square_static_info and put selected secondary industry_tree IDs here

huahuo_third_industry_ids

body · array

For the general panel, call /api/v1/bilibili/huahuo/square_static_info and put selected tertiary industry_tree IDs here

goods_permission

body · integer

Commerce permission filter: 1=required, 0=all

goods_up_levels

body · array

Commerce-creator level values

goods_category_first_ids

body · array

api/v1/bilibili/huahuo/effect_goods_drop / Primary commerce-category IDs from /api/v1/bilibili/huahuo/effect_goods_drop

goods_category_second_ids

body · array

api/v1/bilibili/huahuo/effect_goods_drop / Secondary commerce-category IDs from /api/v1/bilibili/huahuo/effect_goods_drop

goods_gpm_min

body · integer

Minimum 30-day GPM, paid GMV per 1,000 commerce-video views

goods_gpm_max

body · integer

Maximum 30-day GPM, paid GMV per 1,000 commerce-video views

goods_ctr_min

body · integer

Minimum commerce-component CTR, clicks divided by impressions

goods_ctr_max

body · integer

Maximum commerce-component CTR, clicks divided by impressions

goods_ctr_type

body · integer

Commerce CTR component scope: 1=all components, 2=comment component

goods_avg_price_min

body · integer

Minimum average product price in the last 30 days, in RMB

goods_avg_price_max

body · integer

Maximum average product price in the last 30 days, in RMB

goods_is_high_video_play_permeate

body · integer

High video-view penetration filter, top 20% by recent viewers per follower

goods_is_high_fans_play_permeate

body · integer

High follower-view penetration filter

is_boosting

body · integer

Boosting-status filter: 1=currently boosting, 0=all

is_treasure_up

body · integer

Whether to filter for treasure creators

is_timely_response

body · integer

Whether to require timely-response creators

is_new_enter

body · integer

Whether to filter for newly onboarded creators

custom_video_pricing_set

body · integer

Whether custom-video pricing has been configured

is_x_plan_better_up

body · integer

Whether to filter for X Plan preferred creators

high_potential_type

body · integer

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

Get an API keyAll Bilibili methods
Search upper — Bilibili API | GetVibe API