Search Huahuo creators or content

Search Huahuo creators or content

POST https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_upper

cURL

content_type_single

curl --request POST \
  --url https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_upper \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label_array": [
    [
      794
    ]
  ],
  "page": 1
}
'

200

{
  "code": 200,
  "request_id": "<string>",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "Request successful; this request will be billed.",
  "support": "Discord: https://discord.gg/aMEAS8Xsvz",
  "time": "<string>",
  "time_stamp": 123,
  "time_zone": "America/Los_Angeles",
  "docs": "<string>",
  "cache_message": "This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.",
  "cache_message_zh": "This response has been cached and can be viewed directly via the URL below; it is valid for 24 hours and accessing the cached link incurs no additional charge. The cache is for request tracing only and does not affect the freshness of the API data, nor will it be returned again through the API.",
  "cache_url": "<string>",
  "router": "",
  "params": {},
  "data": "<unknown>"
}

Search Huahuo creators or content

Pricing — base $0.0145 per successful call (provider cost × 1.45; final charge scales by your plan multiplier). Charged only when the upstream response body code is 200.

Example

curl -X POST "https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_upper" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'  # see request schema below

Authorizations

Authorization · string · header · required

AIsa API key. Get yours at https://aisa.one

Body

application/json

Search modes:

• nickname_or_mids: Search by creator nickname or UID; separate multiple terms with commas.
• main_search: Search by content keyword and include matched videos in the response.
• mids / upper_mid: Match one or more creator UIDs exactly.

Filter groups:

• Profile and affiliation: gender, followers, region, content category, MCN, service provider, and account type.
• Audience profile: age, gender, region affinity, and follower loyalty.
• Pricing and performance: quote, engagement rate, median views, CPM, CPC, CPE, and store-entry cost.
• Content and cooperation: post count, viral-post ratio, video duration, honors, industries, and cooperation experience.
• Commerce: permission, level, categories, GPM, component CTR, and average product price.
• Audience packages and labels: DMP packages, feature tags, content-type trees, and high-potential tags.

Every field is optional. Send ratio fields as decimal values (for example, 0.05 for 5%) and monetary fields as the RMB values displayed by Huahuo. Dynamic IDs are available from square_static_info, upper_label_tree, and the corresponding dropdown endpoints.

[Example]

{
  "nickname_or_mids": "2233,xiaodianshi",
  "marketing_target": 1,
  "panel_type": 0,
  "min_fans_num": 100000,
  "max_fans_num": 1000000,
  "min_interact_rate": 0.03,
  "play_median_traffic_type": 1,
  "play_median_cycle": 3,
  "price_info": [{
    "cooperation_type": 1,
    "creative_skill": [],
    "include_content": [],
    "price_min": 1000,
    "price_max": 10000,
    "price_right": []
  }],
  "goods_ctr_type": 1,
  "page": 1
}

nickname_or_mids · string | null

Creator nickname or UID query; separate multiple terms with commas

main_search · string | null

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

mids · (integer | string)[] | null

List of creator UIDs to match exactly

upper_mid · integer string

Single creator UID for an exact match

folder_id · integer string

Saved-creator folder ID used to limit the search

marketing_target · integer | null

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

panel_type · integer | null

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

order_by · string | null

Sort field, such as fans_num, play_median, or interactive_rate

sort · string | null

Sort direction: desc=descending, asc=ascending

page · integer | null

One-based page number; each page returns 20 records

Required range: x >= 1

request_id · string | null

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

gender · string | null

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

min_fans_num · integer string

Minimum follower count, inclusive

max_fans_num · integer string

Maximum follower count, inclusive

region_id · (integer | string)[] | null

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

second_region_id · (integer | string)[] | null

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

partition_id · integer string

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

second_partition_id · (integer | string)[] | null

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

mcn_ids · (integer | string)[] | null

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

provider_id · (integer | string)[] | null

Service-provider IDs using values offered by the Huahuo filter

upper_types · (integer | string)[] | null

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

only_contract · integer | null

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

is_painter_order · boolean | null

Whether to require illustration-commission capability

fans_age_tag · string[] | null

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

fans_gender_tag · string[] | null

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

fans_region_tag · string[] | null

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

fans_stick · integer | null

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

av_active · integer | null

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

av_active_tag · string | null

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

dmp_group_id · integer string

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

category_dmp_group_id · integer string

Content-category DMP audience-package ID

category_dmp_label · string | null

Display label for the content-category DMP audience package

dmp_pkg_name · string | null

DMP special-audience package name query

dmp_pkg_vertical_rate_gte · integer number string

Minimum DMP verticality: matching videos divided by all videos

dmp_pkg_vertical_rate_lte · integer number string

Maximum DMP verticality: matching videos divided by all videos

dmp_pkg_effect_rate_gte · integer number string

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

dmp_pkg_effect_rate_lte · integer number string

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

dmp_pkg_fan_rate_gte · integer number string

Minimum DMP attention: matching audience members divided by all followers

dmp_pkg_fan_rate_lte · integer number string

Maximum DMP attention: matching audience members divided by all followers

