Get TikTok profile
Looks up a TikTok profile by handle.
Operation
/v1/tiktok/profiles/{handle}Headers
API key (`sfk_...`)
Parameters
TikTok handle to look up, with or without a leading @.
min 1 chars · max 64 chars
Response fields
Endpoint-specific response payload.
Whether the profile was found, private, or not found.
one of: found, private, not_found
Profile details when available.
Social platform for this profile.
one of: tiktok
TikTok username without the leading @.
Public display name shown on the TikTok profile.
Profile biography text.
Best available avatar image URL for the profile.
Whether TikTok marks the profile as verified.
Canonical public TikTok profile URL.
min 1 chars
Whether the TikTok account is private.
TikTok numeric user id as a string (stable within TikTok).
TikTok opaque stable user identifier (for advanced integrations).
Account creation time as Unix epoch seconds from TikTok, when provided.
≥ 0
Avatar URLs at multiple resolutions when available.
Large avatar URL (typically 1080px class).
Medium avatar URL (typically 720px class).
Thumbnail avatar URL (typically 100px class).
Profile link-in-bio when TikTok provides it.
Destination URL for the profile link.
min 1 chars
TikTok-assigned link risk indicator (vendor-defined).
Profile language code reported by TikTok (e.g. en).
Whether TikTok marks the account as a commerce/creator shop user.
Whether TikTok marks the account as a TikTok Shop seller.
Whether the user’s liked-videos list is public.
Whether TikTok flags the profile as an AD virtual account.
Whether embeds are disallowed for this profile.
Whether playlist expansion is allowed for this profile.
TikTok profile embed permission code (vendor-defined).
Who can see accounts this user follows (TikTok vendor-defined code).
Live room id when TikTok provides a non-empty value.
Comment, duet, stitch, and download settings from TikTok.
TikTok comment-setting code (vendor-defined).
TikTok duet-setting code (vendor-defined).
TikTok stitch-setting code (vendor-defined).
TikTok download-setting code (vendor-defined).
Which profile tabs TikTok exposes.
Whether the Music tab is shown on the profile.
Whether the Q&A tab is shown on the profile.
Whether the playlist tab is shown on the profile.
Profile metrics when available.
Total follower count reported by TikTok.
≥ 0
Total following count reported by TikTok.
≥ 0
Total profile likes reported by TikTok.
≥ 0
Total public posts or videos reported by TikTok.
≥ 0
Mutual friend count when TikTok reports it.
≥ 0
Profile digg count when TikTok reports it (often zero).
≥ 0
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Lookup result. Check `data.lookupStatus` for `found`, `private`, or `not_found`.
Error codes
API reference
Browse Social Fetch endpoints by platform and task, with direct links to generated schema pages and the raw OpenAPI spec
Profile videos
Lists videos for a TikTok profile with cursor-based pagination. Optional query `sortBy` is `latest` or `popular`; when omitted, a default ordering applies—pass `sortBy` explicitly if you need predictable ordering. This route does not expose `lookupStatus`; an empty `data.videos` array can occur for several reasons—call `GET /v1/tiktok/profiles/{handle}` first when you need explicit `found` / `private` / `not_found` before interpreting an empty list.