> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/tiktok/profiles-handle>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/tiktok/profiles-handle.mdx>

---

# 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}` 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. Bill from `meta.creditsCharged`.

## Request

- **Endpoint:** `GET /v1/tiktok/profiles/{handle}`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by handle
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/tiktok/profiles/handle/get)
- **Platform page:** [/platforms/tiktok](https://www.socialfetch.dev/platforms/tiktok)

## 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.