Bilibili-Huahuo-API

UP主广场搜索(搜UP主 / 搜内容)/Search Huahuo creators or content

Changed on

[中文]

用途:

  • 在花火内容合作广场按 UP 主、UID 或内容关键词检索创作者。
  • 可组合基础属性、粉丝画像、报价与效果、内容表现、DMP 人群包、行业标签、 合作经验和带货能力等筛选条件。
  • nickname_or_mids 与 main_search 分别对应“搜 UP 主”和“搜内容”,建议二选一。

参数:

基础搜索参数:

  • nickname_or_mids: 按昵称或 UID 搜索 UP 主;多个词使用英文逗号分隔。
  • main_search: 按内容关键词搜索;命中的稿件随 UP 主结果返回。通常与 nickname_or_mids 二选一。
  • mids: 批量精确匹配的 UID 列表;upper_mid: 单个 UID 精确匹配。
  • folder_id: 将结果限定在指定的已保存 UP 主文件夹内。
  • marketing_target: 营销目标,1=品牌曝光、2=心智种草、3=效果转化。
  • panel_type: 行业策略面板,0=通用、1=游戏、2=美妆、3=数码、 4=汽车、5=效果、6=食饮、8=网服。
  • order_by: 排序字段,例如 fans_num、play_median、interactive_rate; sort: desc=降序、asc=升序。
  • page: 从 1 开始的页码,每页返回 20 条;request_id: 可选搜索会话标识, 同组条件翻页时可复用。

UP 主属性与归属参数:

  • gender: UP 主性别,使用 square_static_info.gender_info 的值。
  • min_fans_num / max_fans_num: 粉丝数下限和上限,边界值包含在内。
  • region_id / second_region_id: 常驻地域一级、二级 ID 列表,取值见 region_drop。 北京、上海、福建,以及福建下的厦门和福州多选示例为 {"region_id":[4,5,23],"second_region_id":[51,50]}。
  • partition_id / second_partition_id: 内容一级、二级分区 ID,取值见 partition_drop。
  • mcn_ids: MCN 机构 ID 列表,取值见 mcn_drop;provider_id: 服务商 ID 列表。
  • upper_types: 账号类型,1 或 4=机构签约,3=个人。
  • only_contract: 1=仅查看可签约账号,0=不限。
  • is_painter_order: 是否要求 UP 主具备画师约稿能力。

粉丝画像与 DMP 参数:

  • fans_age_tag、fans_gender_tag、fans_region_tag: 粉丝年龄、性别、地域 倾向标签,取值见 square_static_info。
  • fans_stick: 粉丝黏性档位;0=不限,其它值使用静态筛选项。
  • av_active: 是否启用近期投稿活跃筛选;av_active_tag: 活跃档位,取值见 square_static_info.av_active_tag。
  • dmp_group_id: 自定义 DMP 人群包 ID。
  • category_dmp_group_id / category_dmp_label: 内容类目 DMP 人群包 ID 及其展示名称。
  • dmp_pkg_name: 特殊人群包名称关键词。
  • dmp_pkg_vertical_rate_gte / dmp_pkg_vertical_rate_lte: 人群垂直度下限和上限, 垂直度为近 180 天相关视频数占总视频数的比例。
  • dmp_pkg_effect_rate_gte / dmp_pkg_effect_rate_lte: 人群影响力下限和上限, 影响力为近 30 天相关观众占该人群总量的比例。
  • dmp_pkg_fan_rate_gte / dmp_pkg_fan_rate_lte: 人群关注度下限和上限, 关注度为粉丝中该人群的占比。

