TikTok User API

Fetch any public TikTok profile, follower and following lists, and account stats as clean JSON - no scraper to maintain, no TikTok login.

One TikTok User API for profiles, audiences, and content

If you are building anything that depends on TikTok creator data - an influencer marketing platform, a competitor monitoring dashboard, a fraud-detection model, or an internal reporting tool - you need a single, reliable way to read public profile data without scraping the site yourself. The TikLiveAPI user endpoints give you exactly that: resolve a username to its numeric ID, pull a full profile with live follower and like counts, page through a creator's videos, and walk their follower and following graphs. Every response is real-time public data returned as clean JSON, so you never touch headless browsers, login sessions, or watermark stripping. Profiles are one part of the hosted TikTok scraper, which also covers videos, comments, hashtags and sounds.

This is a pay-as-you-go service. New accounts get 100 free credits on signup, credits never expire, and you authenticate every request with a single X-Api-Key header sent to https://api.tikliveapi.com. No TikTok account or password is ever required - the API reads only public data.

What you can pull from a TikTok profile

Resolve a username to a user ID

Send a username to /userid/ and get back the numeric user ID. Most other user endpoints key off this numeric ID, so this is usually your first call when all you have is a handle.

Full profile by username

/userinfo-by-username/ returns the complete profile in one call: nickname, bio, avatar URLs, verified status, secUid, account creation time (createTime), plus a stats block with followerCount, followingCount, heartCount, and videoCount.

Full profile by user ID

Already storing numeric IDs? /userinfo-by-id/ takes a userid and returns the same rich profile and stats object, so you can refresh saved accounts without re-resolving handles.

A creator's video feed

/user-posts/ lists a user's public videos with play and cover URLs, duration, music info, and per-video stats (play_count, digg_count, comment_count, share_count) so you can measure output and reach.

Follower list

/user-followers/ returns follower profiles - unique_id, nickname, region, follower_count, following_count, and verified flag - ideal for audience analysis and authenticity checks.

Following list

/user-following/ returns every account a creator follows, with the same profile fields, so you can map interests, partnerships, and network connections.

Search users by keyword

/search-user/ takes a keyword and returns matching user profiles with their stats, the fastest way to discover creators in a niche or find a competitor by name.

Quick start

Authenticate with your API key in the X-Api-Key header and call any endpoint over plain HTTPS. Here is a complete request that fetches the TikTok profile by username:

curl "https://api.tikliveapi.com/userinfo-by-username/?username=tiktok" \
  -H "X-Api-Key: YOUR_API_KEY"

The response includes the profile object and a stats block. Trimmed to the key fields:

{
  "user": {
    "id": "107955",
    "uniqueId": "tiktok",
    "nickname": "TikTok",
    "signature": "Your next discovery is waiting on TikTok.",
    "verified": true,
    "secUid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM",
    "privateAccount": false
  },
  "stats": {
    "followingCount": 1,
    "followerCount": 95951715,
    "heartCount": 464729186,
    "videoCount": 1593
  }
}

That single call gives you the live follower count, total likes (heartCount), video count, verification status, and the secUid you can reuse elsewhere - no parsing of HTML, no rate-limited mobile endpoints, no maintenance. Collecting profiles in bulk rather than one at a time? The guide to bulk profile scraping workflows covers follower-list audits, creator discovery and daily snapshots.

What is secUid and how do you get it?

secUid is TikTok's secure user identifier: a long opaque string (it typically begins with MS4wLjABAAAA) that stays the same when the owner changes their username. The handle - uniqueId, the part after the @ - belongs to the owner and can be changed at any time, which makes it a poor key for anything you store. The secUid and the numeric id are the stable references, and many TikTok tools ask for a secUid rather than a handle.

Getting it takes one call: send the username to /userinfo-by-username/, as in the quick start above, and read user.secUid from the response. Trimmed to the identifiers:

{
  "user": {
    "id": "107955",
    "uniqueId": "tiktok",
    "secUid": "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM"
  }
}

