Bilibili Huahuo Search Live Upper

20.65 credits/call
ae_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}}

SocialVideoResearch
20.65 credits/call

Pricing

20.65 credits/call
ConditionCharge
Each call20.65 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectNo# [中文] 直播合作广场搜索条件。支持主播属性、粉丝画像、直播分区、内容直播表现、 带货类目和 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.midsarray | nullNo按UID批量精确匹配—
request_body.pageinteger | nullNo页码,从 1 开始,每页固定 20 条—
request_body.sortstring | nullNo排序方向:desc 或 asc—
request_body.genderstring | nullNo主播性别—
request_body.order_bystring | nullNo排序字段—
request_body.region_idarray | nullNo主播常驻地域(一级)—
request_body.fans_age_tagarray | nullNo粉丝年龄标签—
request_body.max_fans_numinteger | nullNo粉丝数上限—
request_body.min_fans_numinteger | nullNo粉丝数下限—
request_body.partition_idinteger | nullNo投稿分区(一级)—
request_body.is_brand_liveinteger | nullNo直播类型:1=内容直播 0=带货直播。两种类型可用的筛选项不同—
request_body.live_good_gmvinteger | nullNo近90天GMV档位,0=全部—
request_body.live_guild_idarray | nullNo直播公会,取值见 live_guild_drop—
request_body.max_popularityinteger | nullNo近30天场均人气峰值上限—
request_body.min_popularityinteger | nullNo近30天场均人气峰值下限—
request_body.fans_gender_tagarray | nullNo粉丝性别标签—
request_body.fans_region_tagarray | nullNo粉丝地域标签—
request_body.live_subarea_idarray | nullNo直播分区(二级),取值见 live_area_list—
request_body.nickname_or_midsstring | nullNo按UP主昵称或UID搜索—
request_body.second_region_idarray | nullNo主播常驻地域(二级)—
request_body.live_good_categoryinteger | nullNo主营类目,0=全部,取值见 live_good_category—
request_body.high_potential_typeinteger | nullNo入驻状态—
request_body.second_partition_idarray | nullNo投稿分区(二级)—
request_body.live_danmu_h_avg_30d_maxinteger | nullNo近30天时均弹幕数上限—
request_body.live_danmu_h_avg_30d_mininteger | nullNo近30天时均弹幕数下限—
request_body.live_audience_h_avg_30d_maxinteger | nullNo近30天时均观众数上限—
request_body.live_audience_h_avg_30d_mininteger | nullNo近30天时均观众数下限—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.