# Search Bilibili Huahuo creators or content

Search creators by nickname, UID, or content keyword in the Huahuo marketplace. Takes nickname or mids, main search, mids and more, all optional. Served by TikHub.

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

- Tool ID: `tikhub/bilibili-huahuo-search-upper`
- Name in the catalog: Bilibili, Search Huahuo creators or content
- Provider: [TikHub](/providers/tikhub.md)
- Capability: [Bilibili search](/tools/bilibili/search.md)
- Price: $0.01 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.01
}
```

Pricing source: [https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info). Official per-success route price USD 0.01; daily upstream discounts may reduce provider cost. No discount invented for the customer. 10/second.

Price verification date: 2026-10-05.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "nickname_or_mids": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Nickname Or Mids",
      "description": "按 UP 主昵称或 UID 搜索，多个关键词用英文逗号分隔 / Creator nickname or UID query; separate multiple terms with commas"
    },
    "main_search": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Main Search",
      "description": "按内容关键词搜索，命中稿件会随结果返回 / Content-keyword query; matched videos are included in the result"
    },
    "mids": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Mids",
      "description": "批量精确匹配的 UP 主 UID 列表 / List of creator UIDs to match exactly"
    },
    "upper_mid": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Upper Mid",
      "description": "单个 UP 主 UID 精确筛选 / Single creator UID for an exact match"
    },
    "folder_id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Folder Id",
      "description": "已保存 UP 主文件夹 ID，用于限定文件夹内搜索 / Saved-creator folder ID used to limit the search"
    },
    "marketing_target": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Marketing Target",
      "description": "营销目标：1=品牌曝光，2=心智种草，3=效果转化 / Marketing objective: 1=brand awareness, 2=consideration, 3=conversion"
    },
    "panel_type": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Panel Type",
      "description": "行业策略面板：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_by": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Order By",
      "description": "排序字段，例如 fans_num、play_median、interactive_rate / Sort field, such as fans_num, play_median, or interactive_rate"
    },
    "sort": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sort",
      "description": "排序方向：desc=降序，asc=升序 / Sort direction: desc=descending, asc=ascending"
    },
    "page": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "title": "Page",
      "description": "页码，从 1 开始，每页返回 20 条 / One-based page number; each page returns 20 records"
    },
    "request_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Request Id",
      "description": "搜索会话标识；同组条件翻页时复用，留空则生成新值 / Search-session ID; reuse it across pages of the same filter set"
    },
    "gender": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Gender",
      "description": "UP 主性别，取值见 /api/v1/bilibili/huahuo/square_static_info 返回的 gender_info / Creator gender from gender_info returned by /api/v1/bilibili/huahuo/square_static_info"
    },
    "min_fans_num": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Fans Num",
      "description": "粉丝数下限（含）/ Minimum follower count, inclusive"
    },
    "max_fans_num": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Fans Num",
      "description": "粉丝数上限（含）/ Maximum follower count, inclusive"
    },
    "region_id": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Region Id",
      "description": "先调用 /api/v1/bilibili/huahuo/region_drop；把选中一级地域的 value 放入此数组 / Call /api/v1/bilibili/huahuo/region_drop first, then put selected primary-region values in this array"
    },
    "second_region_id": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Second Region Id",
      "description": "先调用 /api/v1/bilibili/huahuo/region_drop；把选中一级地域 children 中的二级 value 放入此数组 / Call /api/v1/bilibili/huahuo/region_drop first, then put selected child-region values in this array"
    },
    "partition_id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Partition Id",
      "description": "内容一级分区 ID，取值见 /api/v1/bilibili/huahuo/partition_drop / Primary content-category ID from /api/v1/bilibili/huahuo/partition_drop"
    },
    "second_partition_id": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Second Partition Id",
      "description": "内容二级分区 ID 列表，取值见 /api/v1/bilibili/huahuo/partition_drop / Secondary content-category IDs from /api/v1/bilibili/huahuo/partition_drop"
    },
    "mcn_ids": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Mcn Ids",
      "description": "MCN 机构 ID 列表，取值见 /api/v1/bilibili/huahuo/mcn_drop / MCN organization IDs from /api/v1/bilibili/huahuo/mcn_drop"
    },
    "provider_id": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Provider Id",
      "description": "服务商 ID 列表，使用花火筛选项的可选值 / Service-provider IDs using values offered by the Huahuo filter"
    },
    "upper_types": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Upper Types",
      "description": "账号类型：1或4=机构签约，3=个人 / Creator type: 1 or 4=MCN-affiliated, 3=independent"
    },
    "only_contract": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Only Contract",
      "description": "仅看可签约账号：1=是，0=不限 / Contract-eligible filter: 1=only eligible creators, 0=all"
    },
    "is_painter_order": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Painter Order",
      "description": "是否筛选画师约稿能力 / Whether to require illustration-commission capability"
    },
    "fans_age_tag": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fans Age Tag",
      "description": "粉丝年龄倾向标签，取值见 /api/v1/bilibili/huahuo/square_static_info / Audience age-affinity tags from /api/v1/bilibili/huahuo/square_static_info"
    },
    "fans_gender_tag": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fans Gender Tag",
      "description": "粉丝性别倾向标签，取值见 /api/v1/bilibili/huahuo/square_static_info / Audience gender-affinity tags from /api/v1/bilibili/huahuo/square_static_info"
    },
    "fans_region_tag": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fans Region Tag",
      "description": "粉丝地域倾向标签，取值见 /api/v1/bilibili/huahuo/square_static_info / Audience region-affinity tags from /api/v1/bilibili/huahuo/square_static_info"
    },
    "fans_stick": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Fans Stick",
      "description": "粉丝黏性筛选值，0=不限，其他值取自静态筛选项 / Follower-loyalty filter; 0=all, otherwise use a static-option value"
    },
    "av_active": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Av Active",
      "description": "近期投稿活跃开关：1=启用，0=不限 / Recent-publishing activity switch: 1=enabled, 0=all"
    },
    "av_active_tag": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Av Active Tag",
      "description": "近期投稿活跃档位，取值见 /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"
    },
    "dmp_group_id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Dmp Group Id",
      "description": "DMP 自定义人群包 ID，取值见 /api/v1/bilibili/huahuo/dmp_pkg_list / DMP custom audience-package ID from /api/v1/bilibili/huahuo/dmp_pkg_list"
    },
    "category_dmp_group_id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Category Dmp Group Id",
      "description": "内容类目 DMP 人群包 ID / Content-category DMP audience-package ID"
    },
    "category_dmp_label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Category Dmp Label",
      "description": "内容类目 DMP 人群包展示名称 / Display label for the content-category DMP audience package"
    },
    "dmp_pkg_name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Dmp Pkg Name",
      "description": "DMP 特殊人群包名称关键词 / DMP special-audience package name query"
    },
    "dmp_pkg_vertical_rate_gte": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Dmp Pkg Vertical Rate Gte",
      "description": "DMP 人群垂直度下限：相关视频数占总视频数比例 / Minimum DMP verticality: matching videos divided by all videos"
    },
    "dmp_pkg_vertical_rate_lte": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Dmp Pkg Vertical Rate Lte",
      "description": "DMP 人群垂直度上限：相关视频数占总视频数比例 / Maximum DMP verticality: matching videos divided by all videos"
    },
    "dmp_pkg_effect_rate_gte": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Dmp Pkg Effect Rate Gte",
      "description": "DMP 人群影响力下限：近30天相关观众占该人群总量比例 / Minimum DMP influence: recent matching viewers divided by the audience population"
    },
    "dmp_pkg_effect_rate_lte": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Dmp Pkg Effect Rate Lte",
      "description": "DMP 人群影响力上限：近30天相关观众占该人群总量比例 / Maximum DMP influence: recent matching viewers divided by the audience population"
    },
    "dmp_pkg_fan_rate_gte": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Dmp Pkg Fan Rate Gte",
      "description": "DMP 人群关注度下限：粉丝中该人群占比 / Minimum DMP attention: matching audience members divided by all followers"
    },
    "dmp_pkg_fan_rate_lte": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Dmp Pkg Fan Rate Lte",
      "description": "DMP 人群关注度上限：粉丝中该人群占比 / Maximum DMP attention: matching audience members divided by all followers"
    },
    "min_task_price": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Task Price",
      "description": "标准合作报价下限，单位为人民币元 / Minimum standard cooperation quote in RMB"
    },
    "max_task_price": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Task Price",
      "description": "标准合作报价上限，单位为人民币元 / Maximum standard cooperation quote in RMB"
    },
    "price_info": {
      "anyOf": [
        {
          "items": {
            "properties": {
              "cooperation_type": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Cooperation Type",
                "description": "合作类型：1=植入视频，2=定制视频，22=深度定制，23=播客专题定制，24=播客品牌植入，3=直发动态，4=转发动态；各类型支持的字段见 /api/v1/bilibili/huahuo/square_static_info 返回的 price_info_options.cooperation_type / Cooperation type: 1=embedded video, 2=custom video, 22=deep customization, 23=custom podcast, 24=podcast brand placement, 3=direct post, 4=repost; supported fields are returned in price_info_options.cooperation_type"
              },
              "creative_skill": {
                "anyOf": [
                  {
                    "items": {
                      "type": "integer"
                    },
                    "type": "array"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Creative Skill",
                "description": "深度定制的创作技能 ID：1=海外拍摄，2=硬核技术解析，3=微电影或短片，4=真人综艺挑战，5=改造或DIY，6=访谈街采，7=TVC拍摄，8=特色剪辑方法，9=其他；取值见 /api/v1/bilibili/huahuo/square_static_info 返回的 price_info_options.creative_skill / Deep-customization skill IDs 1-9; options are returned in price_info_options.creative_skill"
              },
              "include_content": {
                "anyOf": [
                  {
                    "items": {
                      "type": "integer"
                    },
                    "type": "array"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Include Content",
                "description": "定制视频、深度定制或播客专题定制的包含内容 ID：1=授权二创或分发，2=赠送预告片，3=自定义内容；取值见 /api/v1/bilibili/huahuo/square_static_info 返回的 price_info_options.include_content / Included-content IDs 1-3; options are returned in price_info_options.include_content"
              },
              "price_min": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "number"
                  },
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Price Min",
                "description": "该合作形式的报价下限，单位为人民币元；预设区间见 /api/v1/bilibili/huahuo/square_static_info 返回的 price_info_options.price_range / Minimum quote in RMB; presets are returned in price_info_options.price_range by /api/v1/bilibili/huahuo/square_static_info"
              },
              "price_max": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "number"
                  },
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Price Max",
                "description": "该合作形式的报价上限，单位为人民币元；预设区间见 /api/v1/bilibili/huahuo/square_static_info 返回的 price_info_options.price_range / Maximum quote in RMB; presets are returned in price_info_options.price_range by /api/v1/bilibili/huahuo/square_static_info"
              },
              "price_right": {
                "anyOf": [
                  {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Price Right",
                "description": "合作权益代码数组，例如 show_in_video_first_1p3、show_in_video_gte_30s、brand_over_30_percent、auth_secondary_creation、multi_cooperation_discount、give_preview、give_poster；完整取值及适用类型见 /api/v1/bilibili/huahuo/square_static_info 返回的 price_info_options.price_right，未选择或不适用时传 [] / Cooperation-right codes and applicable types from price_info_options.price_right returned by /api/v1/bilibili/huahuo/square_static_info; send [] when unselected or unavailable"
              }
            },
            "additionalProperties": true,
            "type": "object",
            "title": "UpperPriceFilter",
            "description": "按合作形式设置的报价筛选 / Quote filter for a cooperation format."
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Price Info",
      "description": "合作报价筛选数组；先调用 /api/v1/bilibili/huahuo/square_static_info 并读取 price_info_options，每次搜索传一个合作类型，每项固定包含六个字段，不适用或未选择的数组传 [] / Cooperation-pricing filters from price_info_options returned by /api/v1/bilibili/huahuo/square_static_info; send one type per search, include all six fields, and use [] for unavailable arrays"
    },
    "last_7_days_set_price": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Last 7 Days Set Price",
      "description": "近7天是否设置过报价：1=是，0=不限 / Quote-updated-in-7-days filter: 1=yes, 0=all"
    },
    "last_14_days_set_price": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Last 14 Days Set Price",
      "description": "近14天是否设置过报价：1=是，0=不限 / Quote-updated-in-14-days filter: 1=yes, 0=all"
    },
    "last_30_days_set_price": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Last 30 Days Set Price",
      "description": "近30天是否设置过报价：1=是，0=不限 / Quote-updated-in-30-days filter: 1=yes, 0=all"
    },
    "min_interact_rate": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Interact Rate",
      "description": "互动率下限；近180天合格原创稿件互动量除以播放量 / Minimum engagement rate for eligible original videos in the last 180 days"
    },
    "max_interact_rate": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Interact Rate",
      "description": "互动率上限；近180天合格原创稿件互动量除以播放量 / Maximum engagement rate for eligible original videos in the last 180 days"
    },
    "blue_url_ctr_gte": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Blue Url Ctr Gte",
      "description": "蓝链点击率下限，即蓝链点击量除以视频播放量 / Minimum blue-link CTR, blue-link clicks divided by video views"
    },
    "blue_url_ctr_lt": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Blue Url Ctr Lt",
      "description": "蓝链点击率上限，即蓝链点击量除以视频播放量 / Maximum blue-link CTR, blue-link clicks divided by video views"
    },
    "blue_url_click_cost_gte": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Blue Url Click Cost Gte",
      "description": "蓝链点击成本下限，即合作及投流花费除以蓝链点击量 / Minimum blue-link click cost, cooperation and promotion spend divided by clicks"
    },
    "blue_url_click_cost_lt": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Blue Url Click Cost Lt",
      "description": "蓝链点击成本上限，即合作及投流花费除以蓝链点击量 / Maximum blue-link click cost, cooperation and promotion spend divided by clicks"
    },
    "min_play_median": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Play Median",
      "description": "播放量中位数下限；统计近180天且发布满7天的合格原创稿件 / Minimum median views for eligible original videos published at least seven days ago"
    },
    "max_play_median": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Play Median",
      "description": "播放量中位数上限；统计近180天且发布满7天的合格原创稿件 / Maximum median views for eligible original videos published at least seven days ago"
    },
    "play_median_traffic_type": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Play Median Traffic Type",
      "description": "播放中位数流量口径：1=全部流量，2=自然流量 / Median-view traffic scope: 1=all traffic, 2=organic traffic"
    },
    "play_median_cycle": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Play Median Cycle",
      "description": "播放中位数统计周期：1=7天，2=15天，3=30天 / Median-view window: 1=7 days, 2=15 days, 3=30 days"
    },
    "min_cpm": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Cpm",
      "description": "CPM 下限，即花费除以播放量再乘1000 / Minimum CPM, calculated as spend divided by views times 1,000"
    },
    "max_cpm": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Cpm",
      "description": "CPM 上限，即花费除以播放量再乘1000 / Maximum CPM, calculated as spend divided by views times 1,000"
    },
    "cpm_type": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cpm Type",
      "description": "CPM 流量口径：1=全部流量，2=自然流量 / CPM traffic scope: 1=all traffic, 2=organic traffic"
    },
    "cpm_cycle": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cpm Cycle",
      "description": "CPM 统计周期：1=7天，2=15天，3=30天 / CPM window: 1=7 days, 2=15 days, 3=30 days"
    },
    "min_cpc": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Cpc",
      "description": "CPC 下限，即花费除以组件点击次数 / Minimum CPC, calculated as spend divided by component clicks"
    },
    "max_cpc": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Cpc",
      "description": "CPC 上限，即花费除以组件点击次数 / Maximum CPC, calculated as spend divided by component clicks"
    },
    "cpc_traffic_type": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cpc Traffic Type",
      "description": "CPC 流量口径：1=全部流量，2=自然流量 / CPC traffic scope: 1=all traffic, 2=organic traffic"
    },
    "cpc_cycle": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cpc Cycle",
      "description": "CPC 统计周期：1=7天，2=15天，3=30天 / CPC window: 1=7 days, 2=15 days, 3=30 days"
    },
    "cpe_gte": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cpe Gte",
      "description": "CPE 下限，即花费除以有效互动次数 / Minimum CPE, calculated as spend divided by valid engagements"
    },
    "cpe_lt": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cpe Lt",
      "description": "CPE 上限，即花费除以有效互动次数 / Maximum CPE, calculated as spend divided by valid engagements"
    },
    "cpe_traffic_type": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cpe Traffic Type",
      "description": "CPE 流量口径：1=全部流量，2=自然流量 / CPE traffic scope: 1=all traffic, 2=organic traffic"
    },
    "cpe_cycle": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cpe Cycle",
      "description": "CPE 统计周期：1=7天，3=30天 / CPE window: 1=7 days, 3=30 days"
    },
    "draft_duration": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Draft Duration",
      "description": "主流视频时长：1=0-30秒，2=30-60秒，3=1-3分，4=3-5分，5=5-10分，6=10分以上 / Dominant video duration bucket from under 30 seconds to over 10 minutes"
    },
    "min_avid_cnt": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Avid Cnt",
      "description": "近90天有效原创稿件数下限 / Minimum eligible original-video count in the last 90 days"
    },
    "max_avid_cnt": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Avid Cnt",
      "description": "近90天有效原创稿件数上限 / Maximum eligible original-video count in the last 90 days"
    },
    "min_hot_avid_rate": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Min Hot Avid Rate",
      "description": "近90天爆款稿件占比下限 / Minimum viral-video ratio in the last 90 days"
    },
    "max_hot_avid_rate": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Max Hot Avid Rate",
      "description": "近90天爆款稿件占比上限 / Maximum viral-video ratio in the last 90 days"
    },
    "half_min_hot_avid_cnt": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Half Min Hot Avid Cnt",
      "description": "近半年爆款稿件数下限 / Minimum viral-video count in the last six months"
    },
    "half_max_hot_avid_cnt": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Half Max Hot Avid Cnt",
      "description": "近半年爆款稿件数上限 / Maximum viral-video count in the last six months"
    },
    "entry_cost_min": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Entry Cost Min",
      "description": "近一年相关合作的进店成本下限 / Minimum store-entry cost for relevant cooperation in the last year"
    },
    "entry_cost_max": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Entry Cost Max",
      "description": "近一年相关合作的进店成本上限 / Maximum store-entry cost for relevant cooperation in the last year"
    },
    "av_honor": {
      "anyOf": [
        {
          "properties": {
            "honor_type": {
              "anyOf": [
                {
                  "items": {
                    "type": "string"
                  },
                  "type": "array"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Honor Type",
              "description": "荣誉类型数组，可多选：HOT=热门、MZBK=每周必看、QZPHB=全站排行榜 / Multi-select honor types: HOT, MZBK, and QZPHB"
            },
            "time_period": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Time Period",
              "description": "统计周期：0=不限，30/90/180=近对应天数 / Time period: 0=all, or the most recent 30, 90, or 180 days"
            },
            "honor_count": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Honor Count",
              "description": "获奖次数：0=不限，1=1次，2=2次，3=3次及以上 / Honor count: 0=all, 1=once, 2=twice, 3=three or more"
            }
          },
          "additionalProperties": true,
          "type": "object",
          "title": "UpperHonorFilter",
          "description": "UP 主稿件荣誉筛选 / Creator video-honor filter."
        },
        {
          "type": "null"
        }
      ],
      "description": "稿件荣誉没有独立选项接口，取值见 search_upper 文档；honor_type 始终为可多选数组 / Video honors have no separate options endpoint; use the search_upper documentation and always send honor_type as an array"
    },
    "cooperate_experience_industry_ids": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cooperate Experience Industry Ids",
      "description": "非通用行业面板先调用 /api/v1/bilibili/huahuo/cooperate_experience_industry，再把选中行业 ID 放入此数组；通用面板不使用此字段 / For non-general panels, call /api/v1/bilibili/huahuo/cooperate_experience_industry first and put selected IDs here; unused by the general panel"
    },
    "cooperate_experience_type": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cooperate Experience Type",
      "description": "非通用行业策略面板的合作经验类型：1=有当前行业经验，2=当前行业经验丰富，3=无当前行业经验，4=有其他行业经验；选择行业时仅使用1或2，通用面板改用 spark_tag / Experience type for non-general strategy panels: 1=experienced, 2=extensive, 3=none in current industry, 4=experience in other industries; use 1 or 2 with selected industries, while the general panel uses spark_tag"
    },
    "special_tags": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Special Tags",
      "description": "特色标签列表，取值见 /api/v1/bilibili/huahuo/square_static_info / Feature-tag values from /api/v1/bilibili/huahuo/square_static_info"
    },
    "spark_tag": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Spark Tag",
      "description": "花火能力标签；通用面板合作次数使用 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_in": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Square Tag In",
      "description": "广场场景标签，例如 ad_partner_experienced / Marketplace scenario tags such as ad_partner_experienced"
    },
    "label_array": {
      "anyOf": [
        {
          "items": {
            "items": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "string"
                }
              ]
            },
            "type": "array"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Label Array",
      "description": "先调用 /api/v1/bilibili/huahuo/upper_label_tree；把内容类型分组中所有已选节点的 value 放入同一个内层数组 / Call /api/v1/bilibili/huahuo/upper_label_tree first, then put all selected content-type values in one inner array"
    },
    "bdata_tag_lv5": {
      "anyOf": [
        {
          "items": {},
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Bdata Tag Lv5",
      "description": "B站五级内容标签筛选值列表 / Bilibili level-five content-tag filter values"
    },
    "huahuo_first_industry_ids": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Huahuo First Industry Ids",
      "description": "通用面板先调用 /api/v1/bilibili/huahuo/square_static_info；把 industry_tree 选中路径的一级 ID 放入此数组 / For the general panel, call /api/v1/bilibili/huahuo/square_static_info and put selected primary industry_tree IDs here"
    },
    "huahuo_second_industry_ids": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Huahuo Second Industry Ids",
      "description": "通用面板先调用 /api/v1/bilibili/huahuo/square_static_info；把 industry_tree 选中路径的二级 ID 放入此数组 / For the general panel, call /api/v1/bilibili/huahuo/square_static_info and put selected secondary industry_tree IDs here"
    },
    "huahuo_third_industry_ids": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Huahuo Third Industry Ids",
      "description": "通用面板先调用 /api/v1/bilibili/huahuo/square_static_info；把 industry_tree 选中路径的三级 ID 放入此数组 / For the general panel, call /api/v1/bilibili/huahuo/square_static_info and put selected tertiary industry_tree IDs here"
    },
    "goods_permission": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Goods Permission",
      "description": "带货权限筛选：1=有权限，0=不限 / Commerce permission filter: 1=required, 0=all"
    },
    "goods_up_levels": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Goods Up Levels",
      "description": "带货 UP 主等级列表 / Commerce-creator level values"
    },
    "goods_category_first_ids": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Goods Category First Ids",
      "description": "带货一级类目 ID 列表，取值见 /api/v1/bilibili/huahuo/effect_goods_drop / Primary commerce-category IDs from /api/v1/bilibili/huahuo/effect_goods_drop"
    },
    "goods_category_second_ids": {
      "anyOf": [
        {
          "items": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "string"
              }
            ]
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "title": "Goods Category Second Ids",
      "description": "带货二级类目 ID 列表，取值见 /api/v1/bilibili/huahuo/effect_goods_drop / Secondary commerce-category IDs from /api/v1/bilibili/huahuo/effect_goods_drop"
    },
    "goods_gpm_min": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Goods Gpm Min",
      "description": "近30天 GPM 下限，即每千次带货视频播放产生的支付 GMV / Minimum 30-day GPM, paid GMV per 1,000 commerce-video views"
    },
    "goods_gpm_max": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Goods Gpm Max",
      "description": "近30天 GPM 上限，即每千次带货视频播放产生的支付 GMV / Maximum 30-day GPM, paid GMV per 1,000 commerce-video views"
    },
    "goods_ctr_min": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Goods Ctr Min",
      "description": "带货组件点击率下限，即组件点击数除以曝光数 / Minimum commerce-component CTR, clicks divided by impressions"
    },
    "goods_ctr_max": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Goods Ctr Max",
      "description": "带货组件点击率上限，即组件点击数除以曝光数 / Maximum commerce-component CTR, clicks divided by impressions"
    },
    "goods_ctr_type": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Goods Ctr Type",
      "description": "带货点击率组件口径：1=全部组件，2=评论区组件 / Commerce CTR component scope: 1=all components, 2=comment component"
    },
    "goods_avg_price_min": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Goods Avg Price Min",
      "description": "近30天商品平均价格下限，单位为人民币元 / Minimum average product price in the last 30 days, in RMB"
    },
    "goods_avg_price_max": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "number"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Goods Avg Price Max",
      "description": "近30天商品平均价格上限，单位为人民币元 / Maximum average product price in the last 30 days, in RMB"
    },
    "goods_is_high_video_play_permeate": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Goods Is High Video Play Permeate",
      "description": "高视频播放渗透筛选，近30天播放用户占粉丝数比例居前20% / High video-view penetration filter, top 20% by recent viewers per follower"
    },
    "goods_is_high_fans_play_permeate": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Goods Is High Fans Play Permeate",
      "description": "高粉丝播放渗透筛选 / High follower-view penetration filter"
    },
    "is_boosting": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Boosting",
      "description": "是否筛选内容加热中的 UP 主：1=是，0=不限 / Boosting-status filter: 1=currently boosting, 0=all"
    },
    "is_treasure_up": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Treasure Up",
      "description": "是否筛选宝藏 UP 主 / Whether to filter for treasure creators"
    },
    "is_timely_response": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is Timely Response",
      "description": "是否筛选及时响应的 UP 主 / Whether to require timely-response creators"
    },
    "is_new_enter": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is New Enter",
      "description": "是否筛选新入驻 UP 主 / Whether to filter for newly onboarded creators"
    },
    "custom_video_pricing_set": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Custom Video Pricing Set",
      "description": "是否已设置定制视频报价 / Whether custom-video pricing has been configured"
    },
    "is_x_plan_better_up": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Is X Plan Better Up",
      "description": "是否筛选 X 计划优选 UP 主 / Whether to filter for X Plan preferred creators"
    },
    "high_potential_type": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "High Potential Type",
      "description": "高潜类型：0=全部，1=已入驻，2=未入驻 / High-potential type: 0=all, 1=onboarded, 2=not onboarded"
    }
  },
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "tikhub/bilibili-huahuo-search-upper",
  "input": {}
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://api.tikhub.io/#/Bilibili-Huahuo-API/search_upper_api_v1_bilibili_huahuo_search_upper_post)

[REST inspection](https://api.agentik.cc/v1/tools/tikhub/bilibili-huahuo-search-upper) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/tikhub/bilibili-huahuo-search-upper) · [Agent index](/llms.txt)