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
}

API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info); upper_label_tree = GET /tikhub/bilibili/huahuo/upper_label_tree (operationId: get_tikhub_bilibili_huahuo_upper_label_tree).

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

Single creator UID for an exact match

folder_id

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

Page number starting at 1; each page contains 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 /tikhub/bilibili/huahuo/square_static_info

API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).

min_fans_num

Minimum follower count, inclusive

max_fans_num

Maximum follower count, inclusive

region_id

(integer | string)[] | null

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

API references: region_drop = GET /tikhub/bilibili/huahuo/region_drop (operationId: get_tikhub_bilibili_huahuo_region_drop).

second_region_id

(integer | string)[] | null

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

API references: region_drop = GET /tikhub/bilibili/huahuo/region_drop (operationId: get_tikhub_bilibili_huahuo_region_drop).

partition_id

Primary content-category ID from /tikhub/bilibili/huahuo/partition_drop

API references: partition_drop = GET /tikhub/bilibili/huahuo/partition_drop (operationId: get_tikhub_bilibili_huahuo_partition_drop).

second_partition_id

(integer | string)[] | null

Secondary content-category IDs from /tikhub/bilibili/huahuo/partition_drop

API references: partition_drop = GET /tikhub/bilibili/huahuo/partition_drop (operationId: get_tikhub_bilibili_huahuo_partition_drop).

mcn_ids

(integer | string)[] | null

MCN organization IDs from /tikhub/bilibili/huahuo/mcn_drop

API references: mcn_drop = GET /tikhub/bilibili/huahuo/mcn_drop (operationId: get_tikhub_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 /tikhub/bilibili/huahuo/square_static_info

API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).

fans_gender_tag

string[] | null

Audience gender-affinity tags from /tikhub/bilibili/huahuo/square_static_info

API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).

fans_region_tag

string[] | null

Audience region-affinity tags from /tikhub/bilibili/huahuo/square_static_info

API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).

fans_stick

integer | null

Follower-loyalty filter: 0 means unrestricted; obtain other values from the static filter options.

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 /tikhub/bilibili/huahuo/square_static_info

API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).

dmp_group_id

DMP custom audience-package ID from /tikhub/bilibili/huahuo/dmp_pkg_list

API references: dmp_pkg_list = GET /tikhub/bilibili/huahuo/dmp_pkg_list (operationId: get_tikhub_bilibili_huahuo_dmp_pkg_list).

category_dmp_group_id

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

Minimum DMP verticality: matching videos divided by all videos

dmp_pkg_vertical_rate_lte

Maximum DMP verticality: matching videos divided by all videos

dmp_pkg_effect_rate_gte

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

dmp_pkg_effect_rate_lte

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

dmp_pkg_fan_rate_gte

Minimum DMP attention: matching audience members divided by all followers

dmp_pkg_fan_rate_lte

Maximum DMP attention: matching audience members divided by all followers

min_task_price

Minimum standard cooperation quote in RMB

max_task_price

Maximum standard cooperation quote in RMB

price_info

UpperPriceFilter · object[] | null

Cooperation-pricing filters from price_info_options returned by /tikhub/bilibili/huahuo/square_static_info; send one type per search, include all six fields, and use [] for unavailable arrays

API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).

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

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

max_interact_rate

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

blue_url_ctr_gte

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

blue_url_ctr_lt

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

blue_url_click_cost_gte

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

blue_url_click_cost_lt

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

min_play_median

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

max_play_median

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

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

max_cpm

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

Minimum CPC, calculated as spend divided by component clicks

max_cpc

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

Minimum CPE, calculated as spend divided by valid engagements

cpe_lt

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

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

min_avid_cnt

Minimum eligible original-video count in the last 90 days

max_avid_cnt

Maximum eligible original-video count in the last 90 days

min_hot_avid_rate

Minimum viral-video ratio in the last 90 days

max_hot_avid_rate

Maximum viral-video ratio in the last 90 days

half_min_hot_avid_cnt

Minimum viral-video count in the last six months

half_max_hot_avid_cnt

Maximum viral-video count in the last six months

entry_cost_min

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

entry_cost_max

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