报价与效果参数:

  • min_task_price / max_task_price: 标准合作报价区间,单位为人民币元。
  • price_info: 按合作形式设置的报价条件数组;当前页面每次搜索提交一个选中的 合作类型。每项包含以下字段:
    • cooperation_type: 视频合作为 1=植入视频、2=定制视频、22=深度定制; 播客合作为 23=专题定制、24=品牌植入;动态合作为 3=直发动态、 4=转发动态。植入类允许在内容中部分植入品牌信息;定制类按客户营销需求 制作内容;深度定制强调更丰富的个性化内容与权益;动态合作分别表示直接发布 商业动态或转发指定动态。
    • price_min / price_max: 该合作类型的人民币报价区间。
    • creative_skill: 仅深度定制使用的创作技能 ID 数组,1-9 分别表示 海外拍摄、硬核技术解析、微电影/短片、真人综艺挑战、改造/DIY、访谈街采、 TVC 拍摄、特色剪辑方法和其他。
    • include_content: 定制视频、深度定制、播客专题定制可用的包含内容 ID 数组, 1=授权二创/分发、2=赠送预告片、3=自定义内容。
    • price_right: 合作权益代码数组。类型 1/2/23/24 可用 show_in_video_first_1p3、show_in_video_gte_30s;类型 22 可用 brand_over_30_percent、auth_secondary_creation、 multi_cooperation_discount、give_preview、give_poster;类型 3/4 不支持该字段并传空数组。
    • 每个 price_info 项固定包含上述 6 个字段。不适用于该合作类型,或用户未选择 的 creative_skill、include_content、price_right,均传空数组 []; “10万以上”传 "price_min":100000,"price_max":""。
    • 深度定制示例: {"price_info":[{"cooperation_type":22,"creative_skill":[1,2,3], "include_content":[1,2,3],"price_min":100000,"price_max":"", "price_right":[]}]}。
    • 植入视频示例: {"price_info":[{"cooperation_type":1,"creative_skill":[], "include_content":[],"price_min":100000,"price_max":"","price_right":[]}]}。
    • 播客专题定制示例: {"price_info":[{"cooperation_type":23,"creative_skill":[], "include_content":[1],"price_min":100000,"price_max":"","price_right":[]}]}。
    • 直发动态示例: {"price_info":[{"cooperation_type":3,"creative_skill":[], "include_content":[],"price_min":100000,"price_max":"","price_right":[]}]}。
    • 先调用 GET /api/v1/bilibili/huahuo/square_static_info,从 data.price_info_options 读取合作类型、报价区间、权益、包含内容和创作技能; cooperation_type[].supported_fields 标明每种合作类型可使用的字段。
  • last_7_days_set_price、last_14_days_set_price、last_30_days_set_price: 对应周期内是否设置过报价;1=是,0=不限。
  • min_interact_rate / max_interact_rate: 互动率区间。互动率为近 180 天 合格原创稿件的点赞、收藏、评论、分享、弹幕和投币总量除以播放量。
  • blue_url_ctr_gte / blue_url_ctr_lt: 蓝链 CTR 下限和上限,即蓝链点击量 除以视频播放量。
  • blue_url_click_cost_gte / blue_url_click_cost_lt: 蓝链点击成本下限和上限, 即合作金额与投流花费之和除以蓝链点击量。
  • min_play_median / max_play_median: 播放量中位数区间;统计近 180 天内 发布满 7 天的合格原创稿件。
  • play_median_traffic_type: 播放口径,1=全部流量、2=自然流量; play_median_cycle: 1=7天、2=15天、3=30天。 “30万-50万、15天、自然流量”示例为 {"min_play_median":"300000","max_play_median":"500000", "play_median_traffic_type":2,"play_median_cycle":2}。
  • min_cpm / max_cpm: CPM 区间,即花费除以播放量再乘 1000; cpm_type: 1=全部流量、2=自然流量;cpm_cycle: 1/2/3=7/15/30天。
  • min_cpc / max_cpc: CPC 区间,即花费除以组件点击次数; cpc_traffic_type: 1=全部流量、2=自然流量;cpc_cycle: 1/2/3=7/15/30天。
  • cpe_gte / cpe_lt: CPE 下限和上限,即花费除以有效互动次数; cpe_traffic_type: 1=全部流量、2=自然流量;cpe_cycle: 1=7天、3=30天。

