How video downloaders actually work

A short, honest technical explainer, what happens between "paste URL" and "file saved", and why the results differ from platform to platform.

1. A video page is just a page that points at a file

When a platform shows you a video, the player in your browser isn't displaying a file embedded in the page, it's fetching a separate file from a content delivery network (CDN), usually a direct .mp4 or .webm URL. The page's HTML typically reveals that URL in one of several places: a <video> or <source> tag, an og:video meta tag, a JSON block the player reads on load, or a JSON-LD VideoObject.

A downloader's first job is exactly this: fetch the public page, find the direct file URL, and hand it back. The downloader checks those locations in order of reliability and prefers the best format (MP4, higher resolution first).

The four places a clip page can expose its video file: the video or source tag, the og:video meta tag, embedded player JSON, and a JSON-LD VideoObject
Where the link hides
The downloader checks the video source tag, og:video meta, player JSON, and JSON-LD VideoObject in that order of reliability
Read in order of reliability
The parser prefers an H.264 MP4 file in the highest resolution available, with WebM as the fallback format
Best format wins

2. Some CDNs check who's asking

Many video CDNs refuse file requests that don't look like they came from their own site. They check the Referer (and sometimes Origin) header: a browser watching the page sends the page's origin automatically, so it works; a bare download of the file URL may not.

There's a browser rule that matters here: a webpage cannot set custom Referer or Origin headers on cross-site requests, they're on the forbidden-header list. So a downloader running in your browser can find the link but can't always attach the right headers to fetch the file.

The downloader solves this with a small server-side stream route: your browser asks our parse service for the file, the service fetches it from the platform's CDN with the correct headers, and passes the bytes straight through to you (no re-encoding, capped at 500 MB, link valid for 10 minutes). The file still comes from the platform's own CDN, the service just signs the request.

A file request carrying the page's Referer header, which browsers send automatically while you watch the page
The Referer header
Browser rule: web pages cannot set Referer or Origin headers on cross-site requests because they are on the forbidden header list
A browser rule
The downloader's stream route: your browser asks the parse service, it fetches from the CDN with the correct headers, and the bytes pass through
The signed stream route

3. Why some platforms work and others can't

  • Works out of the box, the direct file URL is in the served HTML and the CDN doesn't over-check headers. Most "generic" support falls here.
  • Needs a per-site adapter, the page loads fine but the player URL is generated by JavaScript or is a signed, expiring URL with a specific shape. Each such site needs its own parsing logic.
  • Bot-walled, the platform rejects non-browser traffic at the network layer (HTTP 403 from a WAF). We do not circumvent that. It's not a skill gap; it's a line.
  • Genuinely unavailable, the domain is dead or parked, or the platform is photo-only (no video to extract at all).

The status board shows every allowlisted platform in one of these states, with the measurement date, because an honest "no" is worth more than an optimistic checkmark.

Works out of the box: the direct file URL is in the served HTML and the CDN does not over-check headers
Works out of the box
Needs a per-site adapter: the player JavaScript builds a signed, expiring file URL with a specific shape
Needs a per-site adapter
Bot-walled platforms reject non-browser traffic with HTTP 403 and are never bypassed; dead or photo-only platforms are simply unavailable
A line we don't cross

4. What a downloader never does (by design)

  • No login bypass, no geo-block bypass, no CAPTCHA or WAF circumvention.
  • No hosting or re-encoding, the bytes travel from the platform's CDN to you, period.
  • No storage of the URLs you paste.
  • No support for platforms whose core content is real, non-anonymous people, leaks, stalking aggregators, non-consensual material.
Three things the downloader never does: login bypass, geo-block bypass, and CAPTCHA or WAF circumvention
No bypass, ever
The file's bytes travel directly from the platform's CDN to you, with no re-encoding and no storage in between
No hosting, no re-encoding
The URLs you paste are never stored, and the downloader refuses platforms with real non-anonymous people, leaks, or non-consensual material
No storage, no real people

5. Formats and quality

Most of these platforms serve H.264 MP4 (universally playable) and often WebM (smaller, VP9). Where the page exposes multiple qualities, the downloader reports what it found (480p/720p/1080p when detectable from the URL) and never invents a quality that isn't there. Some platforms serve only one quality; that's the platform's decision, not the downloader's.

Most platforms serve H.264 MP4 video, and often also WebM
H.264 MP4, often WebM
Quality labels for 480p, 720p and 1080p are read from the URL when detectable and never invented
Reported, never invented
A clip usually has one file and one quality; which one you get is the platform's decision, not the downloader's
The platform's call
Next step: paste a clip link into the box on the home hub, or read the legal boundaries before you start downloading.