Introduction

Stream and download any movie or TV show via TMDB ID — one API, eight providers, zero config.

What is Vyla API?

Vyla API is a Cloudflare Pages API that scrapes streaming sources from 8 providers concurrently and serves them through a unified JSON interface. Pass any TMDB ID and get back:

Stream URLs

Direct HLS and MP4 sources, sorted by quality — filtered to English audio only

Download Links

Pre-built download_url and ready-to-run ffmpeg_command for every source

Subtitles

Deduplicated English subtitle tracks in VTT and SRT, proxied and ready to inject

Embeddable Player

One iframe, zero config — fallback logic, subtitles, and HLS.js built in

---

Base URL

https://vyla-api.pages.dev

All endpoints return Access-Control-Allow-Origin: * — no credentials needed.

---

Quick Start

Movie Sources

curl https://vyla-api.pages.dev/api/movie?id=27205

New here? Jump to the Quickstart for a guided walkthrough of the four most common use cases.

---

Endpoint Overview

Scraping Endpoints — raw sources

Endpoint	Description
GET /api/movie	Raw streaming sources for a movie
GET /api/tv	Raw streaming sources for a TV episode
GET /api/scrape	Single-provider scrape — internal building block

Enriched / Download Endpoints — processed sources

Endpoint	Description
GET /api/stream/movie	All providers in parallel · download_url · ffmpeg_command · deep dedup
GET /api/stream/tv	Same, for TV episodes
GET /api/download/movie	Alias of /api/stream/movie
GET /api/download/tv	Alias of /api/stream/tv

Utility Endpoints

Endpoint	Description
GET /api/download	Proxy-download a single raw video URL
GET /api/proxy	Proxy any URL through Cloudflare with CORS + header injection
GET /api/player	Embeddable fullscreen HTML player

---

Providers

Sources are scraped concurrently from all 8 providers, filtered to English audio, and sorted by quality before being returned.

---

Quality Priority

All sources are sorted in this order before being returned:

1. 4K / 2160p
2. 1440p
3. 1080p
4. 720p
5. 480p → 360p → 240p
6. HD → Auto → Unknown

---

Source Object Reference

Raw (/api/movie, /api/tv)

{
  "url": "https://...",
  "type": "hls | mp4 | mkv",
  "quality": "1080p",
  "provider": "VixSrc",
  "audioTracks": [
    { "language": "eng", "label": "English" }
  ],
  "headers": {
    "Referer": "https://...",
    "Origin": "https://..."
  },
  "vlc_url": "https://..."
}

vlc_url is identical to url on raw endpoints — it is not proxied. You must forward headers yourself when fetching the stream directly.

Enriched (/api/stream/*, /api/download/*)

{
  "provider": "VixSrc",
  "quality": "1080p",
  "type": "hls",
  "url": "https://vixsrc.to/playlist/...",
  "is_hls": true,
  "referer": "https://vixsrc.to/",
  "ffmpeg_command": "ffmpeg -headers \"...\" -i \"https://...\" -c copy -bsf:a aac_adtstoasc output.mp4",
  "download_url": null,
  "vlc_url": "/api/proxy?url=...&headers=..."
}

download_url is null for HLS streams — use ffmpeg_command instead. vlc_url is a pre-built proxied URL ready for VLC or any URL-capable player.

Subtitle Object

{
  "url": "https://...",
  "label": "English",
  "format": "vtt | srt"
}

Subtitle objects appear in the subtitles array on every scraping and stream endpoint. See the Subtitles guide for filtering, deduplication, and usage details.

---

CORS Headers

Every endpoint returns:

Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, HEAD, OPTIONS
Access-Control-Allow-Headers: *