Get TikTok video
Returns public metadata for a single TikTok video or photo post.
Operation
/v1/tiktok/videosPricing
- Base
- 1 credit
downloadMedia= true— Hosted media download- +10 credits
Headers
API key (`sfk_...`)
Parameters
Link to the video or photo post.
min 1 chars · max 4096 chars
Optional two-letter region (country code) used to route the request when needed.
min 1 chars
When true, returns a smaller response with fewer fields.
When true, includes hosted CDN URLs in `downloads` when available. Adds 10 credits (11 total with the base lookup) on successful lookups, even if `downloads` is empty.
When true, includes the video transcript (WEBVTT) in `transcript` when one is available.
Response fields
Endpoint-specific response payload.
Whether the video was resolved.
one of: found, not_found
Video details when found.
TikTok video id.
min 1 chars
Canonical public TikTok URL for this video.
min 1 chars
Caption text.
ISO-8601 timestamp when the video was posted.
Video region (two-letter country code).
Video duration in milliseconds.
≥ 0
Whether the post is a video or a photo slideshow.
one of: video, slideshow
Whether TikTok marks the post as an ad.
Author when found.
Numeric user id.
Stable opaque user id.
Public username without a leading @.
min 1 chars
Display name.
Whether the account is verified.
Profile picture URL.
Profile bio text.
Two-letter country code when available.
Whether the account is private.
Music or sound when found.
Music or sound id.
Music title.
Music author.
Music playable URL.
Music cover image URL.
Music duration in seconds.
≥ 0
Whether the sound is marked as original.
Engagement metrics for the video.
Play count.
≥ 0
Like count.
≥ 0
Comment count.
≥ 0
Share count.
≥ 0
Save or collection count.
≥ 0
Primary playable media payload for the video.
Best available video URL (typically watermarked).
Best available video URL without watermark.
Thumbnail or cover image URL.
Pixel dimensions.
≥ 0
≥ 0
Ordered image URLs when the post is a photo slideshow.
Populated only when `getTranscript=true` was passed and a transcript was available.
Transcript format.
one of: webvtt
Raw transcript text.
Populated only when `downloadMedia=true` was passed and media was available.
Video id from the post.
Source media URL.
Permanent hosted URL.
Asset type.
one of: video, image
Additional TikTok-native fields from the post (author, music, video, etc.), minus keys already promoted above.
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
Video metadata (found or not found in body).
Error codes
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.
Video comments
Lists top-level comments for a TikTok video URL with optional cursor-based pagination.