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

# User search

> User search

User search

**Pricing** — base \$0.00145 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 "https://api.aisa.one/apis/v1/tikhub/weibo/web_v2/fetch_user_search" \
  -H "Authorization: Bearer YOUR_API_KEY"
```


## OpenAPI

````yaml openapi/tikhub-en.json GET /tikhub/weibo/web_v2/fetch_user_search
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/weibo/web_v2/fetch_user_search:
    get:
      tags:
        - TikHub - Weibo
      summary: User search
      description: User search
      operationId: get_tikhub_weibo_web_v2_fetch_user_search
      parameters:
        - name: query
          in: query
          required: false
          schema:
            description: >-
              Search keyword/Query (if provided, treated as 'all' search; leave
              empty to apply only advanced filter parameters)
            title: Query
            nullable: true
            type: string
          description: >-
            Search keyword/Query (if provided, treated as 'all' search; leave
            empty to apply only advanced filter parameters)
          example: yu7
        - name: page
          in: query
          required: false
          schema:
            type: integer
            description: Page
            default: 1
            title: Page
          description: Page
          example: 1
        - name: region
          in: query
          required: false
          schema:
            description: Region code from /city_list
            title: Region
            nullable: true
            type: string
          description: Region code from /city_list
          example: custom:11:1
        - name: auth
          in: query
          required: false
          schema:
            description: >-
              Auth type: org_vip (organization), per_vip (individual), ord
              (standard)
            title: Auth
            nullable: true
            type: string
          description: >-
            Auth type: org_vip (organization), per_vip (individual), ord
            (standard)
          example: org_vip
        - name: gender
          in: query
          required: false
          schema:
            description: 'Gender: man / women'
            title: Gender
            nullable: true
            type: string
          description: 'Gender: man / women'
          example: man
        - name: age
          in: query
          required: false
          schema:
            description: 'Age bucket: 18y/22y/29y/39y/40y'
            title: Age
            nullable: true
            type: string
          description: 'Age bucket: 18y/22y/29y/39y/40y'
          example: 22y
        - name: nickname
          in: query
          required: false
          schema:
            description: Nickname filter
            title: Nickname
            nullable: true
            type: string
          description: Nickname filter
          example: Zhang San
        - name: tag
          in: query
          required: false
          schema:
            description: Tag filter
            title: Tag
            nullable: true
            type: string
          description: Tag filter
          example: Photography
        - name: school
          in: query
          required: false
          schema:
            description: School filter
            title: School
            nullable: true
            type: string
          description: School filter
          example: Tsinghua University
        - name: work
          in: query
          required: false
          schema:
            description: Company filter
            title: Work
            nullable: true
            type: string
          description: Company filter
          example: ByteDance
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseModel'
components:
  schemas:
    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

````