Explore our Marketplace to buy and sell APIs, services, and social media solutions. Connect with a vibrant community of developers, businesses, and creators!

直播广场搜索/Search live creators

POST

https://api.tikhub.io/api/v1/bilibili/huahuo/search_live_upper

Bilibili-Huahuo-API

Last modified:2026-08-30 09:13:41

OperationId:search_live_upper_api_v1_bilibili_huahuo_search_live_upper_post

[中文]

用途:

在直播合作广场检索适合内容直播或带货直播合作的主播。

按主播属性、粉丝画像、直播分区、直播表现、公会、主营类目和 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

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.tikhub.io/api/v1/bilibili/huahuo/search_live_upper' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "nickname_or_mids": "string",
    "mids": [
        0
    ],
    "is_brand_live": 0,
    "gender": "string",
    "region_id": [
        0
    ],
    "second_region_id": [
        0
    ],
    "min_fans_num": 0,
    "max_fans_num": 0,
    "fans_gender_tag": [
        "string"
    ],
    "fans_age_tag": [
        "string"
    ],
    "fans_region_tag": [
        "string"
    ],
    "live_subarea_id": [
        0
    ],
    "partition_id": 0,
    "second_partition_id": [
        0
    ],
    "min_popularity": 0,
    "max_popularity": 0,
    "live_audience_h_avg_30d_min": 0,
    "live_audience_h_avg_30d_max": 0,
    "live_danmu_h_avg_30d_min": 0,
    "live_danmu_h_avg_30d_max": 0,
    "live_guild_id": [
        0
    ],
    "high_potential_type": 0,
    "live_good_category": 0,
    "live_good_gmv": 0,
    "order_by": "string",
    "sort": "string",
    "page": 1,
    "property1": "string",
    "property2": "string"
}'

Response Example

200 - Example 1

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

Modified at 2026-08-30 09:13:41

UP主搜索联想/Search creator suggestions

UP主详情/Get creator profile

直播广场搜索/Search live creators

[中文]#

用途:#

参数:#

返回:#

计费:#

[English]#

Purpose:#

Parameters:#

Returns:#

Billing:#