内容表现与合作经验参数:

  • draft_duration: 主流视频时长,1=0-30秒、2=30-60秒、3=1-3分钟、 4=3-5分钟、5=5-10分钟、6=10分钟以上。
  • min_avid_cnt / max_avid_cnt: 近 90 天有效原创稿件数区间。
  • min_hot_avid_rate / max_hot_avid_rate: 近 90 天爆款稿件占比区间。
  • half_min_hot_avid_cnt / half_max_hot_avid_cnt: 近半年爆款稿件数区间。
  • entry_cost_min / entry_cost_max: 近一年相关合作的进店成本区间。
  • av_honor: 稿件荣誉条件对象。honor_type 是可多选数组:HOT(热门)、 MZBK(每周必看)、QZPHB(全站排行榜);time_period 可选 0/30/90/180 天;honor_count 为 0=不限、1=1次、2=2次、 3=3次及以上。多选示例: {"av_honor":{"honor_type":["HOT","QZPHB"],"time_period":90, "honor_count":2}}。
  • 通用面板的“合作次数”使用 spark_tag,可选 cooperate=有合作经验、 coo_frequent=合作经验丰富;二选一。合作行业来自 square_static_info.industry_tree,按所选路径分别把一、二、三级 ID 传入 huahuo_first_industry_ids、huahuo_second_industry_ids、 huahuo_third_industry_ids。选择“房地产/全部且有合作经验”时可传: {"spark_tag":["cooperate"],"huahuo_first_industry_ids":["388"], "huahuo_second_industry_ids":["389","393","399","401","403"], "huahuo_third_industry_ids":["390","394","395","396","398", "400","402","404"]}。多行业选择时,将各选中路径的 ID 合并到对应层级数组。
  • 非通用行业策略面板使用 cooperate_experience_industry_ids 和 cooperate_experience_type。未选行业时,类型可选 3=无当前行业合作经验、 1=有当前行业合作经验、2=当前行业合作经验丰富、4=有其他行业合作经验; 选中行业后仅使用 1 或 2;行业值由 cooperate_experience_industry 返回。

标签与行业参数:

  • special_tags: 特色标签,取值见 square_static_info。
  • spark_tag: 花火能力标签,例如 cooperate、grow、hot_frequent。
  • square_tag_in: 广场场景标签,例如 ad_partner_experienced。
  • label_array: 仅承载 upper_label_tree“内容类型”分组中选中节点的 value。 所有已选内容类型放在同一个内层数组;不传父级路径。单选“户外探险”: {"label_array":[[794]]};多选“户外探险、AI短片、AI整活”: {"label_array":[[794,747,748]]}。
  • bdata_tag_lv5: B站五级内容标签筛选值列表。
  • huahuo_first_industry_ids、huahuo_second_industry_ids、 huahuo_third_industry_ids: 花火一、二、三级行业 ID 列表,取值见 square_static_info.industry_tree。

带货能力参数:

  • goods_permission: 1=仅筛选有带货权限的 UP 主,0=不限。
  • goods_up_levels: 带货 UP 主等级列表。
  • goods_category_first_ids / goods_category_second_ids: 带货一、二级类目 ID 列表。
  • goods_gpm_min / goods_gpm_max: 近 30 天 GPM 区间,即每千次带货视频播放 产生的支付 GMV。
  • goods_ctr_min / goods_ctr_max: 带货组件点击率区间,即组件点击量除以曝光量; goods_ctr_type: 1=全部组件、2=评论区组件。
  • goods_avg_price_min / goods_avg_price_max: 近 30 天商品平均价格区间,单位为元。
  • goods_is_high_video_play_permeate: 是否要求视频播放渗透率处于高位; goods_is_high_fans_play_permeate: 是否要求粉丝播放渗透率处于高位。

状态与高潜参数:

  • is_boosting: 1=仅筛选内容加热中的 UP 主,0=不限。
  • is_treasure_up: 是否筛选宝藏 UP 主;is_timely_response: 是否要求及时响应。
  • is_new_enter: 是否筛选新入驻 UP 主;custom_video_pricing_set: 是否已设置 定制视频报价。
  • is_x_plan_better_up: 是否筛选 X 计划优选 UP 主。
  • high_potential_type: 高潜类型,0=全部、1=已入驻、2=未入驻。

