bilibili search_live_upper
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 '
{
"fans_age_tag": [
"<string>"
],
"fans_gender_tag": [
"<string>"
],
"fans_region_tag": [
"<string>"
],
"gender": "<string>",
"high_potential_type": 123,
"is_brand_live": 123,
"live_audience_h_avg_30d_max": 123,
"live_audience_h_avg_30d_min": 123,
"live_danmu_h_avg_30d_max": 123,
"live_danmu_h_avg_30d_min": 123,
"live_good_category": 123,
"live_good_gmv": 123,
"live_guild_id": [
123
],
"live_subarea_id": [
123
],
"max_fans_num": 123,
"max_popularity": 123,
"mids": [
123
],
"min_fans_num": 123,
"min_popularity": 123,
"nickname_or_mids": "<string>",
"order_by": "<string>",
"page": 2,
"partition_id": 123,
"region_id": [
123
],
"second_partition_id": [
123
],
"second_region_id": [
123
],
"sort": "<string>"
}
'import requests
url = "https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper"
payload = {
"fans_age_tag": ["<string>"],
"fans_gender_tag": ["<string>"],
"fans_region_tag": ["<string>"],
"gender": "<string>",
"high_potential_type": 123,
"is_brand_live": 123,
"live_audience_h_avg_30d_max": 123,
"live_audience_h_avg_30d_min": 123,
"live_danmu_h_avg_30d_max": 123,
"live_danmu_h_avg_30d_min": 123,
"live_good_category": 123,
"live_good_gmv": 123,
"live_guild_id": [123],
"live_subarea_id": [123],
"max_fans_num": 123,
"max_popularity": 123,
"mids": [123],
"min_fans_num": 123,
"min_popularity": 123,
"nickname_or_mids": "<string>",
"order_by": "<string>",
"page": 2,
"partition_id": 123,
"region_id": [123],
"second_partition_id": [123],
"second_region_id": [123],
"sort": "<string>"
}
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({
fans_age_tag: ['<string>'],
fans_gender_tag: ['<string>'],
fans_region_tag: ['<string>'],
gender: '<string>',
high_potential_type: 123,
is_brand_live: 123,
live_audience_h_avg_30d_max: 123,
live_audience_h_avg_30d_min: 123,
live_danmu_h_avg_30d_max: 123,
live_danmu_h_avg_30d_min: 123,
live_good_category: 123,
live_good_gmv: 123,
live_guild_id: [123],
live_subarea_id: [123],
max_fans_num: 123,
max_popularity: 123,
mids: [123],
min_fans_num: 123,
min_popularity: 123,
nickname_or_mids: '<string>',
order_by: '<string>',
page: 2,
partition_id: 123,
region_id: [123],
second_partition_id: [123],
second_region_id: [123],
sort: '<string>'
})
};
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([
'fans_age_tag' => [
'<string>'
],
'fans_gender_tag' => [
'<string>'
],
'fans_region_tag' => [
'<string>'
],
'gender' => '<string>',
'high_potential_type' => 123,
'is_brand_live' => 123,
'live_audience_h_avg_30d_max' => 123,
'live_audience_h_avg_30d_min' => 123,
'live_danmu_h_avg_30d_max' => 123,
'live_danmu_h_avg_30d_min' => 123,
'live_good_category' => 123,
'live_good_gmv' => 123,
'live_guild_id' => [
123
],
'live_subarea_id' => [
123
],
'max_fans_num' => 123,
'max_popularity' => 123,
'mids' => [
123
],
'min_fans_num' => 123,
'min_popularity' => 123,
'nickname_or_mids' => '<string>',
'order_by' => '<string>',
'page' => 2,
'partition_id' => 123,
'region_id' => [
123
],
'second_partition_id' => [
123
],
'second_region_id' => [
123
],
'sort' => '<string>'
]),
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 \"fans_age_tag\": [\n \"<string>\"\n ],\n \"fans_gender_tag\": [\n \"<string>\"\n ],\n \"fans_region_tag\": [\n \"<string>\"\n ],\n \"gender\": \"<string>\",\n \"high_potential_type\": 123,\n \"is_brand_live\": 123,\n \"live_audience_h_avg_30d_max\": 123,\n \"live_audience_h_avg_30d_min\": 123,\n \"live_danmu_h_avg_30d_max\": 123,\n \"live_danmu_h_avg_30d_min\": 123,\n \"live_good_category\": 123,\n \"live_good_gmv\": 123,\n \"live_guild_id\": [\n 123\n ],\n \"live_subarea_id\": [\n 123\n ],\n \"max_fans_num\": 123,\n \"max_popularity\": 123,\n \"mids\": [\n 123\n ],\n \"min_fans_num\": 123,\n \"min_popularity\": 123,\n \"nickname_or_mids\": \"<string>\",\n \"order_by\": \"<string>\",\n \"page\": 2,\n \"partition_id\": 123,\n \"region_id\": [\n 123\n ],\n \"second_partition_id\": [\n 123\n ],\n \"second_region_id\": [\n 123\n ],\n \"sort\": \"<string>\"\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 \"fans_age_tag\": [\n \"<string>\"\n ],\n \"fans_gender_tag\": [\n \"<string>\"\n ],\n \"fans_region_tag\": [\n \"<string>\"\n ],\n \"gender\": \"<string>\",\n \"high_potential_type\": 123,\n \"is_brand_live\": 123,\n \"live_audience_h_avg_30d_max\": 123,\n \"live_audience_h_avg_30d_min\": 123,\n \"live_danmu_h_avg_30d_max\": 123,\n \"live_danmu_h_avg_30d_min\": 123,\n \"live_good_category\": 123,\n \"live_good_gmv\": 123,\n \"live_guild_id\": [\n 123\n ],\n \"live_subarea_id\": [\n 123\n ],\n \"max_fans_num\": 123,\n \"max_popularity\": 123,\n \"mids\": [\n 123\n ],\n \"min_fans_num\": 123,\n \"min_popularity\": 123,\n \"nickname_or_mids\": \"<string>\",\n \"order_by\": \"<string>\",\n \"page\": 2,\n \"partition_id\": 123,\n \"region_id\": [\n 123\n ],\n \"second_partition_id\": [\n 123\n ],\n \"second_region_id\": [\n 123\n ],\n \"sort\": \"<string>\"\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 \"fans_age_tag\": [\n \"<string>\"\n ],\n \"fans_gender_tag\": [\n \"<string>\"\n ],\n \"fans_region_tag\": [\n \"<string>\"\n ],\n \"gender\": \"<string>\",\n \"high_potential_type\": 123,\n \"is_brand_live\": 123,\n \"live_audience_h_avg_30d_max\": 123,\n \"live_audience_h_avg_30d_min\": 123,\n \"live_danmu_h_avg_30d_max\": 123,\n \"live_danmu_h_avg_30d_min\": 123,\n \"live_good_category\": 123,\n \"live_good_gmv\": 123,\n \"live_guild_id\": [\n 123\n ],\n \"live_subarea_id\": [\n 123\n ],\n \"max_fans_num\": 123,\n \"max_popularity\": 123,\n \"mids\": [\n 123\n ],\n \"min_fans_num\": 123,\n \"min_popularity\": 123,\n \"nickname_or_mids\": \"<string>\",\n \"order_by\": \"<string>\",\n \"page\": 2,\n \"partition_id\": 123,\n \"region_id\": [\n 123\n ],\n \"second_partition_id\": [\n 123\n ],\n \"second_region_id\": [\n 123\n ],\n \"sort\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"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": "本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。",
"cache_url": "<string>",
"code": 200,
"data": "<unknown>",
"docs": "<string>",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功，本次请求将被计费。",
"params": {},
"request_id": "<string>",
"router": "",
"support": "Discord: https://discord.gg/aMEAS8Xsvz",
"time": "<string>",
"time_stamp": 123,
"time_zone": "America/Los_Angeles"
}Commercial
bilibili search_live_upper
Search live creators
POST
https://api.aisa.one
/
apis
/
v1
/
tikhub
/
bilibili
/
huahuo
/
search_live_upper
bilibili search_live_upper
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 '
{
"fans_age_tag": [
"<string>"
],
"fans_gender_tag": [
"<string>"
],
"fans_region_tag": [
"<string>"
],
"gender": "<string>",
"high_potential_type": 123,
"is_brand_live": 123,
"live_audience_h_avg_30d_max": 123,
"live_audience_h_avg_30d_min": 123,
"live_danmu_h_avg_30d_max": 123,
"live_danmu_h_avg_30d_min": 123,
"live_good_category": 123,
"live_good_gmv": 123,
"live_guild_id": [
123
],
"live_subarea_id": [
123
],
"max_fans_num": 123,
"max_popularity": 123,
"mids": [
123
],
"min_fans_num": 123,
"min_popularity": 123,
"nickname_or_mids": "<string>",
"order_by": "<string>",
"page": 2,
"partition_id": 123,
"region_id": [
123
],
"second_partition_id": [
123
],
"second_region_id": [
123
],
"sort": "<string>"
}
'import requests
url = "https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper"
payload = {
"fans_age_tag": ["<string>"],
"fans_gender_tag": ["<string>"],
"fans_region_tag": ["<string>"],
"gender": "<string>",
"high_potential_type": 123,
"is_brand_live": 123,
"live_audience_h_avg_30d_max": 123,
"live_audience_h_avg_30d_min": 123,
"live_danmu_h_avg_30d_max": 123,
"live_danmu_h_avg_30d_min": 123,
"live_good_category": 123,
"live_good_gmv": 123,
"live_guild_id": [123],
"live_subarea_id": [123],
"max_fans_num": 123,
"max_popularity": 123,
"mids": [123],
"min_fans_num": 123,
"min_popularity": 123,
"nickname_or_mids": "<string>",
"order_by": "<string>",
"page": 2,
"partition_id": 123,
"region_id": [123],
"second_partition_id": [123],
"second_region_id": [123],
"sort": "<string>"
}
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({
fans_age_tag: ['<string>'],
fans_gender_tag: ['<string>'],
fans_region_tag: ['<string>'],
gender: '<string>',
high_potential_type: 123,
is_brand_live: 123,
live_audience_h_avg_30d_max: 123,
live_audience_h_avg_30d_min: 123,
live_danmu_h_avg_30d_max: 123,
live_danmu_h_avg_30d_min: 123,
live_good_category: 123,
live_good_gmv: 123,
live_guild_id: [123],
live_subarea_id: [123],
max_fans_num: 123,
max_popularity: 123,
mids: [123],
min_fans_num: 123,
min_popularity: 123,
nickname_or_mids: '<string>',
order_by: '<string>',
page: 2,
partition_id: 123,
region_id: [123],
second_partition_id: [123],
second_region_id: [123],
sort: '<string>'
})
};
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([
'fans_age_tag' => [
'<string>'
],
'fans_gender_tag' => [
'<string>'
],
'fans_region_tag' => [
'<string>'
],
'gender' => '<string>',
'high_potential_type' => 123,
'is_brand_live' => 123,
'live_audience_h_avg_30d_max' => 123,
'live_audience_h_avg_30d_min' => 123,
'live_danmu_h_avg_30d_max' => 123,
'live_danmu_h_avg_30d_min' => 123,
'live_good_category' => 123,
'live_good_gmv' => 123,
'live_guild_id' => [
123
],
'live_subarea_id' => [
123
],
'max_fans_num' => 123,
'max_popularity' => 123,
'mids' => [
123
],
'min_fans_num' => 123,
'min_popularity' => 123,
'nickname_or_mids' => '<string>',
'order_by' => '<string>',
'page' => 2,
'partition_id' => 123,
'region_id' => [
123
],
'second_partition_id' => [
123
],
'second_region_id' => [
123
],
'sort' => '<string>'
]),
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 \"fans_age_tag\": [\n \"<string>\"\n ],\n \"fans_gender_tag\": [\n \"<string>\"\n ],\n \"fans_region_tag\": [\n \"<string>\"\n ],\n \"gender\": \"<string>\",\n \"high_potential_type\": 123,\n \"is_brand_live\": 123,\n \"live_audience_h_avg_30d_max\": 123,\n \"live_audience_h_avg_30d_min\": 123,\n \"live_danmu_h_avg_30d_max\": 123,\n \"live_danmu_h_avg_30d_min\": 123,\n \"live_good_category\": 123,\n \"live_good_gmv\": 123,\n \"live_guild_id\": [\n 123\n ],\n \"live_subarea_id\": [\n 123\n ],\n \"max_fans_num\": 123,\n \"max_popularity\": 123,\n \"mids\": [\n 123\n ],\n \"min_fans_num\": 123,\n \"min_popularity\": 123,\n \"nickname_or_mids\": \"<string>\",\n \"order_by\": \"<string>\",\n \"page\": 2,\n \"partition_id\": 123,\n \"region_id\": [\n 123\n ],\n \"second_partition_id\": [\n 123\n ],\n \"second_region_id\": [\n 123\n ],\n \"sort\": \"<string>\"\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 \"fans_age_tag\": [\n \"<string>\"\n ],\n \"fans_gender_tag\": [\n \"<string>\"\n ],\n \"fans_region_tag\": [\n \"<string>\"\n ],\n \"gender\": \"<string>\",\n \"high_potential_type\": 123,\n \"is_brand_live\": 123,\n \"live_audience_h_avg_30d_max\": 123,\n \"live_audience_h_avg_30d_min\": 123,\n \"live_danmu_h_avg_30d_max\": 123,\n \"live_danmu_h_avg_30d_min\": 123,\n \"live_good_category\": 123,\n \"live_good_gmv\": 123,\n \"live_guild_id\": [\n 123\n ],\n \"live_subarea_id\": [\n 123\n ],\n \"max_fans_num\": 123,\n \"max_popularity\": 123,\n \"mids\": [\n 123\n ],\n \"min_fans_num\": 123,\n \"min_popularity\": 123,\n \"nickname_or_mids\": \"<string>\",\n \"order_by\": \"<string>\",\n \"page\": 2,\n \"partition_id\": 123,\n \"region_id\": [\n 123\n ],\n \"second_partition_id\": [\n 123\n ],\n \"second_region_id\": [\n 123\n ],\n \"sort\": \"<string>\"\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 \"fans_age_tag\": [\n \"<string>\"\n ],\n \"fans_gender_tag\": [\n \"<string>\"\n ],\n \"fans_region_tag\": [\n \"<string>\"\n ],\n \"gender\": \"<string>\",\n \"high_potential_type\": 123,\n \"is_brand_live\": 123,\n \"live_audience_h_avg_30d_max\": 123,\n \"live_audience_h_avg_30d_min\": 123,\n \"live_danmu_h_avg_30d_max\": 123,\n \"live_danmu_h_avg_30d_min\": 123,\n \"live_good_category\": 123,\n \"live_good_gmv\": 123,\n \"live_guild_id\": [\n 123\n ],\n \"live_subarea_id\": [\n 123\n ],\n \"max_fans_num\": 123,\n \"max_popularity\": 123,\n \"mids\": [\n 123\n ],\n \"min_fans_num\": 123,\n \"min_popularity\": 123,\n \"nickname_or_mids\": \"<string>\",\n \"order_by\": \"<string>\",\n \"page\": 2,\n \"partition_id\": 123,\n \"region_id\": [\n 123\n ],\n \"second_partition_id\": [\n 123\n ],\n \"second_region_id\": [\n 123\n ],\n \"sort\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"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": "本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。",
"cache_url": "<string>",
"code": 200,
"data": "<unknown>",
"docs": "<string>",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功，本次请求将被计费。",
"params": {},
"request_id": "<string>",
"router": "",
"support": "Discord: https://discord.gg/aMEAS8Xsvz",
"time": "<string>",
"time_stamp": 123,
"time_zone": "America/Los_Angeles"
}Search live creators
Pricing — billed per successful call; the 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
Request contract
- Method and path: POST /apis/v1/tikhub/bilibili/huahuo/search_live_upper
- Availability: enabled
- Request URL template:
https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper - Runtime facts: 85ae03121f63417c9ff9d57a0fd59fdc6386fd71e2dc732a002843e6d8979d87
{
"operationId": "post_tikhub_bilibili_huahuo_search_live_upper",
"method": "POST",
"path": "/apis/v1/tikhub/bilibili/huahuo/search_live_upper",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [],
"security": [
{
"bearerAuth": []
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"additionalProperties": true,
"description": "Live collaboration marketplace filters. Supports creator attributes,\naudience demographics, live categories, content-live performance,\ncommerce categories, and GMV filters. Every field is optional, and\nadditional filter fields may be supplied.",
"properties": {
"fans_age_tag": {
"description": "Audience age tag",
"items": {
"type": "string"
},
"title": "Fans Age Tag",
"type": [
"array",
"null"
]
},
"fans_gender_tag": {
"description": "Audience gender tag",
"items": {
"type": "string"
},
"title": "Fans Gender Tag",
"type": [
"array",
"null"
]
},
"fans_region_tag": {
"description": "Audience region tag",
"items": {
"type": "string"
},
"title": "Fans Region Tag",
"type": [
"array",
"null"
]
},
"gender": {
"description": "Anchor gender",
"title": "Gender",
"type": [
"string",
"null"
]
},
"high_potential_type": {
"description": "Registration status",
"title": "High Potential Type",
"type": [
"integer",
"null"
]
},
"is_brand_live": {
"description": "Live stream type: 1=Content live stream, 0=Commerce live stream. Available filters differ between the two types.",
"title": "Is Brand Live",
"type": [
"integer",
"null"
]
},
"live_audience_h_avg_30d_max": {
"description": "Maximum average hourly viewer count in the last 30 days",
"title": "Live Audience H Avg 30D Max",
"type": [
"integer",
"null"
]
},
"live_audience_h_avg_30d_min": {
"description": "Minimum average hourly viewer count in the last 30 days",
"title": "Live Audience H Avg 30D Min",
"type": [
"integer",
"null"
]
},
"live_danmu_h_avg_30d_max": {
"description": "Maximum average hourly danmaku count in the last 30 days",
"title": "Live Danmu H Avg 30D Max",
"type": [
"integer",
"null"
]
},
"live_danmu_h_avg_30d_min": {
"description": "Minimum average hourly danmaku count in the last 30 days",
"title": "Live Danmu H Avg 30D Min",
"type": [
"integer",
"null"
]
},
"live_good_category": {
"description": "Primary commerce category; 0=all; valid values from live_good_category\n\nAPI references: `live_good_category` = `GET /tikhub/bilibili/huahuo/live_good_category` (operationId: `get_tikhub_bilibili_huahuo_live_good_category`).",
"title": "Live Good Category",
"type": [
"integer",
"null"
]
},
"live_good_gmv": {
"description": "90-day GMV tier, 0=all",
"title": "Live Good Gmv",
"type": [
"integer",
"null"
]
},
"live_guild_id": {
"description": "Live streaming guild; see live_guild_drop for values\n\nAPI references: `live_guild_drop` = `GET /tikhub/bilibili/huahuo/live_guild_drop` (operationId: `get_tikhub_bilibili_huahuo_live_guild_drop`).",
"items": {
"type": "integer"
},
"title": "Live Guild Id",
"type": [
"array",
"null"
]
},
"live_subarea_id": {
"description": "Live area (second-level); see live_area_list for values\n\nAPI references: `live_area_list` = `GET /tikhub/bilibili/huahuo/live_area_list` (operationId: `get_tikhub_bilibili_huahuo_live_area_list`).",
"items": {
"type": "integer"
},
"title": "Live Subarea Id",
"type": [
"array",
"null"
]
},
"max_fans_num": {
"description": "Maximum follower count",
"title": "Max Fans Num",
"type": [
"integer",
"null"
]
},
"max_popularity": {
"description": "Maximum average peak popularity per session in the last 30 days",
"title": "Max Popularity",
"type": [
"integer",
"null"
]
},
"mids": {
"description": "Batch exact match by UID",
"items": {
"type": "integer"
},
"title": "Mids",
"type": [
"array",
"null"
]
},
"min_fans_num": {
"description": "Minimum follower count",
"title": "Min Fans Num",
"type": [
"integer",
"null"
]
},
"min_popularity": {
"description": "Minimum average peak popularity per session in the last 30 days",
"title": "Min Popularity",
"type": [
"integer",
"null"
]
},
"nickname_or_mids": {
"description": "Search by creator nickname or UID",
"title": "Nickname Or Mids",
"type": [
"string",
"null"
]
},
"order_by": {
"description": "Sort field",
"title": "Order By",
"type": [
"string",
"null"
]
},
"page": {
"description": "Page number starting from 1; 20 items per page\n\nUsage: One-based page number. Each page contains 20 records.",
"minimum": 1.0,
"title": "Page",
"type": [
"integer",
"null"
]
},
"partition_id": {
"description": "Submission category (level 1)",
"title": "Partition Id",
"type": [
"integer",
"null"
]
},
"region_id": {
"description": "Anchor primary residence region (level 1)",
"items": {
"type": "integer"
},
"title": "Region Id",
"type": [
"array",
"null"
]
},
"second_partition_id": {
"description": "Submission category (level 2)",
"items": {
"type": "integer"
},
"title": "Second Partition Id",
"type": [
"array",
"null"
]
},
"second_region_id": {
"description": "Anchor primary residence region (level 2)",
"items": {
"type": "integer"
},
"title": "Second Region Id",
"type": [
"array",
"null"
]
},
"sort": {
"description": "Sort direction: desc or asc",
"title": "Sort",
"type": [
"string",
"null"
]
}
},
"title": "LiveSearchBody",
"type": "object"
}
}
}
},
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"cost_contract": "fixed_success",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.01,
"estimate_source": "profile_seed",
"evidence_source": "request_snapshot"
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
Cost and request rules
Published reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.- Default request reference estimate (USD): 0.01
- Cost contract: fixed_success
- Published reference multiplier: 1.0
- Settlement evidence source: request_snapshot
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
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.
Audience age tag
Audience gender tag
Audience region tag
Anchor gender
Registration status
Live stream type: 1=Content live stream, 0=Commerce live stream. Available filters differ between the two types.
Maximum average hourly viewer count in the last 30 days
Minimum average hourly viewer count in the last 30 days
Maximum average hourly danmaku count in the last 30 days
Minimum average hourly danmaku count in the last 30 days
Primary commerce category; 0=all; valid values from live_good_category
API references: live_good_category = GET /tikhub/bilibili/huahuo/live_good_category (operationId: get_tikhub_bilibili_huahuo_live_good_category).
90-day GMV tier, 0=all
Live streaming guild; see live_guild_drop for values
API references: live_guild_drop = GET /tikhub/bilibili/huahuo/live_guild_drop (operationId: get_tikhub_bilibili_huahuo_live_guild_drop).
Live area (second-level); see live_area_list for values
API references: live_area_list = GET /tikhub/bilibili/huahuo/live_area_list (operationId: get_tikhub_bilibili_huahuo_live_area_list).
Maximum follower count
Maximum average peak popularity per session in the last 30 days
Batch exact match by UID
Minimum follower count
Minimum average peak popularity per session in the last 30 days
Search by creator nickname or UID
Sort field
Page number starting from 1; 20 items per page
Usage: One-based page number. Each page contains 20 records.
Required range:
x >= 1Submission category (level 1)
Anchor primary residence region (level 1)
Submission category (level 2)
Anchor primary residence region (level 2)
Sort direction: desc or asc
Response
Successful Response
Returns
total_count: Total number of matching creators.data: Creator records containing profile, audience, live performance, and collaboration-capability metrics.
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)
The URL to access the cached result
HTTP status code
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.
Link to the API Swagger documentation for this endpoint
Response message (EN-US)
Response message (ZH-CN)
The parameters used in the request
Unique request identifier
The endpoint that generated this response
Support message
The time the response was generated
The timestamp the response was generated
The timezone of the response time