Bilibili Huahuo Search Upper Suggest
### Purpose: - Return creator suggestions for a nickname fragment or UID, suitable for autocomplete fields and creator selection. ### Parameters: - `nickname_or_mids`: Required nickname fragment or creator UID. - `page`: One-based page number. - `panel_type`: Industry strategy panel, using the same values as `search_upper`. - `marketing_target`: Marketing objective, using the same values as `search_upper`. - `cpm_type` / `play_median_traffic_type`: Metric traffic scope; 1=all traffic and 2=organic traffic. - `cpm_cycle` / `play_median_cycle`: Measurement window; 1=7 days, 2=15 days, and 3=30 days. ### Returns: - Suggested creators and pagination information, typically including UID, nickname, avatar, and basic account details. This is a supporting configuration, filter-value, or label lookup for related Huahuo queries. AE input example: {"page":1,"panel_type":0,"marketing_target":1,"cpm_type":1,"cpm_cycle":3,"play_median_traffic_type":1,"play_median_cycle":3,"nickname_or_mids":"影视飓风"}
Pricing
| Condition | Charge |
|---|---|
| Each call | 12.39 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | 页码,从 1 开始 / One-based page number | 1 |
cpm_type | integer | No | CPM 流量口径:1=全部流量,2=自然流量 / CPM traffic scope: 1=all, 2=organic | 1 |
cpm_cycle | integer | No | CPM 统计周期:1=7天,2=15天,3=30天 / CPM window: 1=7, 2=15, 3=30 days | 3 |
panel_type | integer | No | 行业策略面板,取值同 search_upper / Industry strategy panel; values match search_upper | 0 |
marketing_target | integer | No | 营销目标,取值同 search_upper / Marketing objective; values match search_upper | 1 |
nickname_or_mids | string | Yes | 昵称片段或 UP 主 UID / Creator nickname fragment or UID | — |
play_median_cycle | integer | No | 播放中位数周期:1=7天,2=15天,3=30天 / Median-view window: 1=7, 2=15, 3=30 days | 3 |
play_median_traffic_type | integer | No | 播放中位数流量口径:1=全部流量,2=自然流量 / Median-view traffic scope: 1=all, 2=organic | 1 |
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_upper_suggest' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"cpm_cycle": 3,
"cpm_type": 1,
"marketing_target": 1,
"nickname_or_mids": "影视飓风",
"page": 1,
"panel_type": 0,
"play_median_cycle": 3,
"play_median_traffic_type": 1
}
}'{
"code": 200,
"data": [
{
"head_img": "https://i0.hdslb.com/bfs/face/c1733474892caa45952b2c09a89323157df7129a.jpg",
"mid": 946974,
"nickname": "影视飓风"
}
],
"docs": "https://api.tikhub.io/#/Bilibili-Huahuo-API/search_upper_suggest_api_v1_bilibili_huahuo_search_upper_suggest_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"cpm_cycle": "3",
"cpm_type": "1",
"marketing_target": "1",
"nickname_or_mids": "影视飓风",
"page": "1",
"panel_type": "0"
}
}This example shows part of the response. Copied content is valid JSON.