筛选值来源:

  • 内容类型:先调用 GET /api/v1/bilibili/huahuo/upper_label_tree?panel_type=0, 从“内容类型”分组读取节点 value,再组装 label_array。
  • 常驻地域:先调用 GET /api/v1/bilibili/huahuo/region_drop;一级 value 填入 region_id,选中一级节点的子级 value 填入 second_region_id。
  • 通用面板合作行业:先调用 GET /api/v1/bilibili/huahuo/square_static_info, 从 data.industry_tree 读取三级行业路径,分别填入三个 huahuo_*_industry_ids。 合作次数同时用 spark_tag:cooperate 或 coo_frequent。
  • 非通用行业面板合作经验:先调用 GET /api/v1/bilibili/huahuo/cooperate_experience_industry?industry_type=<TYPE>, 将选中 ID 填入 cooperate_experience_industry_ids,并设置 cooperate_experience_type。
  • 合作报价:调用 GET /api/v1/bilibili/huahuo/square_static_info,读取 data.price_info_options 并组装 price_info。播放量中位数和稿件荣誉使用 本接口文档中的固定枚举、字段规则和 Request Payload Example。
  • 其它动态取值接口:粉丝画像、性别、活跃档位和特色标签调用 GET /api/v1/bilibili/huahuo/square_static_info;一、二级稿件分区调用 GET /api/v1/bilibili/huahuo/partition_drop;MCN 调用 GET /api/v1/bilibili/huahuo/mcn_drop?name=;DMP 自定义人群包调用 GET /api/v1/bilibili/huahuo/dmp_pkg_list;带货一、二级类目调用 GET /api/v1/bilibili/huahuo/effect_goods_drop。

返回:

  • page: 当前页码。
  • total_count: 匹配结果总数,最大显示为 10000。
  • data: UP 主列表。常见字段包括 upper_mid、nickname、fans_num、 play_median、interactive_rate、合作报价、内容与行业标签、DMP 指标及带货指标; 内容搜索还会返回匹配稿件。

计费:

  • 0.01 USD / 次。

[English]

Purpose:

  • Search creators by nickname, UID, or content keyword in the Huahuo marketplace.
  • Combine profile, audience, pricing, performance, DMP, industry, cooperation-experience, and commerce filters.
  • nickname_or_mids and main_search correspond to creator search and content search respectively; normally choose one per request.

Parameters:

Basic search parameters:

  • nickname_or_mids: Creator nickname or UID query; separate multiple terms with commas.
  • main_search: Content-keyword query with matched videos included in the result. Normally use either this field or nickname_or_mids.
  • mids: Exact UID list; upper_mid: One exact UID; folder_id: Saved-creator folder ID.
  • marketing_target: 1=brand awareness, 2=consideration, 3=conversion.
  • panel_type: 0=general, 1=gaming, 2=beauty, 3=digital, 4=automotive, 5=performance, 6=food, 8=internet services.
  • order_by: Sort field; sort: desc or asc; page: One-based page number with 20 results per page; request_id: Optional search-session ID that can be reused across pages with the same filters.

Creator profile and affiliation parameters:

  • gender: Value from square_static_info.gender_info.
  • min_fans_num / max_fans_num: Inclusive follower-count range.
  • region_id / second_region_id: Primary and secondary residence-region IDs from region_drop. The Beijing, Shanghai, Fujian, Xiamen, and Fuzhou selection is {"region_id":[4,5,23],"second_region_id":[51,50]}.
  • partition_id / second_partition_id: Primary and secondary content-category IDs.
  • mcn_ids: MCN IDs; provider_id: Service-provider IDs.
  • upper_types: 1 or 4=MCN-affiliated, 3=independent.
  • only_contract: 1=contract-eligible creators only, 0=all.
  • is_painter_order: Require illustration-commission capability.

