Bilibili-Huahuo-API

UP主搜索联想/Search creator suggestions

Changed on

[中文]

用途:

  • 根据昵称片段或 UID 返回候选 UP 主,适合搜索框联想和用户选择。

参数:

  • nickname_or_mids: 必填,昵称片段或 UP 主 UID。
  • page: 页码,从 1 开始。
  • panel_type: 行业策略面板,取值与 search_upper 一致。
  • marketing_target: 营销目标,取值与 search_upper 一致。
  • cpm_type / play_median_traffic_type: 指标流量口径,1=全部流量,2=自然流量。
  • cpm_cycle / play_median_cycle: 指标周期,1=7天,2=15天,3=30天。

返回:

  • 候选 UP 主列表及分页信息,通常包含 UID、昵称、头像和基础账号信息。

计费:

  • 0.006 USD / 次。

[English]

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.

Billing:

  • 0.006 USD per request.

[示例/Example]

GET /search_upper_suggest?nickname_or_mids=小电视&page=1&panel_type=0
    &marketing_target=1&cpm_type=1&cpm_cycle=3
    &play_median_traffic_type=1&play_median_cycle=3
get/api/v1/bilibili/huahuo/search_upper_suggest

Request

  • Base URL
    https://api.tikhub.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Query parameters

nickname_or_midsstring required

昵称片段或 UP 主 UID / Creator nickname fragment or UID

pageinteger

页码,从 1 开始 / One-based page number

panel_typeinteger

行业策略面板,取值同 search_upper / Industry strategy panel; values match search_upper

marketing_targetinteger

营销目标,取值同 search_upper / Marketing objective; values match search_upper

cpm_typeinteger

CPM 流量口径:1=全部流量,2=自然流量 / CPM traffic scope: 1=all, 2=organic

cpm_cycleinteger

CPM 统计周期:1=7天,2=15天,3=30天 / CPM window: 1=7, 2=15, 3=30 days

play_median_traffic_typeinteger

播放中位数流量口径:1=全部流量,2=自然流量 / Median-view traffic scope: 1=all, 2=organic

play_median_cycleinteger

播放中位数周期:1=7天,2=15天,3=30天 / Median-view window: 1=7, 2=15, 3=30 days

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

Response message (EN-US) | 响应消息 (English)

message_zhstring

Response message (ZH-CN) | 响应消息 (中文)

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

The timezone of the response time | 响应时间的时区

docsstring nullable

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

Cache message (ZH-CN) | 缓存消息 (中文)

cache_urlstring nullable

The URL to access the cached result | 访问缓存结果的 URL

routerstring

The endpoint that generated this response | 生成此响应的端点

paramsunknown
dataunknown

Changes

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the new optional query request parameter cpm_cycle

    • info

      added the new optional query request parameter cpm_type

    • info

      added the new optional query request parameter play_median_cycle

    • info

      added the new optional query request parameter play_median_traffic_type