v1

latestOpenAPI 3.0.0MIT License2026-07-2271015.6 KB

Content

Get streaming sources for a movie

Retrieve all available streaming sources and subtitles for a movie by TMDB ID.

Requirements:

Returns an array of sources with URLs, quality, audio tracks, and provider information
Returns an array of subtitles with URLs, labels, and formats
Uses proxy paths for all URL fields
Includes a unique responseId and expiration timestamp
May include diagnostics for partial scrapes or warnings

get/v1/movies/{id}

Path parameters

idstring required

TMDB movie ID (numeric, max 20 characters)

Response

Streaming sources and subtitles found

responseIdstring uuid required

Unique identifier for this response (UUID v4)

expiresAtstring date-time required

ISO 8601 timestamp when sources expire and cache is invalidated. Recommended default: 2 hours from response time for sources.

Example response

{
  "responseId": "bdfa40a7-a468-461c-8563-7a0c165f252c",
  "expiresAt": "2026-01-15T18:00:00Z",
  "sources": [
    {
      "url": "/v1/proxy?data=%7B%22url%22%3A%22https%3A%2F%2Fcdn.example.com%2Fstream.m3u8%22%7D",
      "quality": "1080p",
      "audioTracks": [
        {
          "language": "en",
          "label": "English"
        }
      ],
      "provider": {
        "id": "prov_1",
        "name": "Provider One"
      }
    }
  ],
  "subtitles": [
    {
      "url": "/v1/proxy?data=%7B%22url%22%3A%22https%3A%2F%2Fcdn.example.com%2Fsub.vtt%22%7D",
      "label": "English",
      "format": "vtt"
    }
  ],
  "diagnostics": [
    {
      "code": "QUALITY_INFERRED",
      "message": "Quality for source 'src_tv_002' was inferred from filename",
      "field": "sources.quality",
      "severity": "warning"
    }
  ]
}

All 7 operations