Audience and DMP parameters:

  • fans_age_tag, fans_gender_tag, fans_region_tag: Audience age, gender, and region affinity tags; fans_stick: Follower-loyalty tier.
  • av_active: Enable recent-publishing filtering; av_active_tag: Activity tier.
  • dmp_group_id: Custom DMP package ID; category_dmp_group_id and category_dmp_label: Category-package ID and display label.
  • dmp_pkg_name: Special-audience package name query.
  • dmp_pkg_vertical_rate_gte / dmp_pkg_vertical_rate_lte: DMP verticality range, measured as matching videos divided by all videos in the last 180 days.
  • dmp_pkg_effect_rate_gte / dmp_pkg_effect_rate_lte: DMP influence range, measured as recent matching viewers divided by that audience population.
  • dmp_pkg_fan_rate_gte / dmp_pkg_fan_rate_lte: DMP attention range, measured as matching audience members divided by all followers.

Pricing and performance parameters:

  • min_task_price / max_task_price: Standard cooperation quote range in RMB.
  • price_info: Cooperation-specific pricing array; the current UI submits one selected cooperation type per search. Each item contains:
    • cooperation_type: Video cooperation uses 1=embedded video, 2=custom video, and 22=deep customization; podcast cooperation uses 23=custom podcast and 24=podcast brand placement; dynamic cooperation uses 3=direct post and 4=repost. Placement formats embed brand material in the content, custom formats are produced for the client's marketing needs, and dynamic formats publish or repost the requested commercial post.
    • price_min / price_max: Quote range in RMB for that cooperation type.
    • creative_skill: Deep-customization skill IDs 1-9, covering overseas filming, technical analysis, microfilm, live-action challenge, renovation/DIY, interview, TVC filming, special editing, and other.
    • include_content: Included-content IDs for custom video, deep customization, or custom podcast: 1=secondary creation/distribution license, 2=bonus preview, 3=custom content.
    • price_right: Cooperation-right codes. Types 1/2/23/24 support show_in_video_first_1p3 and show_in_video_gte_30s; type 22 supports brand_over_30_percent, auth_secondary_creation, multi_cooperation_discount, give_preview, and give_poster. Types 3/4 do not support this field and use [].
    • Every price_info item contains all six fields. Send [] for an unavailable or unselected creative_skill, include_content, or price_right. “RMB 100,000 or more” is "price_min":100000,"price_max":"".
    • Deep-custom example: {"price_info":[{"cooperation_type":22,"creative_skill":[1,2,3], "include_content":[1,2,3],"price_min":100000,"price_max":"", "price_right":[]}]}.
    • Embedded-video example: {"price_info":[{"cooperation_type":1,"creative_skill":[], "include_content":[],"price_min":100000,"price_max":"","price_right":[]}]}.
    • Custom-podcast example: {"price_info":[{"cooperation_type":23,"creative_skill":[], "include_content":[1],"price_min":100000,"price_max":"","price_right":[]}]}.
    • Direct-post example: {"price_info":[{"cooperation_type":3,"creative_skill":[], "include_content":[],"price_min":100000,"price_max":"","price_right":[]}]}.
    • Call GET /api/v1/bilibili/huahuo/square_static_info first and read data.price_info_options for cooperation types, price ranges, rights, included content, and creative skills. Each item in cooperation_type declares its usable request fields in supported_fields.
  • last_7_days_set_price, last_14_days_set_price, last_30_days_set_price: 1 requires a quote set in the selected period; 0 means unrestricted.
  • min_interact_rate / max_interact_rate: Engagement-rate range for eligible original videos in the last 180 days.
  • blue_url_ctr_gte / blue_url_ctr_lt: Blue-link CTR range; blue_url_click_cost_gte / blue_url_click_cost_lt: Blue-link click-cost range.
  • min_play_median / max_play_median: Median-view range for eligible original videos published at least seven days ago.
  • play_median_traffic_type: 1=all, 2=organic; play_median_cycle: 1/2/3=7/15/30 days. Example for “300,000-500,000, 15 days, organic”: {"min_play_median":"300000","max_play_median":"500000", "play_median_traffic_type":2,"play_median_cycle":2}.
  • min_cpm / max_cpm: CPM range; cpm_type: 1=all, 2=organic; cpm_cycle: 1/2/3=7/15/30 days.
  • min_cpc / max_cpc: CPC range; cpc_traffic_type: 1=all, 2=organic; cpc_cycle: 1/2/3=7/15/30 days.
  • cpe_gte / cpe_lt: CPE range; cpe_traffic_type: 1=all, 2=organic; cpe_cycle: 1=7 days, 3=30 days.

