Skip to main content
POST
Search live creators
Search live creators 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

Authorizations

Authorization
string
header
required

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

Body

application/json

[中文]

直播合作广场搜索条件。支持主播属性、粉丝画像、直播分区、内容直播表现、 带货类目和 GMV 等筛选维度。所有字段均可选,也可传入额外筛选字段。

[English]

Live collaboration marketplace filters. Supports creator attributes, audience demographics, live categories, content-live performance, commerce categories, and GMV filters. Every field is optional, and additional filter fields may be supplied.

nickname_or_mids
string | null

按UP主昵称或UID搜索

mids
integer[] | null

按UID批量精确匹配

is_brand_live
integer | null

直播类型:1=内容直播 0=带货直播。两种类型可用的筛选项不同

gender
string | null

主播性别

region_id
integer[] | null

主播常驻地域(一级)

second_region_id
integer[] | null

主播常驻地域(二级)

min_fans_num
integer | null

粉丝数下限

max_fans_num
integer | null

粉丝数上限

fans_gender_tag
string[] | null

粉丝性别标签

fans_age_tag
string[] | null

粉丝年龄标签

fans_region_tag
string[] | null

粉丝地域标签

live_subarea_id
integer[] | null

直播分区(二级),取值见 live_area_list

partition_id
integer | null

投稿分区(一级)

second_partition_id
integer[] | null

投稿分区(二级)

min_popularity
integer | null

近30天场均人气峰值下限

max_popularity
integer | null

近30天场均人气峰值上限

live_audience_h_avg_30d_min
integer | null

近30天时均观众数下限

live_audience_h_avg_30d_max
integer | null

近30天时均观众数上限

live_danmu_h_avg_30d_min
integer | null

近30天时均弹幕数下限

live_danmu_h_avg_30d_max
integer | null

近30天时均弹幕数上限

live_guild_id
integer[] | null

直播公会,取值见 live_guild_drop

high_potential_type
integer | null

入驻状态

live_good_category
integer | null

主营类目,0=全部,取值见 live_good_category

live_good_gmv
integer | null

近90天GMV档位,0=全部

order_by
string | null

排序字段

sort
string | null

排序方向:desc 或 asc

page
integer | null

页码,从 1 开始,每页固定 20 条

Required range: x >= 1

Response

200 - application/json

Successful Response

code
integer
default:200

HTTP status code | HTTP状态码

request_id
string | null

Unique request identifier | 唯一请求标识符

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

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

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 | 此端点的 API Swagger 文档链接

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) | 缓存消息 (English)

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

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

cache_url
string | null

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

router
string
default:""

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

params
any
default:{}

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

data
any | null

The response data | 响应数据