授权

Authorization

string

header

必填

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

请求体

application/json

[中文]

搜索方式:

nickname_or_mids: 按 UP 主昵称或 UID 搜索，多个值可用英文逗号分隔。
main_search: 按内容关键词搜索，并在结果中返回命中的稿件信息。
mids / upper_mid: 按一个或多个 UID 精确匹配。

筛选字段:

基础与归属：性别、粉丝数、地域、内容分区、MCN、服务商及账号类型。
粉丝画像：年龄、性别、地域倾向和粉丝黏性。
报价与效果：任务报价、互动率、播放中位数、CPM、CPC、CPE、进店成本。
内容与合作：稿件数量、爆款比例、视频时长、稿件荣誉、行业及合作经验。
带货能力：带货权限、等级、类目、GPM、组件点击率和商品均价。
人群包与标签：DMP 人群包、特色标签、内容类型树和高潜标签。

所有字段均可选。比例字段按页面展示值传入，例如 0.05 表示 5%；金额字段按页面使用的人民币数值传入。筛选项的动态 ID 可通过 square_static_info、upper_label_tree 及相应下拉列表接口取得。

[English]

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,小电视",
  "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

按 UP 主昵称或 UID 搜索，多个关键词用英文逗号分隔 / 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

批量精确匹配的 UP 主 UID 列表 / List of creator UIDs to match exactly

upper_mid

单个 UP 主 UID 精确筛选 / Single creator UID for an exact match

folder_id

已保存 UP 主文件夹 ID，用于限定文件夹内搜索 / Saved-creator folder ID used to limit the search

marketing_target

integer | null

营销目标：1=品牌曝光，2=心智种草，3=效果转化 / Marketing objective: 1=brand awareness, 2=consideration, 3=conversion

panel_type

integer | null

行业策略面板：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_by

string | null

排序字段，例如 fans_num、play_median、interactive_rate / Sort field, such as fans_num, play_median, or interactive_rate

sort

string | null

排序方向：desc=降序，asc=升序 / Sort direction: desc=descending, asc=ascending

page

integer | null

页码，从 1 开始，每页返回 20 条 / One-based page number; each page returns 20 records

必填范围: x >= 1

request_id

string | null

搜索会话标识；同组条件翻页时复用，留空则生成新值 / Search-session ID; reuse it across pages of the same filter set

gender

string | null

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_num

粉丝数下限（含）/ Minimum follower count, inclusive

max_fans_num

粉丝数上限（含）/ Maximum follower count, inclusive

region_id

(integer | string)[] | null

先调用 /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_id

(integer | string)[] | null

先调用 /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_id

内容一级分区 ID，取值见 /api/v1/bilibili/huahuo/partition_drop / Primary content-category ID from /api/v1/bilibili/huahuo/partition_drop

second_partition_id

(integer | string)[] | null

内容二级分区 ID 列表，取值见 /api/v1/bilibili/huahuo/partition_drop / Secondary content-category IDs from /api/v1/bilibili/huahuo/partition_drop

mcn_ids

(integer | string)[] | null

MCN 机构 ID 列表，取值见 /api/v1/bilibili/huahuo/mcn_drop / MCN organization IDs from /api/v1/bilibili/huahuo/mcn_drop

provider_id

(integer | string)[] | null

服务商 ID 列表，使用花火筛选项的可选值 / Service-provider IDs using values offered by the Huahuo filter

upper_types

(integer | string)[] | null

账号类型：1或4=机构签约，3=个人 / Creator type: 1 or 4=MCN-affiliated, 3=independent

only_contract

integer | null

仅看可签约账号：1=是，0=不限 / 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

粉丝年龄倾向标签，取值见 /api/v1/bilibili/huahuo/square_static_info / Audience age-affinity tags from /api/v1/bilibili/huahuo/square_static_info

fans_gender_tag

string[] | null

粉丝性别倾向标签，取值见 /api/v1/bilibili/huahuo/square_static_info / Audience gender-affinity tags from /api/v1/bilibili/huahuo/square_static_info

fans_region_tag

string[] | null

粉丝地域倾向标签，取值见 /api/v1/bilibili/huahuo/square_static_info / Audience region-affinity tags from /api/v1/bilibili/huahuo/square_static_info

fans_stick

integer | null

粉丝黏性筛选值，0=不限，其他值取自静态筛选项 / Follower-loyalty filter; 0=all, otherwise use a static-option value

av_active

integer | null

近期投稿活跃开关：1=启用，0=不限 / Recent-publishing activity switch: 1=enabled, 0=all

av_active_tag

string | null

近期投稿活跃档位，取值见 /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_id

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_id

内容类目 DMP 人群包 ID / Content-category DMP audience-package ID

category_dmp_label

string | null