Content and cooperation parameters:

  • draft_duration: Dominant video duration: 1=0-30s, 2=30-60s, 3=1-3m, 4=3-5m, 5=5-10m, 6=over 10m.
  • min_avid_cnt / max_avid_cnt: Eligible original-video count range over 90 days.
  • min_hot_avid_rate / max_hot_avid_rate: Viral-video ratio range over 90 days.
  • half_min_hot_avid_cnt / half_max_hot_avid_cnt: Viral-video count range over six months.
  • entry_cost_min / entry_cost_max: Store-entry cost range over the last year.
  • av_honor: Honor filter containing a multi-select honor_type array (HOT, MZBK, and/or QZPHB), time_period (0/30/90/180 days), and honor_count (0/1/2/3, where 3 means 3+). Multi-select example: {"av_honor":{"honor_type":["HOT","QZPHB"],"time_period":90, "honor_count":2}}.
  • The general panel's cooperation-count filter uses spark_tag: cooperate=experienced or coo_frequent=extensive experience; choose one. Cooperation industries come from square_static_info.industry_tree; send selected paths in huahuo_first_industry_ids, huahuo_second_industry_ids, and huahuo_third_industry_ids. For “real estate/all with experience”: {"spark_tag":["cooperate"],"huahuo_first_industry_ids":["388"], "huahuo_second_industry_ids":["389","393","399","401","403"], "huahuo_third_industry_ids":["390","394","395","396","398", "400","402","404"]}. Merge IDs from all selected paths for a multi-industry request.
  • Non-general strategy panels use cooperate_experience_industry_ids with cooperate_experience_type. Without selected industries, the type options are 3=no current-industry experience, 1=experienced, 2=extensive experience, and 4=experience in other industries. With selected industries, use 1 or 2. cooperate_experience_industry supplies those strategy-panel industry values.

Labels and industry parameters:

  • special_tags: Feature tags; spark_tag: Capability tags such as cooperate, grow, and hot_frequent; square_tag_in: Marketplace scenario tags.
  • label_array: Contains only selected node values from the “Content type” group returned by upper_label_tree. Put all selected content types in one inner array without parent-path values. Single “Outdoor adventure” selection: {"label_array":[[794]]}; multiple “Outdoor adventure, AI short film, AI entertainment” selections: {"label_array":[[794,747,748]]}.
  • bdata_tag_lv5: Bilibili level-five content-tag values.
  • huahuo_first_industry_ids, huahuo_second_industry_ids, huahuo_third_industry_ids: Primary, secondary, and tertiary Huahuo industry IDs.

Commerce parameters:

  • goods_permission: 1=require commerce permission, 0=all; goods_up_levels: Commerce-creator levels.
  • goods_category_first_ids / goods_category_second_ids: Commerce-category IDs.
  • goods_gpm_min / goods_gpm_max: 30-day paid GMV per 1,000 commerce-video views.
  • goods_ctr_min / goods_ctr_max: Component CTR range; goods_ctr_type: 1=all components, 2=comment component.
  • goods_avg_price_min / goods_avg_price_max: 30-day average product-price range in RMB.
  • goods_is_high_video_play_permeate: Require high video-view penetration; goods_is_high_fans_play_permeate: Require high follower-view penetration.

Status and high-potential parameters:

  • is_boosting: Require currently boosted creators; is_treasure_up: Treasure creators; is_timely_response: Timely-response creators; is_new_enter: Newly onboarded creators.
  • custom_video_pricing_set: Require configured custom-video pricing; is_x_plan_better_up: X Plan preferred creators.
  • high_potential_type: 0=all, 1=onboarded, 2=not onboarded.

