documentation/stream-api/reference/media-data.md

Subtitles & Media Downloads

REST API reference for retrieving subtitle tracks and direct media download packages for movies and television series.

Subtitle Endpoints

Retrieve subtitle tracks independently from video streams in .vtt or .srt formats.

---

1. Movie Subtitles: GET /subtitles/movie/:id

GET /subtitles/movie/155 HTTP/1.1
Host: api.vyla.cc

Parameters:

• id (number, required) — TMDB Movie ID (e.g. 155).

curl https://api.vyla.cc/subtitles/movie/155

{
  "subtitles": [
    {
      "label": "English",
      "file": "https://api.vyla.cc/api?url=https%3A%2F%2Fsubtitles.org%2Fen.vtt",
      "type": "vtt",
      "source": "opensubtitles"
    },
    {
      "label": "Spanish",
      "file": "https://api.vyla.cc/api?url=https%3A%2F%2Fsubtitles.org%2Fes.vtt",
      "type": "vtt",
      "source": "opensubtitles"
    }
  ]
}

---

2. Television Episode Subtitles: GET /subtitles/tv/:id/:season/:episode

GET /subtitles/tv/1396/1/1 HTTP/1.1
Host: api.vyla.cc

Parameters:

• id (number, required) — TMDB Series ID (e.g. 1396).
• season (number, required) — Season number (e.g. 1).
• episode (number, required) — Episode number (e.g. 1).

curl https://api.vyla.cc/subtitles/tv/1396/1/1

---

Direct Download Endpoints

Fetch direct video files and torrent/debrid download packages.

---

1. Movie Downloads: GET /downloads/movie/:id

GET /downloads/movie/155 HTTP/1.1
Host: api.vyla.cc

{
  "downloads": [
    {
      "quality": "1080p",
      "size": 2450882194,
      "type": "mkv",
      "active": true,
      "url": "https://cdn.example.com/download/the-dark-knight-1080p.mkv"
    },
    {
      "quality": "720p",
      "size": 1150428190,
      "type": "mkv",
      "active": true,
      "url": "https://cdn.example.com/download/the-dark-knight-720p.mkv"
    }
  ]
}

---

2. Television Episode Downloads: GET /downloads/tv/:id/:season/:episode

GET /downloads/tv/1396/1/1 HTTP/1.1
Host: api.vyla.cc

{
  "downloads": [
    {
      "quality": "1080p",
      "size": 1420882194,
      "type": "mkv",
      "active": true,
      "url": "https://cdn.example.com/download/breaking-bad-s01e01-1080p.mkv"
    }
  ]
}

---

Client Integration Notes

• Non-blocking Loading: Fetch subtitles in the background while video playback begins immediately on the first candidate stream.
• CORS Permissive: Subtitle tracks proxied through /api?url=... include Access-Control-Allow-Origin: *, allowing HTML5 <track> elements to render in any browser context.
• Format Conversion: If your web player requires WebVTT, convert SRT commas to dots (00:01:20,500 -> 00:01:20.500) client-side before loading.