CIcinepro
Content

Get streaming sources for a movie

Changed on

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}

Request

  • Base URL
    https://api.example.com
  • URL
    https://api.example.com/v1/movies/{id}
  • Auth
    none declared

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"
    }
  ]
}

Changes

  • 2cb99625e1bfRevision changes
    • warning

      removed the optional property //// from the response with the status