Search live creators
curl --request POST \
--url https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"nickname_or_mids": "<string>",
"mids": [
123
],
"is_brand_live": 123,
"gender": "<string>",
"region_id": [
123
],
"second_region_id": [
123
],
"min_fans_num": 123,
"max_fans_num": 123,
"fans_gender_tag": [
"<string>"
],
"fans_age_tag": [
"<string>"
],
"fans_region_tag": [
"<string>"
],
"live_subarea_id": [
123
],
"partition_id": 123,
"second_partition_id": [
123
],
"min_popularity": 123,
"max_popularity": 123,
"live_audience_h_avg_30d_min": 123,
"live_audience_h_avg_30d_max": 123,
"live_danmu_h_avg_30d_min": 123,
"live_danmu_h_avg_30d_max": 123,
"live_guild_id": [
123
],
"high_potential_type": 123,
"live_good_category": 123,
"live_good_gmv": 123,
"order_by": "<string>",
"sort": "<string>",
"page": 2
}
'import requests
url = "https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper"
payload = {
"nickname_or_mids": "<string>",
"mids": [123],
"is_brand_live": 123,
"gender": "<string>",
"region_id": [123],
"second_region_id": [123],
"min_fans_num": 123,
"max_fans_num": 123,
"fans_gender_tag": ["<string>"],
"fans_age_tag": ["<string>"],
"fans_region_tag": ["<string>"],
"live_subarea_id": [123],
"partition_id": 123,
"second_partition_id": [123],
"min_popularity": 123,
"max_popularity": 123,
"live_audience_h_avg_30d_min": 123,
"live_audience_h_avg_30d_max": 123,
"live_danmu_h_avg_30d_min": 123,
"live_danmu_h_avg_30d_max": 123,
"live_guild_id": [123],
"high_potential_type": 123,
"live_good_category": 123,
"live_good_gmv": 123,
"order_by": "<string>",
"sort": "<string>",
"page": 2
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
nickname_or_mids: '<string>',
mids: [123],
is_brand_live: 123,
gender: '<string>',
region_id: [123],
second_region_id: [123],
min_fans_num: 123,
max_fans_num: 123,
fans_gender_tag: ['<string>'],
fans_age_tag: ['<string>'],
fans_region_tag: ['<string>'],
live_subarea_id: [123],
partition_id: 123,
second_partition_id: [123],
min_popularity: 123,
max_popularity: 123,
live_audience_h_avg_30d_min: 123,
live_audience_h_avg_30d_max: 123,
live_danmu_h_avg_30d_min: 123,
live_danmu_h_avg_30d_max: 123,
live_guild_id: [123],
high_potential_type: 123,
live_good_category: 123,
live_good_gmv: 123,
order_by: '<string>',
sort: '<string>',
page: 2
})
};
fetch('https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'nickname_or_mids' => '<string>',
'mids' => [
123
],
'is_brand_live' => 123,
'gender' => '<string>',
'region_id' => [
123
],
'second_region_id' => [
123
],
'min_fans_num' => 123,
'max_fans_num' => 123,
'fans_gender_tag' => [
'<string>'
],
'fans_age_tag' => [
'<string>'
],
'fans_region_tag' => [
'<string>'
],
'live_subarea_id' => [
123
],
'partition_id' => 123,
'second_partition_id' => [
123
],
'min_popularity' => 123,
'max_popularity' => 123,
'live_audience_h_avg_30d_min' => 123,
'live_audience_h_avg_30d_max' => 123,
'live_danmu_h_avg_30d_min' => 123,
'live_danmu_h_avg_30d_max' => 123,
'live_guild_id' => [
123
],
'high_potential_type' => 123,
'live_good_category' => 123,
'live_good_gmv' => 123,
'order_by' => '<string>',
'sort' => '<string>',
'page' => 2
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper"
payload := strings.NewReader("{\n \"nickname_or_mids\": \"<string>\",\n \"mids\": [\n 123\n ],\n \"is_brand_live\": 123,\n \"gender\": \"<string>\",\n \"region_id\": [\n 123\n ],\n \"second_region_id\": [\n 123\n ],\n \"min_fans_num\": 123,\n \"max_fans_num\": 123,\n \"fans_gender_tag\": [\n \"<string>\"\n ],\n \"fans_age_tag\": [\n \"<string>\"\n ],\n \"fans_region_tag\": [\n \"<string>\"\n ],\n \"live_subarea_id\": [\n 123\n ],\n \"partition_id\": 123,\n \"second_partition_id\": [\n 123\n ],\n \"min_popularity\": 123,\n \"max_popularity\": 123,\n \"live_audience_h_avg_30d_min\": 123,\n \"live_audience_h_avg_30d_max\": 123,\n \"live_danmu_h_avg_30d_min\": 123,\n \"live_danmu_h_avg_30d_max\": 123,\n \"live_guild_id\": [\n 123\n ],\n \"high_potential_type\": 123,\n \"live_good_category\": 123,\n \"live_good_gmv\": 123,\n \"order_by\": \"<string>\",\n \"sort\": \"<string>\",\n \"page\": 2\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"nickname_or_mids\": \"<string>\",\n \"mids\": [\n 123\n ],\n \"is_brand_live\": 123,\n \"gender\": \"<string>\",\n \"region_id\": [\n 123\n ],\n \"second_region_id\": [\n 123\n ],\n \"min_fans_num\": 123,\n \"max_fans_num\": 123,\n \"fans_gender_tag\": [\n \"<string>\"\n ],\n \"fans_age_tag\": [\n \"<string>\"\n ],\n \"fans_region_tag\": [\n \"<string>\"\n ],\n \"live_subarea_id\": [\n 123\n ],\n \"partition_id\": 123,\n \"second_partition_id\": [\n 123\n ],\n \"min_popularity\": 123,\n \"max_popularity\": 123,\n \"live_audience_h_avg_30d_min\": 123,\n \"live_audience_h_avg_30d_max\": 123,\n \"live_danmu_h_avg_30d_min\": 123,\n \"live_danmu_h_avg_30d_max\": 123,\n \"live_guild_id\": [\n 123\n ],\n \"high_potential_type\": 123,\n \"live_good_category\": 123,\n \"live_good_gmv\": 123,\n \"order_by\": \"<string>\",\n \"sort\": \"<string>\",\n \"page\": 2\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"nickname_or_mids\": \"<string>\",\n \"mids\": [\n 123\n ],\n \"is_brand_live\": 123,\n \"gender\": \"<string>\",\n \"region_id\": [\n 123\n ],\n \"second_region_id\": [\n 123\n ],\n \"min_fans_num\": 123,\n \"max_fans_num\": 123,\n \"fans_gender_tag\": [\n \"<string>\"\n ],\n \"fans_age_tag\": [\n \"<string>\"\n ],\n \"fans_region_tag\": [\n \"<string>\"\n ],\n \"live_subarea_id\": [\n 123\n ],\n \"partition_id\": 123,\n \"second_partition_id\": [\n 123\n ],\n \"min_popularity\": 123,\n \"max_popularity\": 123,\n \"live_audience_h_avg_30d_min\": 123,\n \"live_audience_h_avg_30d_max\": 123,\n \"live_danmu_h_avg_30d_min\": 123,\n \"live_danmu_h_avg_30d_max\": 123,\n \"live_guild_id\": [\n 123\n ],\n \"high_potential_type\": 123,\n \"live_good_category\": 123,\n \"live_good_gmv\": 123,\n \"order_by\": \"<string>\",\n \"sort\": \"<string>\",\n \"page\": 2\n}"
response = http.request(request)
puts response.read_body{
"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>"
}Commercial
Search live creators
Search live creators
POST
https://api.aisa.one/apis/v1
/
tikhub
/
bilibili
/
huahuo
/
search_live_upper
Search live creators
curl --request POST \
--url https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"nickname_or_mids": "<string>",
"mids": [
123
],
"is_brand_live": 123,
"gender": "<string>",
"region_id": [
123
],
"second_region_id": [
123
],
"min_fans_num": 123,
"max_fans_num": 123,
"fans_gender_tag": [
"<string>"
],
"fans_age_tag": [
"<string>"
],
"fans_region_tag": [
"<string>"
],
"live_subarea_id": [
123
],
"partition_id": 123,
"second_partition_id": [
123
],
"min_popularity": 123,
"max_popularity": 123,
"live_audience_h_avg_30d_min": 123,
"live_audience_h_avg_30d_max": 123,
"live_danmu_h_avg_30d_min": 123,
"live_danmu_h_avg_30d_max": 123,
"live_guild_id": [
123
],
"high_potential_type": 123,
"live_good_category": 123,
"live_good_gmv": 123,
"order_by": "<string>",
"sort": "<string>",
"page": 2
}
'import requests
url = "https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper"
payload = {
"nickname_or_mids": "<string>",
"mids": [123],
"is_brand_live": 123,
"gender": "<string>",
"region_id": [123],
"second_region_id": [123],
"min_fans_num": 123,
"max_fans_num": 123,
"fans_gender_tag": ["<string>"],
"fans_age_tag": ["<string>"],
"fans_region_tag": ["<string>"],
"live_subarea_id": [123],
"partition_id": 123,
"second_partition_id": [123],
"min_popularity": 123,
"max_popularity": 123,
"live_audience_h_avg_30d_min": 123,
"live_audience_h_avg_30d_max": 123,
"live_danmu_h_avg_30d_min": 123,
"live_danmu_h_avg_30d_max": 123,
"live_guild_id": [123],
"high_potential_type": 123,
"live_good_category": 123,
"live_good_gmv": 123,
"order_by": "<string>",
"sort": "<string>",
"page": 2
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
nickname_or_mids: '<string>',
mids: [123],
is_brand_live: 123,
gender: '<string>',
region_id: [123],
second_region_id: [123],
min_fans_num: 123,
max_fans_num: 123,
fans_gender_tag: ['<string>'],
fans_age_tag: ['<string>'],
fans_region_tag: ['<string>'],
live_subarea_id: [123],
partition_id: 123,
second_partition_id: [123],
min_popularity: 123,
max_popularity: 123,
live_audience_h_avg_30d_min: 123,
live_audience_h_avg_30d_max: 123,
live_danmu_h_avg_30d_min: 123,
live_danmu_h_avg_30d_max: 123,
live_guild_id: [123],
high_potential_type: 123,
live_good_category: 123,
live_good_gmv: 123,
order_by: '<string>',
sort: '<string>',
page: 2
})
};
fetch('https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'nickname_or_mids' => '<string>',
'mids' => [
123
],
'is_brand_live' => 123,
'gender' => '<string>',
'region_id' => [
123
],
'second_region_id' => [
123
],
'min_fans_num' => 123,
'max_fans_num' => 123,
'fans_gender_tag' => [
'<string>'
],
'fans_age_tag' => [
'<string>'
],
'fans_region_tag' => [
'<string>'
],
'live_subarea_id' => [
123
],
'partition_id' => 123,
'second_partition_id' => [
123
],
'min_popularity' => 123,
'max_popularity' => 123,
'live_audience_h_avg_30d_min' => 123,
'live_audience_h_avg_30d_max' => 123,
'live_danmu_h_avg_30d_min' => 123,
'live_danmu_h_avg_30d_max' => 123,
'live_guild_id' => [
123
],
'high_potential_type' => 123,
'live_good_category' => 123,
'live_good_gmv' => 123,
'order_by' => '<string>',
'sort' => '<string>',
'page' => 2
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper"
payload := strings.NewReader("{\n \"nickname_or_mids\": \"<string>\",\n \"mids\": [\n 123\n ],\n \"is_brand_live\": 123,\n \"gender\": \"<string>\",\n \"region_id\": [\n 123\n ],\n \"second_region_id\": [\n 123\n ],\n \"min_fans_num\": 123,\n \"max_fans_num\": 123,\n \"fans_gender_tag\": [\n \"<string>\"\n ],\n \"fans_age_tag\": [\n \"<string>\"\n ],\n \"fans_region_tag\": [\n \"<string>\"\n ],\n \"live_subarea_id\": [\n 123\n ],\n \"partition_id\": 123,\n \"second_partition_id\": [\n 123\n ],\n \"min_popularity\": 123,\n \"max_popularity\": 123,\n \"live_audience_h_avg_30d_min\": 123,\n \"live_audience_h_avg_30d_max\": 123,\n \"live_danmu_h_avg_30d_min\": 123,\n \"live_danmu_h_avg_30d_max\": 123,\n \"live_guild_id\": [\n 123\n ],\n \"high_potential_type\": 123,\n \"live_good_category\": 123,\n \"live_good_gmv\": 123,\n \"order_by\": \"<string>\",\n \"sort\": \"<string>\",\n \"page\": 2\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"nickname_or_mids\": \"<string>\",\n \"mids\": [\n 123\n ],\n \"is_brand_live\": 123,\n \"gender\": \"<string>\",\n \"region_id\": [\n 123\n ],\n \"second_region_id\": [\n 123\n ],\n \"min_fans_num\": 123,\n \"max_fans_num\": 123,\n \"fans_gender_tag\": [\n \"<string>\"\n ],\n \"fans_age_tag\": [\n \"<string>\"\n ],\n \"fans_region_tag\": [\n \"<string>\"\n ],\n \"live_subarea_id\": [\n 123\n ],\n \"partition_id\": 123,\n \"second_partition_id\": [\n 123\n ],\n \"min_popularity\": 123,\n \"max_popularity\": 123,\n \"live_audience_h_avg_30d_min\": 123,\n \"live_audience_h_avg_30d_max\": 123,\n \"live_danmu_h_avg_30d_min\": 123,\n \"live_danmu_h_avg_30d_max\": 123,\n \"live_guild_id\": [\n 123\n ],\n \"high_potential_type\": 123,\n \"live_good_category\": 123,\n \"live_good_gmv\": 123,\n \"order_by\": \"<string>\",\n \"sort\": \"<string>\",\n \"page\": 2\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"nickname_or_mids\": \"<string>\",\n \"mids\": [\n 123\n ],\n \"is_brand_live\": 123,\n \"gender\": \"<string>\",\n \"region_id\": [\n 123\n ],\n \"second_region_id\": [\n 123\n ],\n \"min_fans_num\": 123,\n \"max_fans_num\": 123,\n \"fans_gender_tag\": [\n \"<string>\"\n ],\n \"fans_age_tag\": [\n \"<string>\"\n ],\n \"fans_region_tag\": [\n \"<string>\"\n ],\n \"live_subarea_id\": [\n 123\n ],\n \"partition_id\": 123,\n \"second_partition_id\": [\n 123\n ],\n \"min_popularity\": 123,\n \"max_popularity\": 123,\n \"live_audience_h_avg_30d_min\": 123,\n \"live_audience_h_avg_30d_max\": 123,\n \"live_danmu_h_avg_30d_min\": 123,\n \"live_danmu_h_avg_30d_max\": 123,\n \"live_guild_id\": [\n 123\n ],\n \"high_potential_type\": 123,\n \"live_good_category\": 123,\n \"live_good_gmv\": 123,\n \"order_by\": \"<string>\",\n \"sort\": \"<string>\",\n \"page\": 2\n}"
response = http.request(request)
puts response.read_body{
"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 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
curl -X POST "https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{}' # see request schema below
Authorizations
AIsa API key. Get yours at https://aisa.one
Body
application/json
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.
Search by creator nickname or UID
Batch exact match by UID
Live stream type: 1=Content live stream, 0=Commerce live stream. Available filters differ between the two types.
Anchor gender
Anchor primary residence region (level 1)
Anchor primary residence region (level 2)
Minimum follower count
Maximum follower count
Audience gender tag
Audience age tag
Audience region tag
Live area (second-level); see live_area_list for values
Submission category (level 1)
Submission category (level 2)
Minimum average peak popularity per session in the last 30 days
Maximum average peak popularity per session in the last 30 days
Minimum average hourly viewer count in the last 30 days
Maximum average hourly viewer count in the last 30 days
Minimum average hourly danmaku count in the last 30 days
Maximum average hourly danmaku count in the last 30 days
Live streaming guild; see live_guild_drop for values
Registration status
Primary commerce category; 0=all; valid values from live_good_category
90-day GMV tier, 0=all
Sort field
Sort direction: desc or asc
Page number starting from 1; 20 items per page
Required range:
x >= 1Response
200 - application/json
Successful Response
HTTP status code
Unique request identifier
Response message (EN-US)
Response message (ZH-CN)
Support message
The time the response was generated
The timestamp the response was generated
The timezone of the response time
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)
The URL to access the cached result
The endpoint that generated this response
The parameters used in the request
The response data