Movie Subtitles

Fetch all available subtitle tracks for a movie.

GET /api/subtitles/movie/{tmdb_id}

Movie Subtitles

cURL

curl --request GET \
  --url http://localhost:7860/api/subtitles/movie/{tmdb_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "[]": [
    {
      "label": "<string>",
      "file": "<string>",
      "type": "<string>",
      "source": "<string>"
    }
  ]
}

Returns an array of subtitle tracks for a movie. Each track is a direct link to a .vtt or .srt file — no proxy needed. Requires a standard or partner API key. Subtitle tracks are also bundled automatically in /movie responses as part of the meta event; use this endpoint when you need them independently.

---

Path Parameters

tmdb_id · string · required

TMDB movie ID.

Example: /api/subtitles/movie/550 → subtitles for Fight Club

---

Request

cURL

curl http://localhost:7860/api/subtitles/movie/550 \
  --header "Authorization: Bearer YOUR_API_KEY"

---

Response

Returns a JSON array. 404 if no subtitles are found for this title.

[] · Subtitle[]

Array of subtitle track objects.

Show Subtitle object

label · string

Language name of the track, e.g. English, Spanish, Arabic, French, Portuguese.

file · string

Direct URL to the subtitle file. Accessible without any proxy or authentication.

type · string

Format of the subtitle file — vtt or srt.

source · string

Internal subtitle source identifier (e.g. v1, v2, febbox).

---

Responses

200 — Success

[
  {
    "label": "English",
    "file": "https://sub.vdrk.site/v1/movie/550/English.vtt",
    "type": "vtt",
    "source": "v1"
  },
  {
    "label": "Spanish",
    "file": "https://sub.vdrk.site/v1/movie/550/Spanish.vtt",
    "type": "vtt",
    "source": "v1"
  },
  {
    "label": "French",
    "file": "https://sub.vdrk.site/v2/movie/550/French.vtt",
    "type": "vtt",
    "source": "v2"
  }
]

404 — Not Found

No subtitle tracks were found for this TMDB ID.

{ "error": "no subtitles found" }

401 — Unauthorized

{ "error": "Missing API key. Provide via Authorization header or X-API-Key header." }

403 — Forbidden

{ "error": "Public keys cannot access subtitle endpoints" }

500 — Server Error

{ "error": "<error message>" }

---

Usage Examples

HTML <track> element

<video id="player" controls></video>

<script>
  fetch('http://localhost:7860/api/subtitles/movie/550', {
    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
  })
    .then(r => r.json())
    .then(subs => {
      const video = document.getElementById('player');
      subs.forEach((sub, i) => {
        const track = document.createElement('track');
        track.kind    = 'subtitles';
        track.label   = sub.label;
        track.src     = sub.file;
        track.default = i === 0;
        video.appendChild(track);
      });
    });
</script>

Video.js

import videojs from 'video.js';

const subs = await fetch(
  'http://localhost:7860/api/subtitles/movie/550',
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
).then(r => r.json());

const player = videojs('player');

subs.forEach(sub => {
  player.addRemoteTextTrack({
    kind: 'subtitles',
    label: sub.label,
    src: sub.file,
  }, false);
});

Plyr

import Plyr from 'plyr';

const subs = await fetch(
  'http://localhost:7860/api/subtitles/movie/550',
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
).then(r => r.json());

subs.forEach(sub => {
  const track = Object.assign(document.createElement('track'), {
    kind:  'captions',
    label: sub.label,
    src:   sub.file,
  });
  document.getElementById('player').appendChild(track);
});

const player = new Plyr('#player', {
  captions: { active: true, update: true },
});

Subtitle tracks are included automatically in /movie responses inside the meta event. Only call this endpoint when you need subtitles without fetching stream sources.