Skip to main content
POST
bilibili search_live_upper
直播广场搜索 计费 — 按成功调用计费,最终扣费按你的套餐倍率浮动。仅当上游响应体 code 为 200 时计费。

示例

请求规范

完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

公开参考价格:每次成功请求 $0.01 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 0.01
  • 计费依据: fixed_success
  • 公开参考倍率: 1.0
  • 结算证据来源: request_snapshot

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

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.

fans_age_tag
string[] | null

Audience age tag

fans_gender_tag
string[] | null

Audience gender tag

fans_region_tag
string[] | null

Audience region tag

gender
string | null

Anchor gender

high_potential_type
integer | null

Registration status

is_brand_live
integer | null

Live stream type: 1=Content live stream, 0=Commerce live stream. Available filters differ between the two types.

live_audience_h_avg_30d_max
integer | null

Maximum average hourly viewer count in the last 30 days

live_audience_h_avg_30d_min
integer | null

Minimum average hourly viewer count in the last 30 days

live_danmu_h_avg_30d_max
integer | null

Maximum average hourly danmaku count in the last 30 days

live_danmu_h_avg_30d_min
integer | null

Minimum average hourly danmaku count in the last 30 days

live_good_category
integer | null

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).

live_good_gmv
integer | null

90-day GMV tier, 0=all

live_guild_id
integer[] | null

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_subarea_id
integer[] | null

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).

max_fans_num
integer | null

Maximum follower count

max_popularity
integer | null

Maximum average peak popularity per session in the last 30 days

mids
integer[] | null

Batch exact match by UID

min_fans_num
integer | null

Minimum follower count

min_popularity
integer | null

Minimum average peak popularity per session in the last 30 days

nickname_or_mids
string | null

Search by creator nickname or UID

order_by
string | null

排序字段

page
integer | null

Page number starting from 1; 20 items per page

Usage: One-based page number. Each page contains 20 records.

必填范围: x >= 1
partition_id
integer | null

Submission category (level 1)

region_id
integer[] | null

Anchor primary residence region (level 1)

second_partition_id
integer[] | null

Submission category (level 2)

second_region_id
integer[] | null

Anchor primary residence region (level 2)

sort
string | null

Sort direction: desc or asc

响应

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

Cache message (ZH-CN)

cache_url
string | null

The URL to access the cached result

code
integer
默认值:200

HTTP 状态码

data
any

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.

docs
string | null

Link to the API Swagger documentation for this endpoint

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

Response message (EN-US)

message_zh
string
默认值:请求成功,本次请求将被计费。

Response message (ZH-CN)

params
any
默认值:{}

The parameters used in the request

request_id
string | null

Unique request identifier

router
string
默认值:""

The endpoint that generated this response

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