TV episode sources

Retrieve TV episode streaming sources by TMDB series ID, season, and episode.

GET /v1/tv/{id}/seasons/{s}/episodes/{e}

TV episode sources

JavaScript

const options = {method: 'GET'};

fetch('http://localhost:{port}/v1/tv/{id}/seasons/{s}/episodes/{e}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request GET \
  --url http://localhost:{port}/v1/tv/{id}/seasons/{s}/episodes/{e}

import requests

url = "http://localhost:{port}/v1/tv/{id}/seasons/{s}/episodes/{e}"

response = requests.get(url)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "62437",
  CURLOPT_URL => "http://localhost:{port}/v1/tv/{id}/seasons/{s}/episodes/{e}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "http://localhost:{port}/v1/tv/{id}/seasons/{s}/episodes/{e}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("http://localhost:{port}/v1/tv/{id}/seasons/{s}/episodes/{e}")
  .asString();

200

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "sources": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "url": "<string>",
      "streamable": true,
      "audioTracks": [
        "<string>"
      ],
      "provider": {
        "id": "<string>",
        "name": "<string>"
      },
      "headers": {}
    }
  ],
  "subtitles": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "url": "<string>",
      "label": "<string>",
      "provider": {
        "id": "<string>",
        "name": "<string>"
      },
      "headers": {}
    }
  ],
  "diagnostics": [
    {
      "message": "<string>",
      "source": "<string>"
    }
  ],
  "expiresAt": "2023-11-07T05:31:56Z"
}

{
  "error": {
    "message": "<string>",
    "details": "<unknown>"
  },
  "traceId": "<string>"
}

{
  "error": {
    "message": "<string>",
    "details": "<unknown>"
  },
  "traceId": "<string>"
}

{
  "error": {
    "message": "<string>",
    "details": "<unknown>"
  },
  "traceId": "<string>"
}

{
  "error": {
    "message": "<string>",
    "details": "<unknown>"
  },
  "traceId": "<string>"
}

{
  "error": {
    "message": "<string>",
    "details": "<unknown>"
  },
  "traceId": "<string>"
}

Path Parameters

id · string · required

TMDB series ID, numeric characters only, treated as a string.

Maximum string length: 20

Pattern: ^[0-9]+$

s · integer · required

Season number (non-negative integer).

Required range: 0 <= x <= 99

e · integer · required

Episode number (positive integer).

Required range: 1 <= x <= 9999

Query Parameters

platform · enum<string>

Target platform for source optimization. For "web" the url fields must be directly usable in browsers without additional headers or CORS handling. For "native" the url fields are upstream URLs and headers are returned to be used by native players. Default is "web".

Available options: web, native

provider · string

Specific provider ID to fetch sources from. The response structure remains the same but only sources from this provider are returned. If the provider is unknown, a PROVIDER_NOT_FOUND error is returned.

filter · string

Filter expression applied to the sources array (not subtitles) after retrieval and before the response is returned. Syntax: "condition[;condition...]" where ";" acts as logical AND. Supported operators: "==", "!=", "=in=", "=out=". The wildcard "*" MAY be used in values. Backends MUST support filtering on quality, type, streamable, provider.id, provider.name, audioTracks, and format.

Response

200

application/json

TV episode sources and subtitles successfully retrieved.

Success response for movie and TV episode endpoints, containing sources, subtitles, and diagnostics.

id · string<uuid> · required

Unique response identifier (e.g. UUID v4).

sources · object[] · required

Array of streaming source objects. Must contain at least one element if any sources are available.

Show child attributes

subtitles · object[] · required

Array of subtitle objects. May be empty.

Show child attributes

diagnostics · object[] · required

Non-fatal warnings or errors about data quality, inference, or provider issues. May be empty.

Show child attributes

expiresAt · string<date-time>

Optional ISO 8601 timestamp when sources expire (for signed or temporary URLs).