100 free credits. No credit card required

TikTok Profile API

Name: TikTok Profile API
Brand: SocialCrawl
Availability: InStock

Scrape TikTok Profile data with one API call. Returns public profile information for a TikTok user: follower count, following count, total likes, bio, avatar URL, and verification status. `author.followers` is the unrounded integer when the source exposes it. When only the public rounded figure is available, the same integer field is returned and `author.ext.followers_approximate` is true. Pass either `handle` or `user_id`. Profiles behind TikTok's 'audience controls' (a login/age wall in the browser) now return their profile record normally; their posts are readable through `/v1/tiktok/profile/videos` with the same handle. A profile with no publicly readable record still returns `404 RESOURCE_NOT_FOUND` with `error.details.reason` set to `account_private`. A handle the platform reports as unused returns the same status with `reason` set to `account_gone`; because TikTok numeric ids are permanent, re-running the lookup with `user_id` tells a renamed account from a removed one.

Last updated August 2026Maintained by the SocialCrawl team

Start for free View Documentation

Returns a TikTok account's public profile: display name, bio, follower count on author.followers (or the rounded figure with author.ext.followers_approximate), likes, verification, and user id.

Use it when you have a handle and want a quick snapshot of an account before pulling its videos or followers.

Try the TikTok Profile API

See real data before writing a single line

GET/v1/tiktok/profile

Searching 51 platforms in parallel

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·Apple Music·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·Utility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·Apple Music·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·Utility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·Apple Music·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·Utility·

Universal Search

TikTok·

Instagram·

YouTube·

Facebook·

X·

LinkedIn·

Reddit·

Threads·

Pinterest·

Twitch·

Truth Social·

Snapchat·

Kick·

Bluesky·

Kwai·

Rumble·

Spotify·Apple Music·

TikTok Shop·

Amazon Shop·

Google Shopping·

Trustpilot·

TripAdvisor·

Linktree·

Komi·

Pillar·

lnk.bio·

Facebook Ads·

Google Ads·

LinkedIn Ads·

Google Search·

Google News·

Google Finance·

Polymarket·

Tavily·

Hacker News·

GitHub·

Perplexity·

Naver·Utility·

Universal Search

TikTok API

What can you do with the Profile API?

The Profile endpoint gives you structured TikTok data with computed fields in a single request. No scraping infrastructure to build or maintain.

Example Request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://www.socialcrawl.dev/v1/tiktok/profile"

import requests

response = requests.get(
    "https://www.socialcrawl.dev/v1/tiktok/profile",
    headers={"x-api-key": "YOUR_API_KEY"},
)

data = response.json()

const response = await fetch(
  "https://www.socialcrawl.dev/v1/tiktok/profile",
  {
    headers: { "x-api-key": "YOUR_API_KEY" },
  },
);

const data = await response.json();

Parameters

Parameter	Required	Description
handle	No	TikTok username without the @ symbol.
user_id	No	TikTok numeric user ID. Use this for faster responses.

Example Response

What does the TikTok Profile API return?

Every response follows one unified schema. Here is a real, unmodified response body, so you can see the exact fields you get back before spending a credit.

Example response

