---
title: "Retrieve a TikTok profile"
method: GET
path: "/tiktok/profile/{handler}"
tags: ["TikTok"]
---

# Retrieve a TikTok profile

`GET /tiktok/profile/{handler}`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/tiktok/profile/{handler}`
- Auth: API key in header `x-api-key`

Returns a public TikTok profile by `handler`, the username without the leading `@`. The `user` object has the id, `uniqueId`, nickname, signature, verified and private flags, region, language, avatar, bio link and `secUid`; `stats` has follower, following, heart, video and friend counts. A missing, deleted or banned handle returns 404.

## Path parameters

- `handler` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TiktokProfileResponseDoc
  - `code` integer
  - `data` TiktokProfile
    - `stats` TiktokProfileStats
      - `diggCount` integer: Number of videos the account has liked.
      - `followerCount` integer: Number of accounts that follow this account.
      - `followingCount` integer: Number of accounts this account follows.
      - `friendCount` integer: Number of friends, meaning accounts that follow each other.
      - `heart` integer: Total likes the account's videos have received. Very large totals are rounded.
      - `heartCount` integer: Total likes the account's videos have received. Can be negative for accounts with more than about 2.1 billion likes; use `heart` then.
      - `videoCount` integer: Number of videos the account has posted.
    - `user` TiktokUser
      - `avatarLarger` string: URL of the account's large profile picture.
      - `bioLink` object: Link shown in the account's bio.
        - `link` string
      - `commerceUserInfo` object: Commerce details for the account: whether it is a commerce account and its category.
        - `category` string
        - `commerceUser` boolean
      - `createTime` integer: Time the account was created, in Unix seconds.
      - `id` string: TikTok numeric user id of the account.
      - `isOrganization` integer: Organisation account flag; `1` marks an organisation account.
      - `language` string: Language code set on the account, for example `en`.
      - `nickname` string: Display name of the account.
      - `privateAccount` boolean: Whether the account is private.
      - `region` string: Country or region code of the account, for example `US`.
      - `secUid` string: TikTok secUid of the account. Use it as the `secUid` of the posts endpoint.
      - `secret` boolean: Secret-account flag as TikTok returns it.
      - `signature` string: Bio text shown on the account's profile.
      - `ttSeller` boolean: Whether the account is a TikTok Shop seller.
      - `uniqueId` string: Account handle, the name that follows `@` in the profile URL.
      - `verified` boolean: Whether the account has a verified badge.
  - `msg` string

## Other responses

- `400`: Invalid input
- `404`: Profile not found
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)