TikTok User Profile Detail API
Get a public profile from its handle: name, bio, followers, following, total likes, video count and verified status.
- 1 credit per call
- Failed calls are free
- Updated
- tiktok.profile.get
{ "display_name": "TikTok", "followers": 96100000, "likes": 465100000, "bio": "Your next discovery is waiting on TikTok.", "following": 1, "profile_url": "https://www.tiktok.com/@tiktok", "user_id": "107955", "verified": true, "video_count": 1510}
What you send
The input
object of the request, with every field the endpoint accepts.
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
| handle | string | yes | The account's handle, such as tiktok, with or without @. | tiktok |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| display_name | string | The account's display name. | TikTok |
| bio | string | The profile's bio text. | Your next discovery is waiting on TikTok. |
| followers | integer | Followers, as TikTok shows them. | 96,100,000 |
| following | integer | How many accounts it follows. | 1 |
| likes | integer | Likes across the account's videos, as TikTok shows them. | 465,100,000 |
| video_count | integer | How many videos the account has posted. | 1510 |
| verified | boolean | Whether TikTok shows the account as verified. | true |
| profile_url | string | Link to the profile. | https://www.tiktok.com/@tiktok |
| user_id | string | TikTok's ID for the account. | 107955 |
Call it from your code, or ask your agent
Set UPSCRAPE_API_KEY to your key and copy a working request.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "tiktok.profile.get", "input": { "handle": "tiktok" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "tiktok.profile.get", "input": { "handle": "tiktok" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "tiktok.profile.get", "input": { "handle": "tiktok" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
Use Upscrape to look up TikTok's own account (@tiktok). How many followers, total likes and videos does it have?
More from the TikTok API
- TikTok User Videos API1 credit
- TikTok Video Detail API1 credit
- TikTok Video Comments API1 credit
- TikTok Comment Replies API1 credit
- TikTok Keyword Video Search API1 credit
- TikTok Top Search Results API1 credit
- TikTok Hashtag Videos API1 credit
- TikTok Video Transcript API1 credit
- TikTok Shop Product Detail API1 credit
- TikTok Shop Product Search API1 credit
- TikTok Shop Store Products API1 credit
- TikTok Shop Product Reviews API1 credit
- TikTok Song Detail API1 credit
- TikTok Song Videos API1 credit
- TikTok Collection Videos API1 credit
- TikTok Trending Feed API1 credit
- TikTok Suggestions Search API1 credit
- TikTok User Live Status API1 credit
- TikTok Live Room Detail API1 credit
- TikTok User Followers API1 credit
- TikTok User Following API1 credit
The same data from other platforms
TikTok User Profile Detail API FAQ
The short answers. The docs have the long ones.
How much does the TikTok User Profile Detail API cost?
1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.
What do I send?
Send handle. The input fields below list every option with its type and limits.
Do I need a TikTok login?
No. It reads public TikTok data; nothing runs on your account.
Can my AI agent call it?
Yes, over MCP: the agent finds tiktok.profile.get, checks its price and runs it with the same credits as the REST API.
Your first TikTok call is free.
Up to 100 free credits to start, no card needed.