Get TikTok Profile

Retrieve public profile information for a TikTok user.

Endpoint

GET /tiktok/profile/:username

Parameters

Path Parameters

Parameter	Type	Required	Description
`username`	string	Yes	The TikTok username (without @)

Request

Headers

Header	Required	Description
`Authorization`	Yes	Bearer token with your API key

Example Request

curl -X GET "https://api.your-domain.com/tiktok/profile/tiktok" \
  -H "Authorization: Bearer YOUR_API_KEY"

const response = await fetch(
  'https://api.your-domain.com/tiktok/profile/tiktok',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const profile = await response.json();

import requests

response = requests.get(
    'https://api.your-domain.com/tiktok/profile/tiktok',
    headers={'Authorization': 'Bearer YOUR_API_KEY'}
)

profile = response.json()

Response

Success Response

Status Code: 200 OK

Returns the TikTok user profile data including statistics and account information.

{
  "userInfo": {
    "user": {
      "id": "107955",
      "uniqueId": "tiktok",
      "nickname": "TikTok",
      "avatarThumb": "https://...",
      "avatarMedium": "https://...",
      "avatarLarger": "https://...",
      "signature": "Make Your Day",
      "verified": true,
      "secUid": "...",
      "privateAccount": false,
      "relation": 0,
      "openFavorite": false
    },
    "stats": {
      "followerCount": 85000000,
      "followingCount": 500,
      "heart": 520000000,
      "heartCount": 520000000,
      "videoCount": 250,
      "diggCount": 1500
    }
  }
}

Response Fields

Field	Type	Description
`userInfo.user.id`	string	Unique TikTok user ID
`userInfo.user.uniqueId`	string	TikTok username
`userInfo.user.nickname`	string	Display name
`userInfo.user.signature`	string	Profile bio
`userInfo.user.verified`	boolean	Whether the account is verified
`userInfo.user.privateAccount`	boolean	Whether the account is private
`userInfo.user.avatarThumb`	string	URL to small profile picture
`userInfo.user.avatarMedium`	string	URL to medium profile picture
`userInfo.user.avatarLarger`	string	URL to large profile picture
`userInfo.stats.followerCount`	number	Number of followers
`userInfo.stats.followingCount`	number	Number of accounts followed
`userInfo.stats.heart`	number	Total likes received
`userInfo.stats.videoCount`	number	Number of videos posted

Error Responses

Status	Description
`400`	Invalid username format
`401`	Invalid or missing API key
`404`	Profile not found
`429`	Rate limit exceeded
`500`	Failed to extract profile data

See Error Handling for detailed error response formats.

Notes

TikTok usernames are case-insensitive. Both TikTok and tiktok will return the same profile.

Private TikTok accounts will return limited statistics. The privateAccount field will be true for these accounts.

Get Profile