> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Huahuo creators or content

> Search Huahuo creators or content

Search Huahuo creators or content

**Pricing** — base \$0.0145 per successful call (provider cost × 1.45; final charge scales by your plan multiplier). Charged only when the upstream response body `code` is `200`.

## Example

```bash theme={null}
curl -X POST "https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_upper" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'  # see request schema below
```


## OpenAPI

````yaml openapi/tikhub-en.json POST /tikhub/bilibili/huahuo/search_upper
openapi: 3.0.0
info:
  title: TikHub API
  description: >-
    Multi-platform social media data via TikHub — Douyin, TikTok, Bilibili,
    Kuaishou, Weibo, Xiaohongshu, Zhihu, and commercial
    (Xingtu/Huahuo/Billboard) endpoints.
  version: 1.0.0
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - bearerAuth: []
paths:
  /tikhub/bilibili/huahuo/search_upper:
    post:
      tags:
        - TikHub - Bilibili
      summary: Search Huahuo creators or content
      description: Search Huahuo creators or content
      operationId: post_tikhub_bilibili_huahuo_search_upper
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpperSearchBody'
            examples:
              content_type_single:
                summary: Single content type
                description: >-
                  Select Outdoor Travel > Outdoor Adventure (upper_label_tree
                  value=794).
                value:
                  label_array:
                    - - 794
                  page: 1
              content_type_multiple:
                summary: Multiple content types
                description: >-
                  Select Outdoor Adventure (794), AI Short Film (747), and AI
                  Funny Video (748) simultaneously; all values are in the same
                  inner array.
                value:
                  label_array:
                    - - 794
                      - 747
                      - 748
                  page: 1
              cooperation_pricing_deep_custom:
                summary: Deep-custom pricing
                description: >-
                  Over 100,000 RMB; includes licensed derivative
                  creation/distribution, complimentary trailer, and custom
                  content; creation skills selected: overseas filming, in-depth
                  technical analysis, short film/micro-movie.
                value:
                  price_info:
                    - cooperation_type: 22
                      creative_skill:
                        - 1
                        - 2
                        - 3
                      include_content:
                        - 1
                        - 2
                        - 3
                      price_min: 100000
                      price_max: ''
                      price_right: []
                  page: 1
              cooperation_pricing_embedded_video:
                summary: Embedded-video pricing
                description: >-
                  Embedded-video pricing 100,000 RMB or above; pass empty arrays
                  for unavailable creative skills and included content.
                value:
                  price_info:
                    - cooperation_type: 1
                      creative_skill: []
                      include_content: []
                      price_min: 100000
                      price_max: ''
                      price_right: []
                  page: 1
              cooperation_pricing_custom_podcast:
                summary: Custom-podcast pricing
                description: >-
                  Custom podcast series, starting at 100,000 CNY, including
                  licensing for derivative content/distribution.
                value:
                  price_info:
                    - cooperation_type: 23
                      creative_skill: []
                      include_content:
                        - 1
                      price_min: 100000
                      price_max: ''
                      price_right: []
                  page: 1
              cooperation_pricing_direct_post:
                summary: Direct-post pricing
                description: >-
                  Direct-post pricing 100,000 RMB or above; pass empty arrays
                  for unavailable array fields.
                value:
                  price_info:
                    - cooperation_type: 3
                      creative_skill: []
                      include_content: []
                      price_min: 100000
                      price_max: ''
                      price_right: []
                  page: 1
              cooperation_experience_real_estate:
                summary: Real-estate cooperation experience
                description: >-
                  Cooperation count set to "Has cooperation experience",
                  cooperation industry set to "Real Estate / All".
                value:
                  panel_type: 0
                  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'
                  page: 1
              cooperation_experience_multiple_industries:
                summary: Extensive multi-industry experience
                description: >-
                  Cooperation count set to "Extensive experience", with all
                  selected industry IDs for Real Estate, Furniture, and Bathroom
                  Products passed hierarchically.
                value:
                  panel_type: 0
                  spark_tag:
                    - coo_frequent
                  huahuo_first_industry_ids:
                    - '388'
                    - '405'
                  huahuo_second_industry_ids:
                    - '389'
                    - '393'
                    - '399'
                    - '401'
                    - '403'
                    - '406'
                    - '411'
                  huahuo_third_industry_ids:
                    - '390'
                    - '394'
                    - '395'
                    - '396'
                    - '398'
                    - '400'
                    - '402'
                    - '404'
                    - '407'
                    - '408'
                    - '409'
                    - '410'
                    - '413'
                  page: 1
              cooperation_experience_multiple_industries_experienced:
                summary: Multiple-industry cooperation experience
                description: >-
                  Cooperation count set to "Has cooperation experience", with
                  all selected industry IDs for Real Estate, Furniture, and
                  Bathroom Products passed hierarchically.
                value:
                  panel_type: 0
                  spark_tag:
                    - cooperate
                  huahuo_first_industry_ids:
                    - '388'
                    - '405'
                  huahuo_second_industry_ids:
                    - '389'
                    - '393'
                    - '399'
                    - '401'
                    - '403'
                    - '406'
                    - '411'
                  huahuo_third_industry_ids:
                    - '390'
                    - '394'
                    - '395'
                    - '396'
                    - '398'
                    - '400'
                    - '402'
                    - '404'
                    - '407'
                    - '408'
                    - '409'
                    - '410'
                    - '413'
                  page: 1
              residence_regions_multiple:
                summary: Multiple residence regions
                description: >-
                  Select Beijing (4), Shanghai (5), Fujian (23), and within
                  Fujian: Xiamen (51) and Fuzhou (50).
                value:
                  region_id:
                    - 4
                    - 5
                    - 23
                  second_region_id:
                    - 51
                    - 50
                  page: 1
              median_views:
                summary: Median views
                description: >-
                  300,000 to 500,000, organic traffic scope, last 15 days; pass
                  range as a string.
                value:
                  min_play_median: '300000'
                  max_play_median: '500000'
                  play_median_traffic_type: 2
                  play_median_cycle: 2
                  page: 1
              median_views_default_scope:
                summary: Median views from 500K to 1M
                description: >-
                  500,000 to 1,000,000, all traffic scope, last 30 days; pass
                  range as a string.
                value:
                  min_play_median: '500000'
                  max_play_median: '1000000'
                  play_median_traffic_type: 1
                  play_median_cycle: 3
                  page: 1
              video_honors_multiple:
                summary: Multiple video honors
                description: >-
                  Hot or site-wide chart honor awarded twice in the last 90
                  days.
                value:
                  av_honor:
                    honor_type:
                      - HOT
                      - QZPHB
                    time_period: 90
                    honor_count: 2
                  page: 1
              video_honors_single:
                summary: Single video honor
                description: Hot honor awarded once in the last 30 days.
                value:
                  av_honor:
                    honor_type:
                      - HOT
                    time_period: 30
                    honor_count: 1
                  page: 1
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
components:
  schemas:
    UpperSearchBody:
      properties:
        nickname_or_mids:
          title: Nickname Or Mids
          description: Creator nickname or UID query; separate multiple terms with commas
          nullable: true
          type: string
        main_search:
          title: Main Search
          description: Content-keyword query; matched videos are included in the result
          nullable: true
          type: string
        mids:
          title: Mids
          description: List of creator UIDs to match exactly
          nullable: true
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
        upper_mid:
          anyOf:
            - type: integer
            - type: string
          title: Upper Mid
          description: Single creator UID for an exact match
          nullable: true
        folder_id:
          anyOf:
            - type: integer
            - type: string
          title: Folder Id
          description: Saved-creator folder ID used to limit the search
          nullable: true
        marketing_target:
          title: Marketing Target
          description: >-
            Marketing objective: 1=brand awareness, 2=consideration,
            3=conversion
          nullable: true
          type: integer
        panel_type:
          title: Panel Type
          description: >-
            Strategy panel: 0=general, 1=gaming, 2=beauty, 3=digital,
            4=automotive, 5=performance, 6=food, 8=internet
          nullable: true
          type: integer
        order_by:
          title: Order By
          description: Sort field, such as fans_num, play_median, or interactive_rate
          nullable: true
          type: string
        sort:
          title: Sort
          description: 'Sort direction: desc=descending, asc=ascending'
          nullable: true
          type: string
        page:
          title: Page
          description: One-based page number; each page returns 20 records
          nullable: true
          type: integer
          minimum: 1
        request_id:
          title: Request Id
          description: Search-session ID; reuse it across pages of the same filter set
          nullable: true
          type: string
        gender:
          title: Gender
          description: >-
            Creator gender from gender_info returned by
            /api/v1/bilibili/huahuo/square_static_info
          nullable: true
          type: string
        min_fans_num:
          anyOf:
            - type: integer
            - type: string
          title: Min Fans Num
          description: Minimum follower count, inclusive
          nullable: true
        max_fans_num:
          anyOf:
            - type: integer
            - type: string
          title: Max Fans Num
          description: Maximum follower count, inclusive
          nullable: true
        region_id:
          title: Region Id
          description: >-
            Call /api/v1/bilibili/huahuo/region_drop first, then put selected
            primary-region values in this array
          nullable: true
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
        second_region_id:
          title: Second Region Id
          description: >-
            Call /api/v1/bilibili/huahuo/region_drop first, then put selected
            child-region values in this array
          nullable: true
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
        partition_id:
          anyOf:
            - type: integer
            - type: string
          title: Partition Id
          description: >-
            Primary content-category ID from
            /api/v1/bilibili/huahuo/partition_drop
          nullable: true
        second_partition_id:
          title: Second Partition Id
          description: >-
            Secondary content-category IDs from
            /api/v1/bilibili/huahuo/partition_drop
          nullable: true
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
        mcn_ids:
          title: Mcn Ids
          description: MCN organization IDs from /api/v1/bilibili/huahuo/mcn_drop
          nullable: true
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
        provider_id:
          title: Provider Id
          description: Service-provider IDs using values offered by the Huahuo filter
          nullable: true
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
        upper_types:
          title: Upper Types
          description: 'Creator type: 1 or 4=MCN-affiliated, 3=independent'
          nullable: true
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
        only_contract:
          title: Only Contract
          description: 'Contract-eligible filter: 1=only eligible creators, 0=all'
          nullable: true
          type: integer
        is_painter_order:
          title: Is Painter Order
          description: Whether to require illustration-commission capability
          nullable: true
          type: boolean
        fans_age_tag:
          title: Fans Age Tag
          description: >-
            Audience age-affinity tags from
            /api/v1/bilibili/huahuo/square_static_info
          nullable: true
          items:
            type: string
          type: array
        fans_gender_tag:
          title: Fans Gender Tag
          description: >-
            Audience gender-affinity tags from
            /api/v1/bilibili/huahuo/square_static_info
          nullable: true
          items:
            type: string
          type: array
        fans_region_tag:
          title: Fans Region Tag
          description: >-
            Audience region-affinity tags from
            /api/v1/bilibili/huahuo/square_static_info
          nullable: true
          items:
            type: string
          type: array
        fans_stick:
          title: Fans Stick
          description: Follower-loyalty filter; 0=all, otherwise use a static-option value
          nullable: true
          type: integer
        av_active:
          title: Av Active
          description: 'Recent-publishing activity switch: 1=enabled, 0=all'
          nullable: true
          type: integer
        av_active_tag:
          title: Av Active Tag
          description: >-
            Recent-publishing activity tier from av_active_tag returned by
            /api/v1/bilibili/huahuo/square_static_info
          nullable: true
          type: string
        dmp_group_id:
          anyOf:
            - type: integer
            - type: string
          title: Dmp Group Id
          description: >-
            DMP custom audience-package ID from
            /api/v1/bilibili/huahuo/dmp_pkg_list
          nullable: true
        category_dmp_group_id:
          anyOf:
            - type: integer
            - type: string
          title: Category Dmp Group Id
          description: Content-category DMP audience-package ID
          nullable: true
        category_dmp_label:
          title: Category Dmp Label
          description: Display label for the content-category DMP audience package
          nullable: true
          type: string
        dmp_pkg_name:
          title: Dmp Pkg Name
          description: DMP special-audience package name query
          nullable: true
          type: string
        dmp_pkg_vertical_rate_gte:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Dmp Pkg Vertical Rate Gte
          description: 'Minimum DMP verticality: matching videos divided by all videos'
          nullable: true
        dmp_pkg_vertical_rate_lte:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Dmp Pkg Vertical Rate Lte
          description: 'Maximum DMP verticality: matching videos divided by all videos'
          nullable: true
        dmp_pkg_effect_rate_gte:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Dmp Pkg Effect Rate Gte
          description: >-
            Minimum DMP influence: recent matching viewers divided by the
            audience population
          nullable: true
        dmp_pkg_effect_rate_lte:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Dmp Pkg Effect Rate Lte
          description: >-
            Maximum DMP influence: recent matching viewers divided by the
            audience population
          nullable: true
        dmp_pkg_fan_rate_gte:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Dmp Pkg Fan Rate Gte
          description: >-
            Minimum DMP attention: matching audience members divided by all
            followers
          nullable: true
        dmp_pkg_fan_rate_lte:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Dmp Pkg Fan Rate Lte
          description: >-
            Maximum DMP attention: matching audience members divided by all
            followers
          nullable: true
        min_task_price:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Min Task Price
          description: Minimum standard cooperation quote in RMB
          nullable: true
        max_task_price:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Max Task Price
          description: Maximum standard cooperation quote in RMB
          nullable: true
        price_info:
          title: Price Info
          description: >-
            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
          nullable: true
          items:
            $ref: '#/components/schemas/UpperPriceFilter'
          type: array
        last_7_days_set_price:
          title: Last 7 Days Set Price
          description: 'Quote-updated-in-7-days filter: 1=yes, 0=all'
          nullable: true
          type: integer
        last_14_days_set_price:
          title: Last 14 Days Set Price
          description: 'Quote-updated-in-14-days filter: 1=yes, 0=all'
          nullable: true
          type: integer
        last_30_days_set_price:
          title: Last 30 Days Set Price
          description: 'Quote-updated-in-30-days filter: 1=yes, 0=all'
          nullable: true
          type: integer
        min_interact_rate:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Min Interact Rate
          description: >-
            Minimum engagement rate for eligible original videos in the last 180
            days
          nullable: true
        max_interact_rate:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Max Interact Rate
          description: >-
            Maximum engagement rate for eligible original videos in the last 180
            days
          nullable: true
        blue_url_ctr_gte:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Blue Url Ctr Gte
          description: Minimum blue-link CTR, blue-link clicks divided by video views
          nullable: true
        blue_url_ctr_lt:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Blue Url Ctr Lt
          description: Maximum blue-link CTR, blue-link clicks divided by video views
          nullable: true
        blue_url_click_cost_gte:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Blue Url Click Cost Gte
          description: >-
            Minimum blue-link click cost, cooperation and promotion spend
            divided by clicks
          nullable: true
        blue_url_click_cost_lt:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Blue Url Click Cost Lt
          description: >-
            Maximum blue-link click cost, cooperation and promotion spend
            divided by clicks
          nullable: true
        min_play_median:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Min Play Median
          description: >-
            Minimum median views for eligible original videos published at least
            seven days ago
          nullable: true
        max_play_median:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Max Play Median
          description: >-
            Maximum median views for eligible original videos published at least
            seven days ago
          nullable: true
        play_median_traffic_type:
          title: Play Median Traffic Type
          description: 'Median-view traffic scope: 1=all traffic, 2=organic traffic'
          nullable: true
          type: integer
        play_median_cycle:
          title: Play Median Cycle
          description: 'Median-view window: 1=7 days, 2=15 days, 3=30 days'
          nullable: true
          type: integer
        min_cpm:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Min Cpm
          description: Minimum CPM, calculated as spend divided by views times 1,000
          nullable: true
        max_cpm:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Max Cpm
          description: Maximum CPM, calculated as spend divided by views times 1,000
          nullable: true
        cpm_type:
          title: Cpm Type
          description: 'CPM traffic scope: 1=all traffic, 2=organic traffic'
          nullable: true
          type: integer
        cpm_cycle:
          title: Cpm Cycle
          description: 'CPM window: 1=7 days, 2=15 days, 3=30 days'
          nullable: true
          type: integer
        min_cpc:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Min Cpc
          description: Minimum CPC, calculated as spend divided by component clicks
          nullable: true
        max_cpc:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Max Cpc
          description: Maximum CPC, calculated as spend divided by component clicks
          nullable: true
        cpc_traffic_type:
          title: Cpc Traffic Type
          description: 'CPC traffic scope: 1=all traffic, 2=organic traffic'
          nullable: true
          type: integer
        cpc_cycle:
          title: Cpc Cycle
          description: 'CPC window: 1=7 days, 2=15 days, 3=30 days'
          nullable: true
          type: integer
        cpe_gte:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Cpe Gte
          description: Minimum CPE, calculated as spend divided by valid engagements
          nullable: true
        cpe_lt:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Cpe Lt
          description: Maximum CPE, calculated as spend divided by valid engagements
          nullable: true
        cpe_traffic_type:
          title: Cpe Traffic Type
          description: 'CPE traffic scope: 1=all traffic, 2=organic traffic'
          nullable: true
          type: integer
        cpe_cycle:
          title: Cpe Cycle
          description: 'CPE window: 1=7 days, 3=30 days'
          nullable: true
          type: integer
        draft_duration:
          anyOf:
            - type: integer
            - type: string
          title: Draft Duration
          description: >-
            Dominant video duration: 1=0-30s, 2=30-60s, 3=1-3min, 4=3-5min,
            5=5-10min, 6=over 10min
          nullable: true
        min_avid_cnt:
          anyOf:
            - type: integer
            - type: string
          title: Min Avid Cnt
          description: Minimum eligible original-video count in the last 90 days
          nullable: true
        max_avid_cnt:
          anyOf:
            - type: integer
            - type: string
          title: Max Avid Cnt
          description: Maximum eligible original-video count in the last 90 days
          nullable: true
        min_hot_avid_rate:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Min Hot Avid Rate
          description: Minimum viral-video ratio in the last 90 days
          nullable: true
        max_hot_avid_rate:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Max Hot Avid Rate
          description: Maximum viral-video ratio in the last 90 days
          nullable: true
        half_min_hot_avid_cnt:
          anyOf:
            - type: integer
            - type: string
          title: Half Min Hot Avid Cnt
          description: Minimum viral-video count in the last six months
          nullable: true
        half_max_hot_avid_cnt:
          anyOf:
            - type: integer
            - type: string
          title: Half Max Hot Avid Cnt
          description: Maximum viral-video count in the last six months
          nullable: true
        entry_cost_min:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Entry Cost Min
          description: Minimum store-entry cost for relevant cooperation in the last year
          nullable: true
        entry_cost_max:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Entry Cost Max
          description: Maximum store-entry cost for relevant cooperation in the last year
          nullable: true
        av_honor:
          $ref: '#/components/schemas/UpperHonorFilter'
          description: >-
            Video honors have no separate options endpoint; use the search_upper
            documentation and always send honor_type as an array
          nullable: true
        cooperate_experience_industry_ids:
          title: Cooperate Experience Industry Ids
          description: >-
            For non-general panels, call
            /api/v1/bilibili/huahuo/cooperate_experience_industry first and put
            selected IDs here; unused by the general panel
          nullable: true
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
        cooperate_experience_type:
          anyOf:
            - type: integer
            - type: string
          title: Cooperate Experience Type
          description: >-
            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
          nullable: true
        special_tags:
          title: Special Tags
          description: Feature-tag values from /api/v1/bilibili/huahuo/square_static_info
          nullable: true
          items:
            type: string
          type: array
        spark_tag:
          title: Spark Tag
          description: >-
            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
          nullable: true
          items:
            type: string
          type: array
        square_tag_in:
          title: Square Tag In
          description: Marketplace scenario tags such as ad_partner_experienced
          nullable: true
          items:
            type: string
          type: array
        label_array:
          title: Label Array
          description: >-
            Call /api/v1/bilibili/huahuo/upper_label_tree first, then put all
            selected content-type values in one inner array
          nullable: true
          items:
            items:
              anyOf:
                - type: integer
                - type: string
            type: array
          type: array
        bdata_tag_lv5:
          title: Bdata Tag Lv5
          description: Bilibili level-five content-tag filter values
          nullable: true
          items: {}
          type: array
        huahuo_first_industry_ids:
          title: Huahuo First Industry Ids
          description: >-
            For the general panel, call
            /api/v1/bilibili/huahuo/square_static_info and put selected primary
            industry_tree IDs here
          nullable: true
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
        huahuo_second_industry_ids:
          title: Huahuo Second Industry Ids
          description: >-
            For the general panel, call
            /api/v1/bilibili/huahuo/square_static_info and put selected
            secondary industry_tree IDs here
          nullable: true
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
        huahuo_third_industry_ids:
          title: Huahuo Third Industry Ids
          description: >-
            For the general panel, call
            /api/v1/bilibili/huahuo/square_static_info and put selected tertiary
            industry_tree IDs here
          nullable: true
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
        goods_permission:
          title: Goods Permission
          description: 'Commerce permission filter: 1=required, 0=all'
          nullable: true
          type: integer
        goods_up_levels:
          title: Goods Up Levels
          description: Commerce-creator level values
          nullable: true
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
        goods_category_first_ids:
          title: Goods Category First Ids
          description: >-
            Primary commerce-category IDs from
            /api/v1/bilibili/huahuo/effect_goods_drop
          nullable: true
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
        goods_category_second_ids:
          title: Goods Category Second Ids
          description: >-
            Secondary commerce-category IDs from
            /api/v1/bilibili/huahuo/effect_goods_drop
          nullable: true
          items:
            anyOf:
              - type: integer
              - type: string
          type: array
        goods_gpm_min:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Goods Gpm Min
          description: Minimum 30-day GPM, paid GMV per 1,000 commerce-video views
          nullable: true
        goods_gpm_max:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Goods Gpm Max
          description: Maximum 30-day GPM, paid GMV per 1,000 commerce-video views
          nullable: true
        goods_ctr_min:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Goods Ctr Min
          description: Minimum commerce-component CTR, clicks divided by impressions
          nullable: true
        goods_ctr_max:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Goods Ctr Max
          description: Maximum commerce-component CTR, clicks divided by impressions
          nullable: true
        goods_ctr_type:
          title: Goods Ctr Type
          description: 'Commerce CTR component scope: 1=all components, 2=comment component'
          nullable: true
          type: integer
        goods_avg_price_min:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Goods Avg Price Min
          description: Minimum average product price in the last 30 days, in RMB
          nullable: true
        goods_avg_price_max:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Goods Avg Price Max
          description: Maximum average product price in the last 30 days, in RMB
          nullable: true
        goods_is_high_video_play_permeate:
          anyOf:
            - type: integer
            - type: string
          title: Goods Is High Video Play Permeate
          description: >-
            High video-view penetration filter, top 20% by recent viewers per
            follower
          nullable: true
        goods_is_high_fans_play_permeate:
          anyOf:
            - type: integer
            - type: string
          title: Goods Is High Fans Play Permeate
          description: High follower-view penetration filter
          nullable: true
        is_boosting:
          title: Is Boosting
          description: 'Boosting-status filter: 1=currently boosting, 0=all'
          nullable: true
          type: integer
        is_treasure_up:
          anyOf:
            - type: integer
            - type: string
          title: Is Treasure Up
          description: Whether to filter for treasure creators
          nullable: true
        is_timely_response:
          anyOf:
            - type: integer
            - type: string
          title: Is Timely Response
          description: Whether to require timely-response creators
          nullable: true
        is_new_enter:
          anyOf:
            - type: integer
            - type: string
          title: Is New Enter
          description: Whether to filter for newly onboarded creators
          nullable: true
        custom_video_pricing_set:
          anyOf:
            - type: integer
            - type: string
          title: Custom Video Pricing Set
          description: Whether custom-video pricing has been configured
          nullable: true
        is_x_plan_better_up:
          anyOf:
            - type: integer
            - type: string
          title: Is X Plan Better Up
          description: Whether to filter for X Plan preferred creators
          nullable: true
        high_potential_type:
          title: High Potential Type
          description: 'High-potential type: 0=all, 1=onboarded, 2=not onboarded'
          nullable: true
          type: integer
      additionalProperties: true
      type: object
      title: UpperSearchBody
      description: >-
        ### Search modes:

        - `nickname_or_mids`: Search by creator nickname or UID; separate
        multiple
          terms with commas.
        - `main_search`: Search by content keyword and include matched videos in
          the response.
        - `mids` / `upper_mid`: Match one or more creator UIDs exactly.


        ### Filter groups:

        - **Profile and affiliation**: gender, followers, region, content
        category,
          MCN, service provider, and account type.
        - **Audience profile**: age, gender, region affinity, and follower
        loyalty.

        - **Pricing and performance**: quote, engagement rate, median views,
        CPM,
          CPC, CPE, and store-entry cost.
        - **Content and cooperation**: post count, viral-post ratio, video
        duration,
          honors, industries, and cooperation experience.
        - **Commerce**: permission, level, categories, GPM, component CTR, and
          average product price.
        - **Audience packages and labels**: DMP packages, feature tags,
        content-type
          trees, and high-potential tags.

        Every field is optional. Send ratio fields as decimal values (for
        example,

        `0.05` for 5%) and monetary fields as the RMB values displayed by
        Huahuo.

        Dynamic IDs are available from `square_static_info`, `upper_label_tree`,

        and the corresponding dropdown endpoints.


        # [Example]

        ```json

        {
          "nickname_or_mids": "2233,xiaodianshi",
          "marketing_target": 1,
          "panel_type": 0,
          "min_fans_num": 100000,
          "max_fans_num": 1000000,
          "min_interact_rate": 0.03,
          "play_median_traffic_type": 1,
          "play_median_cycle": 3,
          "price_info": [{
            "cooperation_type": 1,
            "creative_skill": [],
            "include_content": [],
            "price_min": 1000,
            "price_max": 10000,
            "price_right": []
          }],
          "goods_ctr_type": 1,
          "page": 1
        }

        ```
    ResponseModel:
      properties:
        code:
          type: integer
          title: Code
          description: HTTP status code
          default: 200
        request_id:
          title: Request Id
          description: Unique request identifier
          nullable: true
          type: string
        message:
          type: string
          title: Message
          description: Response message (EN-US)
          default: Request successful. This request will incur a charge.
        message_zh:
          type: string
          title: Message Zh
          description: Response message (ZH-CN)
          default: Request successful; this request will be billed.
        support:
          type: string
          title: Support
          description: Support message
          default: 'Discord: https://discord.gg/aMEAS8Xsvz'
        time:
          type: string
          title: Time
          description: The time the response was generated
        time_stamp:
          type: integer
          title: Time Stamp
          description: The timestamp the response was generated
        time_zone:
          type: string
          title: Time Zone
          description: The timezone of the response time
          default: America/Los_Angeles
        docs:
          title: Docs
          description: Link to the API Swagger documentation for this endpoint
          nullable: true
          type: string
        cache_message:
          title: Cache Message
          description: Cache message (EN-US)
          default: >-
            This response is cached and accessible via the URL below for 24
            hours at no extra cost. The cache is for request tracing only — it
            doesn't affect the API's data freshness and won't be returned
            through the API again.
          nullable: true
          type: string
        cache_message_zh:
          title: Cache Message Zh
          description: Cache message (ZH-CN)
          default: >-
            This response has been cached and can be viewed directly via the URL
            below; it is valid for 24 hours and accessing the cached link incurs
            no additional charge. The cache is for request tracing only and does
            not affect the freshness of the API data, nor will it be returned
            again through the API.
          nullable: true
          type: string
        cache_url:
          title: Cache Url
          description: The URL to access the cached result
          nullable: true
          type: string
        router:
          type: string
          title: Router
          description: The endpoint that generated this response
          default: ''
        params:
          title: Params
          description: The parameters used in the request
          default: {}
        data:
          title: Data
          description: The response data
          nullable: true
      type: object
      title: ResponseModel
    UpperPriceFilter:
      properties:
        cooperation_type:
          anyOf:
            - type: integer
            - type: string
          title: Cooperation Type
          description: >-
            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
          nullable: true
        creative_skill:
          title: Creative Skill
          description: >-
            Deep-customization skill IDs: 1=Overseas Filming, 2=Hardcore Tech
            Analysis, 3=Short Film or Mini-movie, 4=Reality Show Challenge,
            5=Makeover or DIY, 6=Interview or Street Interview, 7=TVC
            Production, 8=Specialty Editing, 9=Other; options are returned in
            price_info_options.creative_skill via
            /api/v1/bilibili/huahuo/square_static_info
          nullable: true
          items:
            type: integer
          type: array
        include_content:
          title: Include Content
          description: >-
            Included-content IDs for custom video, deep customization, or custom
            podcast: 1=Authorized derivative/distribution, 2=Complimentary
            preview clip, 3=Custom content. Options are returned in
            price_info_options.include_content
          nullable: true
          items:
            type: integer
          type: array
        price_min:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Price Min
          description: >-
            Minimum quote in RMB; presets are returned in
            price_info_options.price_range by
            /api/v1/bilibili/huahuo/square_static_info
          nullable: true
        price_max:
          anyOf:
            - type: integer
            - type: number
            - type: string
          title: Price Max
          description: >-
            Maximum quote in RMB; presets are returned in
            price_info_options.price_range by
            /api/v1/bilibili/huahuo/square_static_info
          nullable: true
        price_right:
          title: Price Right
          description: >-
            Cooperation-right codes, e.g. show_in_video_first_1p3,
            show_in_video_gte_30s, brand_over_30_percent,
            auth_secondary_creation, multi_cooperation_discount, give_preview,
            give_poster. Full list and applicable types are in
            price_info_options.price_right returned by
            /api/v1/bilibili/huahuo/square_static_info; send [] when unselected
            or unavailable.
          nullable: true
          items:
            type: string
          type: array
      additionalProperties: true
      type: object
      title: UpperPriceFilter
      description: Quote filter for a cooperation format.
    UpperHonorFilter:
      properties:
        honor_type:
          title: Honor Type
          description: 'Multi-select honor types: HOT, MZBK, and QZPHB'
          nullable: true
          items:
            type: string
          type: array
        time_period:
          title: Time Period
          description: 'Time period: 0=all, or the most recent 30, 90, or 180 days'
          nullable: true
          type: integer
        honor_count:
          title: Honor Count
          description: 'Honor count: 0=all, 1=once, 2=twice, 3=three or more'
          nullable: true
          type: integer
      additionalProperties: true
      type: object
      title: UpperHonorFilter
      description: Creator video-honor filter.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: AIsa API key. Get yours at https://aisa.one

````