> ## 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. # UP主广场搜索（搜UP主 > UP主广场搜索（搜UP主 UP主广场搜索（搜UP主 **计费** — 成功调用基准价 \$0.0145（= provider 成本 × 1.45；最终扣费按你的套餐倍率浮动）。仅当上游响应体 `code` 为 `200` 时计费。 ## 示例 ```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 '{}' # 请求体结构见下方 schema ``` ## OpenAPI ````yaml openapi/tikhub.json POST /tikhub/bilibili/huahuo/search_upper openapi: 3.1.0 info: title: AIsa API description: >- Capability layer for the agentic economy. Models, skills, payments, and deployment — everything AI agents need to reason, act, and transact. This spec consolidates all AIsa API endpoints into a single reference. version: 1.0.0 contact: name: AIsa url: https://aisa.one email: developer@aisa.one license: name: MIT url: https://opensource.org/licenses/MIT termsOfService: https://aisa.one/tos servers: - url: https://api.aisa.one/apis/v1 description: AIsa Data APIs (Bearer auth — register at https://aisa.one) - url: https://api.aisa.one/apis/v2 description: >- AIsa Data APIs (x402 pay-per-call) — same surface as /apis/v1, mirrored. No registration; receive HTTP 402 challenge, settle with stablecoin micropayment. Spec: https://www.x402.org. Open-source gateway implementation: https://github.com/AIsa-team/aisa-proxy x-implementation: https://github.com/AIsa-team/aisa-proxy - url: https://api.aisa.one/v1 description: AIsa LLM Inference (OpenAI-compatible, Bearer auth) - url: https://api.aisa.one/v1beta description: AIsa Gemini-compatible GenerateContent (Bearer auth) security: - BearerAuth: [] tags: - name: AI Models description: >- Access 50+ LLMs via OpenAI-compatible, Anthropic, and Google Gemini interfaces - name: Account & Usage description: >- Programmatic account balance and usage endpoints for cost monitoring and alerting - name: Agent Email description: >- AI-agent email accounts, inboxes, threads, drafts, and message send/reply via AgentMail.to - name: Crypto Data description: Cryptocurrency prices, markets, and exchange data via CoinGecko - name: Financial Data description: Stock prices, financials, analyst estimates, SEC filings, and macro data - name: Image Generation description: Generate and edit images using AI models - name: Instagram description: >- Read public Instagram data — profiles, posts, reels, highlights, comments, and Google-backed search - name: Market Intelligence description: '' - name: Other description: '' - name: Pinterest description: >- Read public Pinterest data — search pins, fetch pin details, and browse boards - name: Prediction Markets description: Query prediction markets — Polymarket, Kalshi, and matching markets - name: Reddit description: >- Read public Reddit data — search posts, browse subreddits, and fetch comments - name: SEO & Search Data description: >- SERP, keywords, backlinks, domain and competitor analysis — DataForSEO, Semrush, and Ahrefs - name: Sales Intelligence description: B2B contact and company enrichment, search, and outreach via Apollo.io - name: Scholar Search description: Search academic papers and research - name: Twitter / X description: >- Read, search, and interact with Twitter/X — profiles, tweets, communities, trends, and engagement - name: WaveInflu description: '' - name: Web & News Search description: >- Search the web and news — Tavily search, Oxylabs AI-answer-engine queries, and model-grounded search - name: YouTube Search description: Search YouTube videos paths: /tikhub/bilibili/huahuo/search_upper: post: tags: - Other 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: anyOf: - type: string - type: 'null' title: Nickname Or Mids description: 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: List of creator UIDs to match exactly upper_mid: anyOf: - type: integer - type: string - type: 'null' title: Upper Mid description: Single creator UID for an exact match folder_id: anyOf: - type: integer - type: string - type: 'null' title: Folder Id description: Saved-creator folder ID used to limit the search marketing_target: anyOf: - type: integer - type: 'null' title: Marketing Target description: >- Marketing objective: 1=brand awareness, 2=consideration, 3=conversion panel_type: anyOf: - type: integer - type: 'null' title: Panel Type description: >- 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: Sort field, such as fans_num, play_median, or interactive_rate sort: anyOf: - type: string - type: 'null' title: Sort description: 'Sort direction: desc=descending, asc=ascending' page: anyOf: - type: integer minimum: 1 - type: 'null' title: Page description: 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: >- 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: >- 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: >- 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: >- 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: >- 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 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: 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: 'Creator type: 1 or 4=MCN-affiliated, 3=independent' only_contract: anyOf: - type: integer - type: 'null' title: Only Contract description: '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: - type: array items: type: string - type: 'null' title: Fans Age Tag description: >- Audience age-affinity tags from /api/v1/bilibili/huahuo/square_static_info fans_gender_tag: anyOf: - type: array items: type: string - type: 'null' title: Fans Gender Tag description: >- Audience gender-affinity tags from /api/v1/bilibili/huahuo/square_static_info fans_region_tag: anyOf: - type: array items: type: string - type: 'null' title: Fans Region Tag description: >- Audience region-affinity tags from /api/v1/bilibili/huahuo/square_static_info fans_stick: anyOf: - type: integer - type: 'null' title: Fans Stick description: Follower-loyalty filter; 0=all, otherwise use a static-option value av_active: anyOf: - type: integer - type: 'null' title: Av Active description: 'Recent-publishing activity switch: 1=enabled, 0=all' av_active_tag: anyOf: - type: string - type: 'null' title: Av Active Tag description: >- 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 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: Content-category DMP audience-package ID category_dmp_label: anyOf: - type: string - type: 'null' title: Category Dmp Label description: Display label for the content-category DMP audience package dmp_pkg_name: anyOf: - type: string - type: 'null' title: Dmp Pkg Name description: 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: '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: '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: >- 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: >- 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: >- 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: >- 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: $ref: '#/components/schemas/UpperPriceFilter' type: array - type: 'null' 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 last_7_days_set_price: anyOf: - type: integer - type: 'null' title: Last 7 Days Set Price description: '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: '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: '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: >- 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: >- 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: >- 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: >- 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: 'Median-view traffic scope: 1=all traffic, 2=organic traffic' play_median_cycle: anyOf: - type: integer - type: 'null' title: Play Median Cycle description: '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: 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: Maximum CPM, calculated as spend divided by views times 1,000 cpm_type: anyOf: - type: integer - type: 'null' title: Cpm Type description: 'CPM traffic scope: 1=all traffic, 2=organic traffic' cpm_cycle: anyOf: - type: integer - type: 'null' title: Cpm Cycle description: '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: Minimum CPC, calculated as spend divided by component clicks max_cpc: anyOf: - type: integer - type: number - type: string - type: 'null' title: Max Cpc description: Maximum CPC, calculated as spend divided by component clicks cpc_traffic_type: anyOf: - type: integer - type: 'null' title: Cpc Traffic Type description: 'CPC traffic scope: 1=all traffic, 2=organic traffic' cpc_cycle: anyOf: - type: integer - type: 'null' title: Cpc Cycle description: '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: Minimum CPE, calculated as spend divided by valid engagements cpe_lt: anyOf: - type: integer - type: number - type: string - type: 'null' title: Cpe Lt description: Maximum CPE, calculated as spend divided by valid engagements cpe_traffic_type: anyOf: - type: integer - type: 'null' title: Cpe Traffic Type description: 'CPE traffic scope: 1=all traffic, 2=organic traffic' cpe_cycle: anyOf: - type: integer - type: 'null' title: Cpe Cycle description: 'CPE window: 1=7 days, 3=30 days' draft_duration: anyOf: - type: integer - type: string - type: 'null' 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 min_avid_cnt: anyOf: - type: integer - type: string - type: 'null' title: Min Avid Cnt description: 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: 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: 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: 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: - $ref: '#/components/schemas/UpperHonorFilter' - type: 'null' description: >- 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: >- 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: >- 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: - type: array items: type: string - type: 'null' title: Special Tags description: Feature-tag values from /api/v1/bilibili/huahuo/square_static_info spark_tag: anyOf: - type: array items: type: string - type: 'null' 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 square_tag_in: anyOf: - type: array items: type: string - type: 'null' title: Square Tag In description: 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: >- 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: 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: >- 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: >- 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: >- 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: '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: 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: >- 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: >- 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: 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: 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: '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: 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: 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: >- 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: 'Boosting-status filter: 1=currently boosting, 0=all' is_treasure_up: anyOf: - type: integer - type: string - type: 'null' title: Is Treasure Up description: Whether to filter for treasure creators is_timely_response: anyOf: - type: integer - type: string - type: 'null' title: Is Timely Response description: Whether to require timely-response creators is_new_enter: anyOf: - type: integer - type: string - type: 'null' title: Is New Enter description: 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: Whether to filter for X Plan preferred creators high_potential_type: anyOf: - type: integer - type: 'null' title: High Potential Type description: 'High-potential type: 0=all, 1=onboarded, 2=not onboarded' 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: anyOf: - type: string - type: 'null' title: Request Id description: Unique request identifier 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: anyOf: - type: string - type: 'null' title: Docs description: Link to the API Swagger documentation for this endpoint cache_message: anyOf: - type: string - type: 'null' 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. cache_message_zh: anyOf: - type: string - type: 'null' 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. cache_url: anyOf: - type: string - type: 'null' title: Cache Url description: The URL to access the cached result 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: anyOf: - {} - type: 'null' title: Data description: The response data type: object title: ResponseModel UpperPriceFilter: properties: cooperation_type: anyOf: - type: integer - type: string - type: 'null' 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 creative_skill: anyOf: - items: type: integer type: array - type: 'null' 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 include_content: anyOf: - items: type: integer type: array - type: 'null' 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 price_min: anyOf: - type: integer - type: number - type: string - type: 'null' 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 price_max: anyOf: - type: integer - type: number - type: string - type: 'null' 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 price_right: anyOf: - type: array items: type: string - type: 'null' 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. additionalProperties: true type: object title: UpperPriceFilter description: Quote filter for a cooperation format. UpperHonorFilter: properties: honor_type: anyOf: - type: array items: type: string - type: 'null' title: Honor Type description: 'Multi-select honor types: HOT, MZBK, and QZPHB' time_period: anyOf: - type: integer - type: 'null' title: Time Period description: 'Time period: 0=all, or the most recent 30, 90, or 180 days' honor_count: anyOf: - type: integer - type: 'null' title: Honor Count description: 'Honor count: 0=all, 1=once, 2=twice, 3=three or more' 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 ````