Filter value sources:

  • Content types: call GET /api/v1/bilibili/huahuo/upper_label_tree?panel_type=0, read node values from the Content type group, and build label_array.
  • Residence regions: call GET /api/v1/bilibili/huahuo/region_drop; use primary values in region_id and selected child values in second_region_id.
  • General-panel cooperation industries: call GET /api/v1/bilibili/huahuo/square_static_info, read the three-level data.industry_tree, and fill the matching huahuo_*_industry_ids arrays. Use spark_tag with cooperate or coo_frequent for cooperation count.
  • Non-general-panel cooperation experience: call GET /api/v1/bilibili/huahuo/cooperate_experience_industry?industry_type=<TYPE>, then set cooperate_experience_industry_ids and cooperate_experience_type.
  • Cooperation pricing: call GET /api/v1/bilibili/huahuo/square_static_info, read data.price_info_options, and build price_info. Median views and video honors use the fixed enums and Request Payload Examples documented here.
  • Other dynamic sources: call GET /api/v1/bilibili/huahuo/square_static_info for audience, gender, activity, and feature tags; GET /api/v1/bilibili/huahuo/partition_drop for first- and second-level video categories; GET /api/v1/bilibili/huahuo/mcn_drop?name= for MCNs; GET /api/v1/bilibili/huahuo/dmp_pkg_list for custom DMP packages; and GET /api/v1/bilibili/huahuo/effect_goods_drop for commerce categories.

Returns:

  • page: Current page number.
  • total_count: Total matching records, displayed up to 10,000.
  • data: Creator records commonly containing upper_mid, nickname, fans_num, play_median, interactive_rate, pricing, content and industry labels, DMP measurements, and commerce metrics. Content-search results also include matched videos.

Billing:

  • 0.01 USD per request.

[示例/Example]

{
  "main_search": "智能手机",
  "marketing_target": 1,
  "panel_type": 3,
  "min_fans_num": 100000,
  "max_fans_num": 1000000,
  "min_play_median": 50000,
  "play_median_traffic_type": 1,
  "play_median_cycle": 3,
  "goods_ctr_type": 1,
  "order_by": "play_median",
  "sort": "desc",
  "page": 1
}
post/api/v1/bilibili/huahuo/search_upper

Request

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

Request body

nickname_or_midsstring nullable

按 UP 主昵称或 UID 搜索,多个关键词用英文逗号分隔 / Creator nickname or UID query; separate multiple terms with commas

main_searchstring nullable

按内容关键词搜索,命中稿件会随结果返回 / Content-keyword query; matched videos are included in the result

marketing_targetinteger nullable

营销目标:1=品牌曝光,2=心智种草,3=效果转化 / Marketing objective: 1=brand awareness, 2=consideration, 3=conversion

panel_typeinteger nullable

行业策略面板:0=通用,1=游戏,2=美妆,3=数码,4=汽车,5=效果,6=食饮,8=网服 / Strategy panel: 0=general, 1=gaming, 2=beauty, 3=digital, 4=automotive, 5=performance, 6=food, 8=internet

order_bystring nullable

排序字段,例如 fans_num、play_median、interactive_rate / Sort field, such as fans_num, play_median, or interactive_rate

sortstring nullable

排序方向:desc=降序,asc=升序 / Sort direction: desc=descending, asc=ascending

pageinteger nullable

页码,从 1 开始,每页返回 20 条 / One-based page number; each page returns 20 records

request_idstring nullable

搜索会话标识;同组条件翻页时复用,留空则生成新值 / Search-session ID; reuse it across pages of the same filter set

genderstring nullable

UP 主性别,取值见 /api/v1/bilibili/huahuo/square_static_info 返回的 gender_info / Creator gender from gender_info returned by /api/v1/bilibili/huahuo/square_static_info

only_contractinteger nullable

仅看可签约账号:1=是,0=不限 / Contract-eligible filter: 1=only eligible creators, 0=all

is_painter_orderboolean nullable

是否筛选画师约稿能力 / Whether to require illustration-commission capability

fans_age_tagstring[] nullable