API references: search_upper = POST /tikhub/bilibili/huahuo/search_upper (operationId: post_tikhub_bilibili_huahuo_search_upper).

Show child attributes

cooperate_experience_industry_ids

(integer | string)[] | null

For non-general panels, call /tikhub/bilibili/huahuo/cooperate_experience_industry first and put selected IDs here; unused by the general panel

API references: cooperate_experience_industry = GET /tikhub/bilibili/huahuo/cooperate_experience_industry (operationId: get_tikhub_bilibili_huahuo_cooperate_experience_industry).

cooperate_experience_type

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 /tikhub/bilibili/huahuo/square_static_info

API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).

spark_tag

string[] | null

Huahuo capability tags, such as cooperate, grow, or hot_frequent. On the general panel, use cooperate for prior cooperation or coo_frequent for frequent cooperation, together with industry-tree values from /tikhub/bilibili/huahuo/square_static_info.

API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).

square_tag_in

string[] | null

Marketplace scenario tags, such as ad_partner_experienced.

label_array

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

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

API references: upper_label_tree = GET /tikhub/bilibili/huahuo/upper_label_tree (operationId: get_tikhub_bilibili_huahuo_upper_label_tree).

bdata_tag_lv5

any[] | null

Bilibili level-five content-tag filter values

huahuo_first_industry_ids

(integer | string)[] | null

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

API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).

huahuo_second_industry_ids

(integer | string)[] | null

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

API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).

huahuo_third_industry_ids

(integer | string)[] | null

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

API references: square_static_info = GET /tikhub/bilibili/huahuo/square_static_info (operationId: get_tikhub_bilibili_huahuo_square_static_info).

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 /tikhub/bilibili/huahuo/effect_goods_drop

API references: effect_goods_drop = GET /tikhub/bilibili/huahuo/effect_goods_drop (operationId: get_tikhub_bilibili_huahuo_effect_goods_drop).

goods_category_second_ids

(integer | string)[] | null

Secondary commerce-category IDs from /tikhub/bilibili/huahuo/effect_goods_drop

API references: effect_goods_drop = GET /tikhub/bilibili/huahuo/effect_goods_drop (operationId: get_tikhub_bilibili_huahuo_effect_goods_drop).

goods_gpm_min

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

goods_gpm_max

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

goods_ctr_min

Minimum commerce-component CTR, clicks divided by impressions

goods_ctr_max

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

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

goods_avg_price_max

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

goods_is_high_video_play_permeate

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

goods_is_high_fans_play_permeate

High follower-view penetration filter

is_boosting

integer | null

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

is_treasure_up

Whether to select treasure creators.

is_timely_response

Whether to require timely-response creators

is_new_enter

Whether to select newly onboarded creators.

custom_video_pricing_set

Whether custom-video pricing has been configured

Usage: Require configured custom-video pricing; is_x_plan_better_up: X Plan preferred creators.

is_x_plan_better_up

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

Returns

page: Current page number.
total_count: Total matching records, displayed up to 10,000.
data: Creator records commonly containing upper_mid, nickname, fans_num, play_median, interactive_rate, pricing, content and industry labels, DMP measurements, and commerce metrics. Content-search results also include matched videos.

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:请求成功，本次请求将被计费。

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:本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。

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

Endpoint-specific response payload. The official shared model does not declare a fixed type or field set. Use the operation's documented return fields or response example; an operation-specific schema, when present, describes the documented fields. Undocumented fields must be read from the actual response rather than assumed.

Overview

Chat API

Embeddings & Rerank

Search API

Exa API

Perplexity API

Akta Private Market Data API

Financial API

Twitter API

Reddit API

Instagram API

Pinterest API

Scholar API

WaveInflu API

Prediction Market API

CoinGecko

Duffel Flights

DataForSEO

AgentMail

Apollo

Ahrefs API

Semrush API

Foreplay API

CNPJá API

Open-Meteo API

SimilarWeb API

Essentials

TikHub API

Search Huahuo creators or content

Example

Authorizations

Body

Search modes:

Filter groups:

[Example]

Response

Returns

​Example

Authorizations

Body

Search modes:

Filter groups:

[Example]

Response

Returns

Example