内容类目 DMP 人群包展示名称 / Display label for the content-category DMP audience package

dmp_pkg_name

string | null

DMP 特殊人群包名称关键词 / DMP special-audience package name query

dmp_pkg_vertical_rate_gte

DMP 人群垂直度下限：相关视频数占总视频数比例 / Minimum DMP verticality: matching videos divided by all videos

dmp_pkg_vertical_rate_lte

DMP 人群垂直度上限：相关视频数占总视频数比例 / Maximum DMP verticality: matching videos divided by all videos

dmp_pkg_effect_rate_gte

DMP 人群影响力下限：近30天相关观众占该人群总量比例 / Minimum DMP influence: recent matching viewers divided by the audience population

dmp_pkg_effect_rate_lte

DMP 人群影响力上限：近30天相关观众占该人群总量比例 / Maximum DMP influence: recent matching viewers divided by the audience population

dmp_pkg_fan_rate_gte

DMP 人群关注度下限：粉丝中该人群占比 / Minimum DMP attention: matching audience members divided by all followers

dmp_pkg_fan_rate_lte

DMP 人群关注度上限：粉丝中该人群占比 / 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

合作报价筛选数组；先调用 /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

Show child attributes

last_7_days_set_price

integer | null

近7天是否设置过报价：1=是，0=不限 / Quote-updated-in-7-days filter: 1=yes, 0=all

last_14_days_set_price

integer | null

近14天是否设置过报价：1=是，0=不限 / Quote-updated-in-14-days filter: 1=yes, 0=all

last_30_days_set_price

integer | null

近30天是否设置过报价：1=是，0=不限 / Quote-updated-in-30-days filter: 1=yes, 0=all

min_interact_rate

互动率下限；近180天合格原创稿件互动量除以播放量 / Minimum engagement rate for eligible original videos in the last 180 days

max_interact_rate

互动率上限；近180天合格原创稿件互动量除以播放量 / 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

播放量中位数下限；统计近180天且发布满7天的合格原创稿件 / Minimum median views for eligible original videos published at least seven days ago

max_play_median

播放量中位数上限；统计近180天且发布满7天的合格原创稿件 / Maximum median views for eligible original videos published at least seven days ago

play_median_traffic_type

integer | null

播放中位数流量口径：1=全部流量，2=自然流量 / Median-view traffic scope: 1=all traffic, 2=organic traffic

play_median_cycle

integer | null

播放中位数统计周期：1=7天，2=15天，3=30天 / Median-view window: 1=7 days, 2=15 days, 3=30 days

min_cpm

CPM 下限，即花费除以播放量再乘1000 / Minimum CPM, calculated as spend divided by views times 1,000

max_cpm

CPM 上限，即花费除以播放量再乘1000 / Maximum CPM, calculated as spend divided by views times 1,000

cpm_type

integer | null

CPM 流量口径：1=全部流量，2=自然流量 / CPM traffic scope: 1=all traffic, 2=organic traffic

cpm_cycle

integer | null

CPM 统计周期：1=7天，2=15天，3=30天 / CPM window: 1=7 days, 2=15 days, 3=30 days

min_cpc

CPC 下限，即花费除以组件点击次数 / Minimum CPC, calculated as spend divided by component clicks

max_cpc

CPC 上限，即花费除以组件点击次数 / Maximum CPC, calculated as spend divided by component clicks

cpc_traffic_type

integer | null

CPC 流量口径：1=全部流量，2=自然流量 / CPC traffic scope: 1=all traffic, 2=organic traffic

cpc_cycle

integer | null

CPC 统计周期：1=7天，2=15天，3=30天 / CPC window: 1=7 days, 2=15 days, 3=30 days

cpe_gte

CPE 下限，即花费除以有效互动次数 / Minimum CPE, calculated as spend divided by valid engagements

cpe_lt

CPE 上限，即花费除以有效互动次数 / Maximum CPE, calculated as spend divided by valid engagements

cpe_traffic_type

integer | null

CPE 流量口径：1=全部流量，2=自然流量 / CPE traffic scope: 1=all traffic, 2=organic traffic

cpe_cycle

integer | null

CPE 统计周期：1=7天，3=30天 / CPE window: 1=7 days, 3=30 days

draft_duration

主流视频时长：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_cnt

近90天有效原创稿件数下限 / Minimum eligible original-video count in the last 90 days

max_avid_cnt

近90天有效原创稿件数上限 / Maximum eligible original-video count in the last 90 days

min_hot_avid_rate

近90天爆款稿件占比下限 / Minimum viral-video ratio in the last 90 days

max_hot_avid_rate

近90天爆款稿件占比上限 / 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

稿件荣誉没有独立选项接口，取值见 search_upper 文档；honor_type 始终为可多选数组 / 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

