> ## Documentation Index
> Fetch the complete documentation index at: https://scrapebadger-feat-flights-booking-options.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Users

> Search TikTok users by keyword.

<Note>
  Each request costs **5 credits**. Failed requests are not charged.
</Note>


## OpenAPI

````yaml GET /v1/tiktok/search/users
openapi: 3.1.0
info:
  title: ScrapeBadger TikTok API
  version: 1.0.0
  description: >-
    TikTok scraping API for user profiles, videos, comments, transcripts,
    hashtags, music/sounds, search, trending, and the EU Commercial Content (ad
    transparency) library. Returns clean structured JSON; handles signing,
    anti-bot bypass, and regional proxy routing automatically.
servers:
  - url: https://scrapebadger.com
    description: Production
security:
  - apiKeyAuth: []
paths:
  /v1/tiktok/search/users:
    get:
      tags:
        - TikTok Search
      summary: Search Users
      description: Search TikTok users by keyword.
      operationId: searchTikTokUsers
      parameters:
        - name: query
          in: query
          required: true
          schema:
            type: string
          description: Search keyword.
        - name: region
          in: query
          schema:
            type: string
            default: US
          description: >-
            Content region (ISO 3166-1 alpha-2). Routes the request through a
            proxy and signer for that locale.
        - name: count
          in: query
          schema:
            type: integer
            default: 20
            minimum: 1
            maximum: 50
          description: Maximum number of items to return (1-50).
        - name: cursor
          in: query
          required: false
          schema:
            type: string
          description: >-
            Pagination cursor — pass the `pagination.cursor` value from a prior
            response to fetch the next page. Omit for the first page. It is an
            opaque composite token.
      responses:
        '200':
          description: User search results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserSearchResponse'
              example:
                users:
                  - id: '6784129854561813509'
                    sec_uid: MS4wLjABAAAA...
                    unique_id: charlidamelio
                    nickname: charli d'amelio
                    avatar_thumb: https://p16-sign.tiktokcdn-us.com/avatar.jpeg
                    signature: no bio yet
                    verified: true
                    follower_count: 155600000
                    following_count: 1300
                    heart_count: 11800000000
                    video_count: 2700
                    region: US
                pagination:
                  has_more: true
                  cursor: '30'
                  count: 30
                  search_id: null
                region: US
components:
  schemas:
    UserSearchResponse:
      type: object
      properties:
        users:
          type: array
          items:
            $ref: '#/components/schemas/TikTokAuthor'
        pagination:
          $ref: '#/components/schemas/TikTokCursorPage'
        region:
          type: string
      required:
        - region
    TikTokAuthor:
      type: object
      properties:
        id:
          type: string
          description: Numeric user id.
        sec_uid:
          type: string
          description: Secure user id (sec_uid) used for downstream list calls.
        unique_id:
          type: string
          description: The @handle.
        nickname:
          type: string
          description: Display name.
        avatar_thumb:
          type: string
        avatar_medium:
          type: string
        avatar_larger:
          type: string
        signature:
          type: string
          description: Bio text.
        verified:
          type: boolean
        private_account:
          type: boolean
        follower_count:
          type: integer
        following_count:
          type: integer
        heart_count:
          type: integer
          description: Total likes received.
        video_count:
          type: integer
        digg_count:
          type: integer
          description: Likes given.
        region:
          type: string
        verify_reason:
          type: string
        verification_type:
          type: integer
        account_region:
          type: string
        language:
          type: string
        original_musician:
          type: boolean
        is_star:
          type: boolean
        ins_id:
          type: string
          description: Linked Instagram handle.
        twitter_name:
          type: string
        youtube_channel_title:
          type: string
        room_id:
          type: string
          description: Non-empty while the user is live.
        commerce_user_level:
          type: integer
        with_shop_entry:
          type: boolean
      description: Author summary embedded in a video, comment, or search result.
    TikTokCursorPage:
      type: object
      properties:
        has_more:
          type: boolean
          description: True when more pages are available.
        cursor:
          type: string
          description: Opaque cursor; pass back as ?cursor= for the next page.
        count:
          type: integer
          description: Number of items in this page.
        search_id:
          type: string
          description: Search endpoints chain rid → search_id across pages.
      description: Cursor pagination metadata shared by all list endpoints.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````