Skip to main content
GET
Get Video Detail
Pass the author’s username to skip the internal oEmbed author lookup for a faster, cheaper fetch.
Each request costs 5 credits. Failed requests are not charged.

Downloading video media

Fetch video detail immediately before downloading. When available, video.video.media_headers contains the anonymous CDN headers that must accompany that same response’s play_addr or download_addr. Do not mix a URL from a list response with headers from video detail. No TikTok account or login cookie is needed.
The headers contain a short-lived guest media cookie, not your ScrapeBadger API key. Send them only to the returned TikTok media URL. Do not send your ScrapeBadger key to the CDN. Refresh video detail if the link expires. If media_headers is null, metadata is available but authorized media resolution was not obtained; do not treat this as a verified downloadable link. Photo slideshows may have no video media. Social-list requests accept count up to 50, but TikTok permits at most 30 per upstream page. A response may contain fewer rows; follow its returned cursor.

Authorizations

x-api-key
string
header
required

Path Parameters

video_id
string
required

The numeric TikTok video/aweme id.

Query Parameters

region
string
default:US

Content region (ISO 3166-1 alpha-2). Routes the request through a proxy and signer for that locale.

username
string

Author @handle. When supplied, skips the oEmbed author lookup for a faster, cheaper fetch.

Response

200 - application/json

Video detail

video
object
required

A TikTok post (video or photo slideshow) with full metadata.

region
string
required