非通用行业面板先调用 /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_type

非通用行业策略面板的合作经验类型：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_tags

string[] | null

特色标签列表，取值见 /api/v1/bilibili/huahuo/square_static_info / Feature-tag values from /api/v1/bilibili/huahuo/square_static_info

spark_tag

string[] | null

花火能力标签；通用面板合作次数使用 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_in

string[] | null

广场场景标签，例如 ad_partner_experienced / Marketplace scenario tags such as ad_partner_experienced

label_array

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

先调用 /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_lv5

any[] | null

B站五级内容标签筛选值列表 / Bilibili level-five content-tag filter values

huahuo_first_industry_ids

(integer | string)[] | null

通用面板先调用 /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_ids

(integer | string)[] | null

通用面板先调用 /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_ids

(integer | string)[] | null

通用面板先调用 /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_permission

integer | null

带货权限筛选：1=有权限，0=不限 / Commerce permission filter: 1=required, 0=all

goods_up_levels

(integer | string)[] | null

带货 UP 主等级列表 / Commerce-creator level values

goods_category_first_ids

(integer | string)[] | null

带货一级类目 ID 列表，取值见 /api/v1/bilibili/huahuo/effect_goods_drop / Primary commerce-category IDs from /api/v1/bilibili/huahuo/effect_goods_drop

goods_category_second_ids

(integer | string)[] | null

带货二级类目 ID 列表，取值见 /api/v1/bilibili/huahuo/effect_goods_drop / Secondary commerce-category IDs from /api/v1/bilibili/huahuo/effect_goods_drop

goods_gpm_min

近30天 GPM 下限，即每千次带货视频播放产生的支付 GMV / Minimum 30-day GPM, paid GMV per 1,000 commerce-video views

goods_gpm_max

近30天 GPM 上限，即每千次带货视频播放产生的支付 GMV / 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

带货点击率组件口径：1=全部组件，2=评论区组件 / Commerce CTR component scope: 1=all components, 2=comment component

goods_avg_price_min

近30天商品平均价格下限，单位为人民币元 / Minimum average product price in the last 30 days, in RMB

goods_avg_price_max

近30天商品平均价格上限，单位为人民币元 / Maximum average product price in the last 30 days, in RMB

goods_is_high_video_play_permeate

高视频播放渗透筛选，近30天播放用户占粉丝数比例居前20% / 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

是否筛选内容加热中的 UP 主：1=是，0=不限 / Boosting-status filter: 1=currently boosting, 0=all

is_treasure_up

是否筛选宝藏 UP 主 / Whether to filter for treasure creators

is_timely_response

是否筛选及时响应的 UP 主 / Whether to require timely-response creators

is_new_enter

是否筛选新入驻 UP 主 / Whether to filter for newly onboarded creators

custom_video_pricing_set

是否已设置定制视频报价 / Whether custom-video pricing has been configured

is_x_plan_better_up

是否筛选 X 计划优选 UP 主 / Whether to filter for X Plan preferred creators

high_potential_type

integer | null

高潜类型：0=全部，1=已入驻，2=未入驻 / High-potential type: 0=all, 1=onboarded, 2=not onboarded

响应

200 - application/json

Successful Response

code

integer

默认值:200

HTTP status code | HTTP状态码

request_id

string | null

Unique request identifier | 唯一请求标识符

message

string

默认值:Request successful. This request will incur a charge.

Response message (EN-US) | 响应消息 (English)

message_zh

string

默认值:请求成功，本次请求将被计费。

Response message (ZH-CN) | 响应消息 (中文)

support

string

默认值: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

默认值:America/Los_Angeles

The timezone of the response time | 响应时间的时区

docs

string | null

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_message

string | null

默认值: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) | 缓存消息 (English)

cache_message_zh

string | null

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

Cache message (ZH-CN) | 缓存消息 (中文)

cache_url

string | null

The URL to access the cached result | 访问缓存结果的 URL

router

string

默认值:""

The endpoint that generated this response | 生成此响应的端点

params

any

默认值:{}

The parameters used in the request | 请求中使用的参数

data

any | null

The response data | 响应数据

概览

聊天 API

Embeddings 与重排序

搜索 API

Perplexity API

金融 API

Twitter API

Reddit API

Instagram API

Pinterest API

学术搜索 API

WaveInflu API

预测市场 API

CoinGecko

DataForSEO

AgentMail

Apollo

基础功能

TikHub API

UP主广场搜索（搜UP主

示例

授权

请求体

[中文]

搜索方式:

筛选字段:

[English]

Search modes:

Filter groups:

[示例/Example]

响应

​示例

授权

请求体

[中文]

搜索方式:

筛选字段:

[English]

Search modes:

Filter groups:

[示例/Example]

响应

示例