Social Fetch
Get API key
TikTok hub

TikTok Profile API

Look up a public TikTok account by handle and get a structured profile card plus follower metrics in the shared Social Fetch JSON envelope.

GET /v1/tiktok/profiles/{handle}

1 credit per successful request.

Try in playgroundFull API docs

About this endpoint

Creator databases, outreach tools, and monitoring jobs usually start with a handle and need a stable identity card: display name, bio, avatar, verification, and follower counts. Scraping the profile page yourself means chasing signed requests and region quirks every time TikTok changes the client.

`GET /v1/tiktok/profiles/{handle}` takes a TikTok handle (with or without a leading `@`) and returns the shared envelope. On a successful public lookup you get `data.profile` (handle, displayName, bio, avatarUrl, verified, profileUrl, privateAccount, and related public fields) plus `data.metrics` (followers, following, likes, posts). Branch on `data.lookupStatus` before you write rows: `found`, `not_found`, and `private` are explicit outcomes, not an empty 200 that looks like a deleted account.

Common uses: seed a creator graph node, refresh follower totals on a schedule, gate enrichment (videos, followers lists, Shop) behind a profile that actually exists, or fan out the same handle pattern next to Instagram and X on one API key. Pricing is on the credit badge for this operation; bill from `meta.creditsCharged`. on every response.

TikTok Profile API FAQ

How do I get a TikTok profile by handle via API?

Call `GET /v1/tiktok/profiles/{handle}` with your Social Fetch API key (`x-api-key`). Pass the TikTok username as the path parameter, with or without a leading `@`. Read `data.lookupStatus`, then `data.profile` and `data.metrics` when the account is available.

How much does the TikTok Profile API cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth.

What does the TikTok Profile API return?

A structured profile card under `data.profile` (handle, display name, bio, avatar URLs, verification, profile URL, private-account flag, and related public fields) plus `data.metrics` (followers, following, likes, posts). The response also includes `data.lookupStatus`, `meta.requestId`, and `meta.creditsCharged`.

What happens if the TikTok handle does not exist or is private?

`data.lookupStatus` tells you. `not_found` means no public profile matched. `private` means the account is private; you may still receive limited profile and metrics fields. Always branch on `lookupStatus` before treating the row as a full public card.

Do I need TikTok OAuth to fetch a profile?

No. You authenticate to Social Fetch with an API key. The route reads public profile data; it does not act on behalf of a logged-in TikTok user.

How is this different from listing a profile's videos?

This route returns the identity card and aggregate metrics for one handle. Recent uploads are `GET /v1/tiktok/profiles/{handle}/videos`. Call the profile route first when you need an explicit `lookupStatus` before interpreting an empty video list.

Can I use the TikTok Profile API in a creator database?

Yes. Teams use it to upsert creator rows (followers, bio, verification) and to confirm a handle exists before spending credits on videos, followers lists, audience, or Shop routes. The same envelope shape works next to Instagram and X profile lookups on one key.

Other TikTok endpoints