mirror of
https://gitlab.com/vyla-entertainment/documentation.git
synced 2026-11-16 07:27:21 -05:00
3.2 KiB
3.2 KiB
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. Both /subtitles and /api/subtitles paths are supported.
Subtitle Directory: GET /subtitles
Returns available subtitle route templates:
GET /subtitles HTTP/1.1
Host: api.vyla.cc
{
"routes": {
"movie": "/subtitles/movie/:id",
"tv": "/subtitles/tv/:id/:s/:e"
},
"examples": {
"movie": "/subtitles/movie/155",
"tv": "/subtitles/tv/1396/1/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
[
{
"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"
}
]
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 stream packages for offline playback. Both /downloads and /api/downloads paths are supported.
Download Directory: GET /downloads
GET /downloads HTTP/1.1
Host: api.vyla.cc
{
"routes": {
"movie": "/downloads/movie/:id",
"tv": "/downloads/tv/:id/:s/:e"
},
"examples": {
"movie": "/downloads/movie/155",
"tv": "/downloads/tv/1396/1/1"
}
}
Movie Downloads: GET /downloads/movie/:id
GET /downloads/movie/155 HTTP/1.1
Host: api.vyla.cc
[
{
"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"
}
]
Television Episode Downloads: GET /downloads/tv/:id/:season/:episode
GET /downloads/tv/1396/1/1 HTTP/1.1
Host: api.vyla.cc
[
{
"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=...includeAccess-Control-Allow-Origin: *, allowing HTML5<track>elements to render in any browser context.