Bilibili Huahuo Search Live Upper
### 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. AE input example: {"request_body":{"page":1}}
Pricing
| Condition | Charge |
|---|---|
| Each call | 20.65 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | No | # [中文] 直播合作广场搜索条件。支持主播属性、粉丝画像、直播分区、内容直播表现、 带货类目和 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. | — |
request_body.mids | array | null | No | 按UID批量精确匹配 | — |
request_body.page | integer | null | No | 页码,从 1 开始,每页固定 20 条 | — |
request_body.sort | string | null | No | 排序方向:desc 或 asc | — |
request_body.gender | string | null | No | 主播性别 | — |
request_body.order_by | string | null | No | 排序字段 | — |
request_body.region_id | array | null | No | 主播常驻地域(一级) | — |
request_body.fans_age_tag | array | null | No | 粉丝年龄标签 | — |
request_body.max_fans_num | integer | null | No | 粉丝数上限 | — |
request_body.min_fans_num | integer | null | No | 粉丝数下限 | — |
request_body.partition_id | integer | null | No | 投稿分区(一级) | — |
request_body.is_brand_live | integer | null | No | 直播类型:1=内容直播 0=带货直播。两种类型可用的筛选项不同 | — |
request_body.live_good_gmv | integer | null | No | 近90天GMV档位,0=全部 | — |
request_body.live_guild_id | array | null | No | 直播公会,取值见 live_guild_drop | — |
request_body.max_popularity | integer | null | No | 近30天场均人气峰值上限 | — |
request_body.min_popularity | integer | null | No | 近30天场均人气峰值下限 | — |
request_body.fans_gender_tag | array | null | No | 粉丝性别标签 | — |
request_body.fans_region_tag | array | null | No | 粉丝地域标签 | — |
request_body.live_subarea_id | array | null | No | 直播分区(二级),取值见 live_area_list | — |
request_body.nickname_or_mids | string | null | No | 按UP主昵称或UID搜索 | — |
request_body.second_region_id | array | null | No | 主播常驻地域(二级) | — |
request_body.live_good_category | integer | null | No | 主营类目,0=全部,取值见 live_good_category | — |
request_body.high_potential_type | integer | null | No | 入驻状态 | — |
request_body.second_partition_id | array | null | No | 投稿分区(二级) | — |
request_body.live_danmu_h_avg_30d_max | integer | null | No | 近30天时均弹幕数上限 | — |
request_body.live_danmu_h_avg_30d_min | integer | null | No | 近30天时均弹幕数下限 | — |
request_body.live_audience_h_avg_30d_max | integer | null | No | 近30天时均观众数上限 | — |
request_body.live_audience_h_avg_30d_min | integer | null | No | 近30天时均观众数下限 | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_bilibili_huahuo_search_live_upper' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"page": 1
}
}
}'{
"code": 200,
"data": {
"data": [
{
"active_status": 1,
"app_vv_percent": 0.8625,
"app_vv_percent_desc": "80~90%",
"average_play_cnt": 496229,
"avg_acu_30d": "高于75%同类UP主",
"avg_pcu_30d": "高于75%同类UP主"
}
],
"page": 1,
"total_count": 10000
},
"docs": "https://api.tikhub.io/#/Bilibili-Huahuo-API/search_live_upper_api_v1_bilibili_huahuo_search_live_upper_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "226c7868-6d8f-47c6-b72a-937474949042"
}This example shows part of the response. Copied content is valid JSON.

