GET /api/tv

Scrape streaming sources for a TV episode by TMDB series ID

GET /api/tv

GET /api/tv

cURL

curl --request GET \
  --url https://vyla-api.pages.dev/api/tv

200

{
  "success": true,
  "results_found": 123,
  "sources": [
    {
      "url": "<string>",
      "type": "<string>",
      "quality": "<string>",
      "provider": "<string>",
      "audioTracks": [
        {
          "language": "<string>",
          "label": "<string>"
        }
      ],
      "headers": {
        "Referer": "<string>",
        "Origin": "<string>"
      },
      "vlc_url": "<string>"
    }
  ],
  "subtitles": [
    {
      "url": "<string>",
      "label": "<string>",
      "format": "<string>"
    }
  ]
}

Scrapes all providers for a TV episode and returns the raw source list. Sources are sorted by quality and filtered to English audio only. No deduplication beyond exact URL matches is applied at this layer.

For enriched output with pre-built download_url, ffmpeg_command, and deeper deduplication across all providers in parallel, use GET /api/stream/tv instead.

Query Parameters

id · string · required

TMDB series ID — not episode ID. Find it at themoviedb.org, e.g. themoviedb.org/tv/456 → 456.

season · number · default: "1"

Season number.

episode · number · default: "1"

Episode number.

Example Request

Season 1, Episode 1 (defaults)

curl https://vyla-api.pages.dev/api/tv?id=456

Response

success · boolean · required

true if scraping succeeded, false otherwise.

results_found · number · required

Total number of sources returned.

sources · Source[] · required

Array of stream source objects, sorted by quality descending.

Show Source object

url · string

Direct stream URL. Signed and may expire.

type · string

hls, mp4, or mkv

quality · string

e.g. 1080p, 720p, HD, unknown

provider · string

Which provider this source came from.

audioTracks · AudioTrack[]

Available audio tracks.

Show AudioTrack object

language · string

ISO language code, e.g. eng

label · string

Human-readable label, e.g. English

headers · object

Required headers to forward when fetching this URL directly.

Show Headers object

Referer · string

Required Referer header value.

Origin · string

Required Origin header value.

vlc_url · string

Same as url on this endpoint — not proxied. Use /api/stream/tv for a pre-built proxied vlc_url.

subtitles · Subtitle[] · required

Array of subtitle objects.

Show Subtitle object

url · string

Direct URL to the subtitle file.

label · string

Display name, e.g. English, English [CC]

format · string

vtt or srt

200 Success

{
  "success": true,
  "results_found": 9,
  "sources": [
    {
      "url": "https://vixsrc.to/playlist/202976?token=...&expires=...&h=1",
      "type": "hls",
      "quality": "1080p",
      "provider": "VixSrc",
      "audioTracks": [
        { "language": "eng", "label": "English" }
      ],
      "headers": {
        "Referer": "https://vixsrc.to",
        "Origin": "https://vixsrc.to"
      },
      "vlc_url": "https://vixsrc.to/playlist/202976?token=...&expires=...&h=1"
    },
    {
      "url": "https://bcdnxw.hakunaymatata.com/bt/abc123.mp4?sign=...&t=...",
      "type": "mp4",
      "quality": "360p",
      "provider": "VidRock",
      "audioTracks": [
        { "language": "eng", "label": "English" }
      ],
      "headers": {
        "Referer": "https://lok-lok.cc/",
        "Origin": "https://lok-lok.cc/"
      },
      "vlc_url": "https://bcdnxw.hakunaymatata.com/bt/abc123.mp4?sign=...&t=..."
    }
  ],
  "subtitles": [
    {
      "url": "https://vixsrc.to/playlist/202976?type=subtitle&rendition=3-eng&token=...&expires=...&edge=...",
      "label": "English [CC]",
      "format": "vtt"
    },
    {
      "url": "https://vdrk.b-cdn.net/cache/tv/456/1/1/English.vtt",
      "label": "English",
      "format": "vtt"
    }
  ]
}

400 Error

{
  "success": false,
  "error": "Missing id"
}

The headers field on each source must be forwarded when fetching the stream directly. Use /api/stream/tv to get pre-built vlc_url (proxied), download_url, and ffmpeg_command with headers already encoded.

The id parameter refers to the series, not an individual episode. Season and episode numbers are passed as separate season and episode parameters.