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

# Get User Profile

> Full TikTok user profile by @handle (stats, verification, links, avatars).

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


## OpenAPI

````yaml GET /v1/tiktok/users/{username}
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/users/{username}:
    get:
      tags:
        - TikTok Users
      summary: Get User Profile
      description: >-
        Full TikTok user profile by @handle (stats, verification, links,
        avatars).
      operationId: getTikTokUser
      parameters:
        - name: username
          in: path
          required: true
          schema:
            type: string
          description: The user's @handle (unique_id), without the leading '@'.
        - 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.
      responses:
        '200':
          description: User profile
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProfileResponse'
              example:
                user:
                  id: '6784129854561813509'
                  sec_uid: MS4wLjABAAAA...
                  unique_id: charlidamelio
                  nickname: charli d'amelio
                  signature: no bio yet
                  bio_link: null
                  verified: true
                  verify_reason: null
                  private_account: false
                  is_commerce_account: false
                  region: US
                  language: en
                  avatar_thumb: https://p16-sign.tiktokcdn-us.com/avatar.jpeg
                  avatar_larger: https://p16-sign.tiktokcdn-us.com/avatar_larger.jpeg
                  stats:
                    follower_count: 155600000
                    following_count: 1300
                    heart_count: 11800000000
                    video_count: 2700
                    digg_count: 12000
                    friend_count: 1200
                  is_live: false
                  create_time_utc: 1531234567
                  create_time_at: '2018-07-10T12:16:07Z'
                  profile_url: https://www.tiktok.com/@charlidamelio
                region: US
components:
  schemas:
    ProfileResponse:
      type: object
      properties:
        user:
          $ref: '#/components/schemas/TikTokUser'
        region:
          type: string
      required:
        - user
        - region
    TikTokUser:
      type: object
      properties:
        id:
          type: string
        sec_uid:
          type: string
          description: Secure user id — needed to call list endpoints.
        unique_id:
          type: string
          description: The @handle.
        nickname:
          type: string
        signature:
          type: string
          description: Bio text.
        bio_link:
          type: string
          description: External link in bio.
        verified:
          type: boolean
        verify_reason:
          type: string
        verification_type:
          type: integer
        private_account:
          type: boolean
        is_commerce_account:
          type: boolean
        is_seller:
          type: boolean
          description: TikTok Shop seller.
        is_organization:
          type: boolean
        original_musician:
          type: boolean
        is_star:
          type: boolean
        region:
          type: string
        language:
          type: string
        ins_id:
          type: string
        twitter_name:
          type: string
        youtube_channel_title:
          type: string
        avatar_thumb:
          type: string
        avatar_medium:
          type: string
        avatar_larger:
          type: string
        stats:
          $ref: '#/components/schemas/TikTokUserStats'
        open_favorite:
          type: boolean
        comment_setting:
          type: integer
        duet_setting:
          type: integer
        stitch_setting:
          type: integer
        download_setting:
          type: integer
        following_visibility:
          type: integer
        is_live:
          type: boolean
        room_id:
          type: string
        commerce_category:
          type: string
        commerce_user_level:
          type: integer
        with_shop_entry:
          type: boolean
        create_time_utc:
          type: integer
          description: Account creation Unix timestamp.
        create_time_at:
          type: string
          description: Account creation ISO 8601 UTC.
        profile_url:
          type: string
      description: A full TikTok user profile.
    TikTokUserStats:
      type: object
      properties:
        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.
        friend_count:
          type: integer
      description: Aggregate counts for a user profile.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````