> ## 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 live creators

> Search live creators

Search live creators

**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_live_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_live_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_live_upper:
    post:
      tags:
        - TikHub - Bilibili
      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:
          title: Nickname Or Mids
          description: Search by creator nickname or UID
          nullable: true
          type: string
        mids:
          title: Mids
          description: Batch exact match by UID
          nullable: true
          items:
            type: integer
          type: array
        is_brand_live:
          title: Is Brand Live
          description: >-
            Live stream type: 1=Content live stream, 0=Commerce live stream.
            Available filters differ between the two types.
          nullable: true
          type: integer
        gender:
          title: Gender
          description: Anchor gender
          nullable: true
          type: string
        region_id:
          title: Region Id
          description: Anchor primary residence region (level 1)
          nullable: true
          items:
            type: integer
          type: array
        second_region_id:
          title: Second Region Id
          description: Anchor primary residence region (level 2)
          nullable: true
          items:
            type: integer
          type: array
        min_fans_num:
          title: Min Fans Num
          description: Minimum follower count
          nullable: true
          type: integer
        max_fans_num:
          title: Max Fans Num
          description: Maximum follower count
          nullable: true
          type: integer
        fans_gender_tag:
          title: Fans Gender Tag
          description: Audience gender tag
          nullable: true
          items:
            type: string
          type: array
        fans_age_tag:
          title: Fans Age Tag
          description: Audience age tag
          nullable: true
          items:
            type: string
          type: array
        fans_region_tag:
          title: Fans Region Tag
          description: Audience region tag
          nullable: true
          items:
            type: string
          type: array
        live_subarea_id:
          title: Live Subarea Id
          description: Live area (second-level); see live_area_list for values
          nullable: true
          items:
            type: integer
          type: array
        partition_id:
          title: Partition Id
          description: Submission category (level 1)
          nullable: true
          type: integer
        second_partition_id:
          title: Second Partition Id
          description: Submission category (level 2)
          nullable: true
          items:
            type: integer
          type: array
        min_popularity:
          title: Min Popularity
          description: Minimum average peak popularity per session in the last 30 days
          nullable: true
          type: integer
        max_popularity:
          title: Max Popularity
          description: Maximum average peak popularity per session in the last 30 days
          nullable: true
          type: integer
        live_audience_h_avg_30d_min:
          title: Live Audience H Avg 30D Min
          description: Minimum average hourly viewer count in the last 30 days
          nullable: true
          type: integer
        live_audience_h_avg_30d_max:
          title: Live Audience H Avg 30D Max
          description: Maximum average hourly viewer count in the last 30 days
          nullable: true
          type: integer
        live_danmu_h_avg_30d_min:
          title: Live Danmu H Avg 30D Min
          description: Minimum average hourly danmaku count in the last 30 days
          nullable: true
          type: integer
        live_danmu_h_avg_30d_max:
          title: Live Danmu H Avg 30D Max
          description: Maximum average hourly danmaku count in the last 30 days
          nullable: true
          type: integer
        live_guild_id:
          title: Live Guild Id
          description: Live streaming guild; see live_guild_drop for values
          nullable: true
          items:
            type: integer
          type: array
        high_potential_type:
          title: High Potential Type
          description: Registration status
          nullable: true
          type: integer
        live_good_category:
          title: Live Good Category
          description: >-
            Primary commerce category; 0=all; valid values from
            live_good_category
          nullable: true
          type: integer
        live_good_gmv:
          title: Live Good Gmv
          description: 90-day GMV tier, 0=all
          nullable: true
          type: integer
        order_by:
          title: Order By
          description: Sort field
          nullable: true
          type: string
        sort:
          title: Sort
          description: 'Sort direction: desc or asc'
          nullable: true
          type: string
        page:
          title: Page
          description: Page number starting from 1; 20 items per page
          nullable: true
          type: integer
          minimum: 1
      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:
          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
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: AIsa API key. Get yours at https://aisa.one

````