TikTok User Profile API

Endpoint

GET /v1/tiktok/user

Parameters

username

TikTok username, with or without leading @ (max 100 characters). Provide exactly one of username, user_id, or url.

user_id

Numeric TikTok user ID, as returned by Search Users. Provide exactly one of username, user_id, or url.

url

TikTok profile URL, e.g. https://www.tiktok.com/@tiktok (max 500 characters). Provide exactly one of username, user_id, or url.

Response fields

user

Profile data object

username

TikTok username (unique ID)

nickname

Display name

user_id

TikTok user ID

sec_uid

TikTok secondary user ID (secUid)

bio

Profile bio / signature

bio_link

Link displayed on the profile, or empty string

verified

Whether the user is verified

is_private

Whether the account is private

followers

Number of followers

following

Number of accounts followed

likes

Total likes received

video_count

Number of videos posted

videos_liked

Number of videos the user has liked (0 when their liked list is private)

avatar

URL to profile picture

avatar_hd

URL to high-resolution profile picture

date_joined

Date and time the account was created

date_joined_timestamp

Unix timestamp of the account creation date, or null

instagram_username

Linked Instagram username, or empty string

twitter_id

Linked X/Twitter account ID, or empty string

youtube_channel_id

Linked YouTube channel ID, or empty string

youtube_channel_title

Linked YouTube channel name, or empty string

url

Link to the profile

Example Request

curl "https://apidirect.io/v1/tiktok/user?username=gordonramsayofficial" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/tiktok/user",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"username": "gordonramsayofficial"}
)
print(response.json())

Example Response

{
  "user": {
    "username": "gordonramsayofficial",
    "nickname": "Gordon Ramsay",
    "user_id": "6747935906352907269",
    "sec_uid": "MS4wLjABAAAAv3zolJLlWp-WbKXqSZwVSflDdwcbjPADRG-dhb68k30dQjkFpkRs4HiMvWeeIyVv",
    "bio": "I cook sometimes too.....",
    "bio_link": "GordonRamsay.com/",
    "verified": true,
    "is_private": false,
    "followers": 40817126,
    "following": 573,
    "likes": 728577233,
    "video_count": 839,
    "videos_liked": 0,
    "avatar": "https://p19-common-sign.tiktokcdn-us.com/.../photo.webp",
    "avatar_hd": "https://p19-common-sign.tiktokcdn-us.com/.../photo_1080.webp",
    "date_joined": "2019-10-18 17:42:11",
    "date_joined_timestamp": 1571420531,
    "instagram_username": "",
    "twitter_id": "",
    "youtube_channel_id": "",
    "youtube_channel_title": "",
    "url": "https://www.tiktok.com/@gordonramsayofficial"
  }
}

Frequently asked questions

Can I look up a user by URL or user ID?

Yes. Provide exactly one of username (e.g. tiktok), user_id (e.g. 107955), or url (e.g. https://www.tiktok.com/@tiktok). User IDs are returned by the Search Users endpoint.

Does this work for private accounts?

Yes. Private accounts return their public profile data (username, nickname, bio, follower / following counts, verification status) with is_private set to true.

What happens if the user doesn't exist?

The endpoint returns 404 with code: "not_found". You are not charged for not_found responses.

What are the linked account fields?

instagram_username, twitter_id, youtube_channel_id, and youtube_channel_title are the social accounts the user has linked to their TikTok profile. They are empty strings when no account is linked.

How does pricing work?

You only pay for successful requests. The TikTok User Profile API costs $0.006 per request. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 3 simultaneous requests per endpoint per user. If you need more, just get in touch.