---
title: "直播广场搜索/Search live creators"
method: POST
path: "/api/v1/bilibili/huahuo/search_live_upper"
tags: ["Bilibili-Huahuo-API"]
---

# 直播广场搜索/Search live creators

`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)
- URL: `https://api.tikhub.io/api/v1/bilibili/huahuo/search_live_upper`
- Auth: HTTP bearer

# [中文]
### 用途:
- 在直播合作广场检索适合内容直播或带货直播合作的主播。
- 按主播属性、粉丝画像、直播分区、直播表现、公会、主营类目和 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.

## Request body

- LiveSearchBody: # [中文] 直播合作广场搜索条件。支持主播属性、粉丝画像、直播分区、内容直播表现、 带货类目和 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, nullable: 按UP主昵称或UID搜索
  - `mids` integer[], nullable: 按UID批量精确匹配
  - `is_brand_live` integer, nullable: 直播类型：1=内容直播 0=带货直播。两种类型可用的筛选项不同
  - `gender` string, nullable: 主播性别
  - `region_id` integer[], nullable: 主播常驻地域（一级）
  - `second_region_id` integer[], nullable: 主播常驻地域（二级）
  - `min_fans_num` integer, nullable: 粉丝数下限
  - `max_fans_num` integer, nullable: 粉丝数上限
  - `fans_gender_tag` string[], nullable: 粉丝性别标签
  - `fans_age_tag` string[], nullable: 粉丝年龄标签
  - `fans_region_tag` string[], nullable: 粉丝地域标签
  - `live_subarea_id` integer[], nullable: 直播分区（二级），取值见 live_area_list
  - `partition_id` integer, nullable: 投稿分区（一级）
  - `second_partition_id` integer[], nullable: 投稿分区（二级）
  - `min_popularity` integer, nullable: 近30天场均人气峰值下限
  - `max_popularity` integer, nullable: 近30天场均人气峰值上限
  - `live_audience_h_avg_30d_min` integer, nullable: 近30天时均观众数下限
  - `live_audience_h_avg_30d_max` integer, nullable: 近30天时均观众数上限
  - `live_danmu_h_avg_30d_min` integer, nullable: 近30天时均弹幕数下限
  - `live_danmu_h_avg_30d_max` integer, nullable: 近30天时均弹幕数上限
  - `live_guild_id` integer[], nullable: 直播公会，取值见 live_guild_drop
  - `high_potential_type` integer, nullable: 入驻状态
  - `live_good_category` integer, nullable: 主营类目，0=全部，取值见 live_good_category
  - `live_good_gmv` integer, nullable: 近90天GMV档位，0=全部
  - `order_by` string, nullable: 排序字段
  - `sort` string, nullable: 排序方向：desc 或 asc
  - `page` integer, nullable: 页码，从 1 开始，每页固定 20 条

## Response `200`

Successful Response

- ResponseModel
  - `code` integer: HTTP status code | HTTP状态码
  - `request_id` string, nullable: Unique request identifier | 唯一请求标识符
  - `message` string: Response message (EN-US) | 响应消息 (English)
  - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文)
  - `support` string: Support message | 支持消息
  - `time` string: The time the response was generated | 生成响应的时间
  - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳
  - `time_zone` string: The timezone of the response time | 响应时间的时区
  - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接
  - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English)
  - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文)
  - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL
  - `router` string: The endpoint that generated this response | 生成此响应的端点
  - `params` unknown
  - `data` unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-08** `96a122a5f220`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-09-01** `50f9ec6e1cd3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/bilibili/huahuo/search_live_upper/post.md)

---

[API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)