TItikhub
Bilibili-Huahuo-API

直播广场搜索/Search live creators

Changed on

[中文]

用途:

  • 在直播合作广场检索适合内容直播或带货直播合作的主播。
  • 按主播属性、粉丝画像、直播分区、直播表现、公会、主营类目和 GMV 筛选。

参数:

  • is_brand_live: 直播类型，1 为内容直播，0 为带货直播。
  • 内容直播可使用人气峰值、时均观众数、时均弹幕数、公会和入驻状态等条件。
  • 带货直播可使用主营类目和近 90 天 GMV 等条件。
  • page: 页码，从 1 开始，每页固定返回 20 条。

返回:

  • total_count: 匹配主播总数。
  • data: 主播列表，包含基础资料、粉丝画像、直播表现及相应合作能力指标。

计费:

  • 0.01 USD / 次。

[English]

Purpose:

  • Search live creators for branded-content or live-commerce collaborations.
  • Filter by creator attributes, audience demographics, live categories, performance, guild, primary commerce category, and GMV.

Parameters:

  • is_brand_live: Live mode. Use 1 for branded-content live streams and 0 for commerce live streams.
  • Branded-content mode supports popularity peak, hourly viewers, hourly comments, guild, and onboarding-status filters.
  • Commerce mode supports primary category and 90-day GMV filters.
  • page: One-based page number. Each page contains 20 records.

Returns:

  • total_count: Total number of matching creators.
  • data: Creator records containing profile, audience, live performance, and collaboration-capability metrics.

Billing:

  • 0.01 USD per request.
post/api/v1/bilibili/huahuo/search_live_upper

Request

  • Base URL
    https://api.tikhub.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Request body

nickname_or_midsstring nullable

按UP主昵称或UID搜索

midsinteger[] nullable

按UID批量精确匹配

is_brand_liveinteger nullable

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

genderstring nullable

主播性别

region_idinteger[] nullable

主播常驻地域（一级）

second_region_idinteger[] nullable

主播常驻地域（二级）

min_fans_numinteger nullable

粉丝数下限

max_fans_numinteger nullable

粉丝数上限

fans_gender_tagstring[] nullable

粉丝性别标签

fans_age_tagstring[] nullable

粉丝年龄标签

fans_region_tagstring[] nullable

粉丝地域标签

live_subarea_idinteger[] nullable

直播分区（二级），取值见 live_area_list

partition_idinteger nullable

投稿分区（一级）

second_partition_idinteger[] nullable

投稿分区（二级）

min_popularityinteger nullable

近30天场均人气峰值下限

max_popularityinteger nullable

近30天场均人气峰值上限

live_audience_h_avg_30d_mininteger nullable

近30天时均观众数下限

live_audience_h_avg_30d_maxinteger nullable

近30天时均观众数上限

live_danmu_h_avg_30d_mininteger nullable

近30天时均弹幕数下限

live_danmu_h_avg_30d_maxinteger nullable

近30天时均弹幕数上限

live_guild_idinteger[] nullable

直播公会，取值见 live_guild_drop

high_potential_typeinteger nullable

入驻状态

live_good_categoryinteger nullable

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

live_good_gmvinteger nullable

近90天GMV档位，0=全部

order_bystring nullable

排序字段

sortstring nullable

排序方向：desc 或 asc

pageinteger nullable

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

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

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

message_zhstring

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

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

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

docsstring nullable

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

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

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

cache_urlstring nullable

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

routerstring

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

paramsunknown
dataunknown

Changes