{
  "success": true,
  "platform": "tiktok",
  "endpoint": "/v1/tiktok/profile",
  "data": {
    "author": {
      "id": "6917704832925746181",
      "username": "duolingo",
      "display_name": "Duolingo",
      "avatar_url": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/6b2beff1167b40574fcd2ea2caf1444d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=f3757781&x-expires=1784674800&x-signature=9OCuBINSoeHVQPclR1XuqeA1j%2FE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5",
      "bio": "hot owl summer  🔥🦉",
      "verified": true,
      "followers": 17100000,
      "following": 310,
      "posts_count": 1129,
      "likes_count": 482200000,
      "url": null,
      "private": false,
      "joined_at": null
    },
    "computed": {
      "engagement_rate": null,
      "language": null,
      "content_category": "other",
      "estimated_reach": null
    },
    "_warnings": [
      "computed.engagement_rate: author ratio exceeded 1.0 (raw: 28.19883); returned null — a lifetime likes/followers ratio is not a real engagement rate"
    ]
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req-8Kq2ZmR4vT9xLb3P",
  "cached": false
}

Live sample illustrating the unified response shape. Field values reflect the record you query.

API Details

How does the TikTok Profile API work?

Send a GET request with your API key and get back clean, structured JSON in our unified schema. Supported computed fields are populated when the source provides the required inputs.

Method

GET

Response

JSON

Why SocialCrawl

Why use SocialCrawl for TikTok Profile data?

We handle the complexity of TikTok data extraction so you can focus on building. Unified schema, AI enrichment, and zero platform logic in your code.

One schema for every platform, so you write your integration once
When an endpoint supports a computed field and the required source inputs are available, normalized records can include fields such as engagement rate, reach, category, and language
No scraping infrastructure to build, no proxies to manage, no rate limits to fight
Current public TikTok data, with the endpoint's documented cache window and 0-credit hits; send Cache-Control: no-cache for a billed refresh

Developer First

How do you scrape social media data in seconds?

The fastest social media scraping API for developers. Scrape profiles, posts, comments, and analytics from 51 platforms covering 10B+ monthly active users.

One schema, every platform

Query 51 platforms with identical response structures. Write your integration once.

Computed fields, not just scraped

When an endpoint supports these metrics and the source provides the required inputs, the normalized record includes engagement_rate, estimated_reach, content_category, and language. Ready to use.

See your data before you code

Visual Data Explorer. Paste any URL, get rich result cards, sortable tables, CSV export.

import requests

response = requests.get(
    'https://www.socialcrawl.dev/v1/tiktok/profile',
    params={'handle': 'charlidamelio'},
    headers={'x-api-key': 'sc_YOUR_API_KEY'}
)
data = response.json()

[ .JSON ]

{
  "success": true,
  "platform": "tiktok",
  "data": {
    "author": {
      "username": "charlidamelio",
      "followers": 152400000
    },
    "engagement": {
      "likes": 12400000000,
      "engagement_rate": 0.087
    },
    "metadata": {
      "language": "en",
      "content_category": "lifestyle"
    }
  }
}

+ 51 platforms

FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

How do I get TikTok profile data with an API?

Send a GET request to /v1/tiktok/profile with the handle parameter (no @ symbol). SocialCrawl returns structured JSON with follower count, following count, total likes, bio, avatar URL, verification status, and AI-computed engagement rate.

What data does the TikTok Profile API return?

The endpoint returns public profile fields: follower count, following count, total likes, bio text, avatar URL, verification status, user id, handle, display name, and SocialCrawl's computed engagement_rate.

How much does the TikTok Profile API cost?

Each request costs 1 credit on the standard tier. New accounts get 100 free credits with no credit card required, so you can pull around 100 TikTok profiles before paying anything.

Is scraping TikTok profiles legal?

SocialCrawl reads only publicly visible profile fields, the same data anyone sees when visiting the user's TikTok page. Make sure your use case complies with TikTok's terms of service and applicable data protection laws.

Can I use the TikTok Profile API in production?

Yes. The endpoint uses the profile cache category with consistent sub-second response times after the first request, upstream retry handling, and a unified schema that does not break when TikTok updates their UI.

Does the TikTok Profile API return the exact follower count?

Yes. GET /v1/tiktok/profile returns author.followers as an unrounded integer when the source exposes one, not an abbreviated string such as 4.4M. If only the public rounded figure is available, the same integer field is returned and author.ext.followers_approximate is true.

Ask AI about SocialCrawl

Ask ChatGPT Ask Perplexity Ask Gemini Ask Claude Ask Grok

Live data & statistics

Real, dated numbers computed from this API and refreshed automatically.

How Many Followers Do You Need to Get Paid on TikTok?

More TikTok API endpoints

Every TikTok endpoint returns the same unified schema.

Profile Videos Post Post Comments Video Comment Replies Comment Search

API reference TikTok API guide Code tutorial

Ready to scrape TikTok Profile data?

Get your API key and start pulling TikTok data in under 60 seconds.

Start for free

🤖 AI agent or LLM? Read this page as markdown