min_task_price · integer number string

Minimum standard cooperation quote in RMB

max_task_price · integer number string

Maximum standard cooperation quote in RMB

price_info · UpperPriceFilter · object[] | null

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

Show child attributes

last_7_days_set_price · integer | null

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

last_14_days_set_price · integer | null

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

last_30_days_set_price · integer | null

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

min_interact_rate · integer number string

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

max_interact_rate · integer number string

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

blue_url_ctr_gte · integer number string

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

blue_url_ctr_lt · integer number string

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

blue_url_click_cost_gte · integer number string

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

blue_url_click_cost_lt · integer number string

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

min_play_median · integer number string

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

max_play_median · integer number string

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

play_median_traffic_type · integer | null

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

play_median_cycle · integer | null

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

min_cpm · integer number string

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

max_cpm · integer number string

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

cpm_type · integer | null

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

cpm_cycle · integer | null

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

min_cpc · integer number string

Minimum CPC, calculated as spend divided by component clicks

max_cpc · integer number string

Maximum CPC, calculated as spend divided by component clicks

cpc_traffic_type · integer | null

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

cpc_cycle · integer | null

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

cpe_gte · integer number string

Minimum CPE, calculated as spend divided by valid engagements

cpe_lt · integer number string

Maximum CPE, calculated as spend divided by valid engagements

cpe_traffic_type · integer | null

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

cpe_cycle · integer | null

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

draft_duration · integer string

Dominant video duration: 1=0-30s, 2=30-60s, 3=1-3min, 4=3-5min, 5=5-10min, 6=over 10min

min_avid_cnt · integer string

Minimum eligible original-video count in the last 90 days

max_avid_cnt · integer string

Maximum eligible original-video count in the last 90 days

min_hot_avid_rate · integer number string

Minimum viral-video ratio in the last 90 days

max_hot_avid_rate · integer number string

Maximum viral-video ratio in the last 90 days

half_min_hot_avid_cnt · integer string

Minimum viral-video count in the last six months

half_max_hot_avid_cnt · integer string

Maximum viral-video count in the last six months

entry_cost_min · integer number string

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

entry_cost_max · integer number string

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

av_honor · UpperHonorFilter · object | null

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

Show child attributes

cooperate_experience_industry_ids · (integer | string)[] | null

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 · integer string

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 · string[] | null

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

spark_tag · string[] | null

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 · string[] | null

Marketplace scenario tags such as ad_partner_experienced

label_array · ((integer | string)[])[] | null

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

bdata_tag_lv5 · any[] | null

Bilibili level-five content-tag filter values

huahuo_first_industry_ids · (integer | string)[] | null

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

huahuo_second_industry_ids · (integer | string)[] | null

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

huahuo_third_industry_ids · (integer | string)[] | null

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

goods_permission · integer | null

Commerce permission filter: 1=required, 0=all

goods_up_levels · (integer | string)[] | null

Commerce-creator level values

goods_category_first_ids · (integer | string)[] | null

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

goods_category_second_ids · (integer | string)[] | null

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

goods_gpm_min · integer number string

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

goods_gpm_max · integer number string

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

goods_ctr_min · integer number string

Minimum commerce-component CTR, clicks divided by impressions

goods_ctr_max · integer number string

Maximum commerce-component CTR, clicks divided by impressions

goods_ctr_type · integer | null

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

goods_avg_price_min · integer number string

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

goods_avg_price_max · integer number string

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

goods_is_high_video_play_permeate · integer string

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

goods_is_high_fans_play_permeate · integer string

High follower-view penetration filter

is_boosting · integer | null

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

is_treasure_up · integer string

Whether to filter for treasure creators

is_timely_response · integer string

Whether to require timely-response creators

is_new_enter · integer string

Whether to filter for newly onboarded creators

custom_video_pricing_set · integer string

Whether custom-video pricing has been configured

is_x_plan_better_up · integer string

Whether to filter for X Plan preferred creators

high_potential_type · integer | null

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

Response

200 - application/json

Successful Response

code · integer · default: 200

HTTP status code

request_id · string | null

Unique request identifier

message · string · default: Request successful. This request will incur a charge.

Response message (EN-US)

message_zh · string · default: Request successful; this request will be billed.

Response message (ZH-CN)

support · string · default: Discord: https://discord.gg/aMEAS8Xsvz

Support message

time · string

The time the response was generated

time_stamp · integer

The timestamp the response was generated

time_zone · string · default: America/Los_Angeles

The timezone of the response time

docs · string | null

Link to the API Swagger documentation for this endpoint

cache_message · string | null · default: This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.

Cache message (EN-US)

cache_message_zh · string | null · default: This response has been cached and can be viewed directly via the URL below; it is valid for 24 hours and accessing the cached link incurs no additional charge. The cache is for request tracing only and does not affect the freshness of the API data, nor will it be returned again through the API.

Cache message (ZH-CN)

cache_url · string | null

The URL to access the cached result

router · string · default: ""

The endpoint that generated this response

params · any · default: {}

The parameters used in the request

data · any | null

The response data