The same value comes back as user.secUid from /userinfo-by-id/ and in every /search-user/ result, and as sec_uid on each account in follower and following lists and on every comment author. You never need a secUid to call TikLiveAPI itself: every documented endpoint is keyed by the username or the numeric user ID. Store the secUid next to the id as a stable reference, or hand it to other tools that expect one.

Common use cases

Influencer discovery and vetting

Combine /search-user/ with /userinfo-by-username/ to find creators in a niche and read their follower count, engagement signals, and verified status in the same pass. This is the backbone of any influencer discovery tool built on the TikTok API.

Competitor monitoring at scale

Store competitor user IDs, then poll /userinfo-by-id/ and /user-posts/ on a schedule to track follower growth, posting cadence, and which videos break out - the data model behind a competitor-monitoring dashboard.

Fake-follower and audience-quality checks

Pull a sample of an account's followers with /user-followers/ and inspect fields like follower_count, following_count, and aweme_count to score audience authenticity and flag bot-heavy accounts programmatically.

Interest and network graphs

Use /user-following/ to map who a creator follows, revealing collaborations, brand affinities, and community clusters that feed recommendation and partnership models.

Engagement-rate reporting

Pair profile stats with per-video metrics from /user-posts/ to compute real engagement rates that go beyond a naive likes-over-followers ratio, then surface them in client-facing reports.

Start building with 100 free credits

Create an account to get 100 free credits, generate an API key, and test every user endpoint live in the interactive playground before you write a line of integration code. Pay only for what you call, and your credits never expire.

Key facts

  • Base URL and authentication: send requests to https://api.tikliveapi.com with your API key in the X-Api-Key header.
  • Credits: 1 successful request = 1 credit; failed requests don't use credits.
  • No expiry: credits never expire, and there are no monthly plans.
  • Free credits: 100 free credits on signup.
  • Rate limit: the standard rate limit is 200 requests per minute per API key.
  • Errors: a missing or invalid API key returns a JSON object with a message field and HTTP status 200, so check the response body rather than relying on the status code.
  • Data handling: data is fetched live from TikTok and passed straight to you; TikLiveAPI does not store or cache it.
  • Payment: crypto via Cryptomus. Card payments are temporarily unavailable.

Frequently Asked Questions

How do I authenticate requests to the TikTok User API?

Send your API key in the X-Api-Key request header to https://api.tikliveapi.com on every call. No TikTok account, login, or password is ever required because the API only reads public data. New accounts receive 100 free credits on signup, and credits never expire.

How do I get a user ID from a TikTok username?

Call /userid/ with the username parameter and the response returns the numeric id, for example {"id": "107955"} for the tiktok account. Most other user endpoints, such as /user-posts/, /user-followers/, and /user-following/, take this numeric userid as their key, so resolving the username first is usually the starting point.

How does pagination work for followers and posts?

Pagination depends on the endpoint. /user-posts/ and /search-user/ use a cursor value you pass back on the next request, while /user-followers/ and /user-following/ page with a time timestamp parameter. Each call also accepts a count parameter to set the page size.

What is the maximum number of results per request?

Limits vary by endpoint. /user-posts/ defaults to 10 and allows up to 35. /user-followers/ and /user-following/ default to 50 and allow up to 200. /search-user/ defaults to 10 and allows up to 30. For larger datasets, keep calling the endpoint with the returned cursor or time value.

Does the user info response include follower and like counts?

Yes. /userinfo-by-username/ and /userinfo-by-id/ return a stats block containing followerCount, followingCount, heartCount (total likes), and videoCount, alongside profile fields like nickname, bio (signature), verified status, and secUid. The data is real-time public profile data.

What is a TikTok secUid and how do I find it?

secUid is TikTok's secure user identifier, a long string (it typically begins with MS4wLjABAAAA) that stays the same when the owner changes their username. To find it, call /userinfo-by-username/ with the handle and read user.secUid; it also appears in /userinfo-by-id/ and /search-user/ results, and as sec_uid in follower lists and on comment authors. TikLiveAPI endpoints never require it as input - they take the username or the numeric user ID.

Start building with real-time TikTok data today.

Credit packages from $9.90 for 100,000 requests. Start with 100 free credits.