> ## 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.

# 直播广场搜索

> 直播广场搜索

直播广场搜索

**计费** — 成功调用基准价 \$0.0145（= provider 成本 × 1.45；最终扣费按你的套餐倍率浮动）。仅当上游响应体 `code` 为 `200` 时计费。

## 示例

```bash theme={null}
curl -X POST "https://api.aisa.one/apis/v1/tikhub/bilibili/huahuo/search_live_upper" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'  # 请求体结构见下方 schema
```


## OpenAPI

````yaml openapi/tikhub.json POST /tikhub/bilibili/huahuo/search_live_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_live_upper:
    post:
      tags:
        - Other
      summary: Search live creators
      description: Search live creators
      operationId: post_tikhub_bilibili_huahuo_search_live_upper
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LiveSearchBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
components:
  schemas:
    LiveSearchBody:
      properties:
        nickname_or_mids:
          anyOf:
            - type: string
            - type: 'null'
          title: Nickname Or Mids
          description: Search by creator nickname or UID
        mids:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
          title: Mids
          description: Batch exact match by UID
        is_brand_live:
          anyOf:
            - type: integer
            - type: 'null'
          title: Is Brand Live
          description: >-
            Live stream type: 1=Content live stream, 0=Commerce live stream.
            Available filters differ between the two types.
        gender:
          anyOf:
            - type: string
            - type: 'null'
          title: Gender
          description: Anchor gender
        region_id:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
          title: Region Id
          description: Anchor primary residence region (level 1)
        second_region_id:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
          title: Second Region Id
          description: Anchor primary residence region (level 2)
        min_fans_num:
          anyOf:
            - type: integer
            - type: 'null'
          title: Min Fans Num
          description: Minimum follower count
        max_fans_num:
          anyOf:
            - type: integer
            - type: 'null'
          title: Max Fans Num
          description: Maximum follower count
        fans_gender_tag:
          anyOf:
            - type: array
              items:
                type: string
            - type: 'null'
          title: Fans Gender Tag
          description: Audience gender tag
        fans_age_tag:
          anyOf:
            - type: array
              items:
                type: string
            - type: 'null'
          title: Fans Age Tag
          description: Audience age tag
        fans_region_tag:
          anyOf:
            - type: array
              items:
                type: string
            - type: 'null'
          title: Fans Region Tag
          description: Audience region tag
        live_subarea_id:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
          title: Live Subarea Id
          description: Live area (second-level); see live_area_list for values
        partition_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: Partition Id
          description: Submission category (level 1)
        second_partition_id:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
          title: Second Partition Id
          description: Submission category (level 2)
        min_popularity:
          anyOf:
            - type: integer
            - type: 'null'
          title: Min Popularity
          description: Minimum average peak popularity per session in the last 30 days
        max_popularity:
          anyOf:
            - type: integer
            - type: 'null'
          title: Max Popularity
          description: Maximum average peak popularity per session in the last 30 days
        live_audience_h_avg_30d_min:
          anyOf:
            - type: integer
            - type: 'null'
          title: Live Audience H Avg 30D Min
          description: Minimum average hourly viewer count in the last 30 days
        live_audience_h_avg_30d_max:
          anyOf:
            - type: integer
            - type: 'null'
          title: Live Audience H Avg 30D Max
          description: Maximum average hourly viewer count in the last 30 days
        live_danmu_h_avg_30d_min:
          anyOf:
            - type: integer
            - type: 'null'
          title: Live Danmu H Avg 30D Min
          description: Minimum average hourly danmaku count in the last 30 days
        live_danmu_h_avg_30d_max:
          anyOf:
            - type: integer
            - type: 'null'
          title: Live Danmu H Avg 30D Max
          description: Maximum average hourly danmaku count in the last 30 days
        live_guild_id:
          anyOf:
            - items:
                type: integer
              type: array
            - type: 'null'
          title: Live Guild Id
          description: Live streaming guild; see live_guild_drop for values
        high_potential_type:
          anyOf:
            - type: integer
            - type: 'null'
          title: High Potential Type
          description: Registration status
        live_good_category:
          anyOf:
            - type: integer
            - type: 'null'
          title: Live Good Category
          description: >-
            Primary commerce category; 0=all; valid values from
            live_good_category
        live_good_gmv:
          anyOf:
            - type: integer
            - type: 'null'
          title: Live Good Gmv
          description: 90-day GMV tier, 0=all
        order_by:
          anyOf:
            - type: string
            - type: 'null'
          title: Order By
          description: Sort field
        sort:
          anyOf:
            - type: string
            - type: 'null'
          title: Sort
          description: 'Sort direction: desc or asc'
        page:
          anyOf:
            - type: integer
              minimum: 1
            - type: 'null'
          title: Page
          description: Page number starting from 1; 20 items per page
      additionalProperties: true
      type: object
      title: LiveSearchBody
      description: |-
        Live collaboration marketplace filters. Supports creator attributes,
        audience demographics, live categories, content-live performance,
        commerce categories, and GMV filters. Every field is optional, and
        additional filter fields may be supplied.
    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
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: AIsa API key. Get yours at https://aisa.one

````