粉丝年龄倾向标签,取值见 /api/v1/bilibili/huahuo/square_static_info / Audience age-affinity tags from /api/v1/bilibili/huahuo/square_static_info

fans_gender_tagstring[] nullable

粉丝性别倾向标签,取值见 /api/v1/bilibili/huahuo/square_static_info / Audience gender-affinity tags from /api/v1/bilibili/huahuo/square_static_info

fans_region_tagstring[] nullable

粉丝地域倾向标签,取值见 /api/v1/bilibili/huahuo/square_static_info / Audience region-affinity tags from /api/v1/bilibili/huahuo/square_static_info

fans_stickinteger nullable

粉丝黏性筛选值,0=不限,其他值取自静态筛选项 / Follower-loyalty filter; 0=all, otherwise use a static-option value

av_activeinteger nullable

近期投稿活跃开关:1=启用,0=不限 / Recent-publishing activity switch: 1=enabled, 0=all

av_active_tagstring nullable

近期投稿活跃档位,取值见 /api/v1/bilibili/huahuo/square_static_info 返回的 av_active_tag / Recent-publishing activity tier from av_active_tag returned by /api/v1/bilibili/huahuo/square_static_info

category_dmp_labelstring nullable

内容类目 DMP 人群包展示名称 / Display label for the content-category DMP audience package

dmp_pkg_namestring nullable

DMP 特殊人群包名称关键词 / DMP special-audience package name query

last_7_days_set_priceinteger nullable

近7天是否设置过报价:1=是,0=不限 / Quote-updated-in-7-days filter: 1=yes, 0=all

last_14_days_set_priceinteger nullable

近14天是否设置过报价:1=是,0=不限 / Quote-updated-in-14-days filter: 1=yes, 0=all

last_30_days_set_priceinteger nullable

近30天是否设置过报价:1=是,0=不限 / Quote-updated-in-30-days filter: 1=yes, 0=all

play_median_traffic_typeinteger nullable

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

play_median_cycleinteger nullable

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

cpm_typeinteger nullable

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

cpm_cycleinteger nullable

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

cpc_traffic_typeinteger nullable

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

cpc_cycleinteger nullable

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

cpe_traffic_typeinteger nullable

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

cpe_cycleinteger nullable

CPE 统计周期:1=7天,3=30天 / CPE window: 1=7 days, 3=30 days

special_tagsstring[] nullable

特色标签列表,取值见 /api/v1/bilibili/huahuo/square_static_info / Feature-tag values from /api/v1/bilibili/huahuo/square_static_info

spark_tagstring[] nullable

花火能力标签;通用面板合作次数使用 cooperate=有合作经验或 coo_frequent=合作经验丰富,并与 /api/v1/bilibili/huahuo/square_static_info 返回的行业树字段配合使用 / Huahuo capability tags; general-panel cooperation count uses cooperate or coo_frequent together with industry-tree values from /api/v1/bilibili/huahuo/square_static_info

square_tag_instring[] nullable

广场场景标签,例如 ad_partner_experienced / Marketplace scenario tags such as ad_partner_experienced

goods_permissioninteger nullable

带货权限筛选:1=有权限,0=不限 / Commerce permission filter: 1=required, 0=all

goods_ctr_typeinteger nullable

带货点击率组件口径:1=全部组件,2=评论区组件 / Commerce CTR component scope: 1=all components, 2=comment component

is_boostinginteger nullable

是否筛选内容加热中的 UP 主:1=是,0=不限 / Boosting-status filter: 1=currently boosting, 0=all

high_potential_typeinteger nullable

高潜类型:0=全部,1=已入驻,2=未入驻 / High-potential type: 0=all, 1=onboarded, 2=not onboarded

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

    • breaking

      request property // list-of-types was narrowed by removing types string from media type application/json

    • breaking

      the /// request property type changed from string to array

    • breaking

      the // request property type changed from no type to array

    • info

      added subschema #1 subschema #2 to the /// request property anyOf list

    • info

      added subschema #1 subschema #2 to the /// request property anyOf list

    • info

      added subschema #1 subschema #2 to the /// request property anyOf list