Pricing
- Base
- 1 credit
downloadMedia= true— Hosted media download- +10 credits
Headers
Get your API keyAPI key (`sfk_...`)
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.
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
curl "https://api.socialfetch.dev/v1/tiktok/videos?url=https://www.tiktok.com/@mrbeast/video/7596844935442189598" \
-H "x-api-key: YOUR_API_KEY"Responses
Video metadata (found or not found in body).