TV Episode Sources
curl --request GET \
--url https://missourimonster-vyla.hf.space/tvdata: {"type":"meta","meta":{"id":1396,"name":"Pilot","season_number":1,"episode_number":1,"air_date":"2008-01-20"},"subtitles":[{"label":"English","file":"https://sub.vdrk.site/v1/tv/1396/1/1/English.vtt","type":"vtt","source":"v1"}]}
data: {"type":"source","source":{"source":"vidlink","label":"VidLink","url":"https://missourimonster-vyla.hf.space/api?url=https%3A%2F%2F...&vl=1"}}
data: {"type":"source","source":{"source":"meowtv","label":"MeowTV","url":"https://missourimonster-vyla.hf.space/api?url=https%3A%2F%2F...&mt=1"}}
data: {"type":"done","total":2}
Stream Sources
TV Episode Sources
Stream verified HLS sources, subtitle tracks, and TMDB metadata for a TV episode via Server-Sent Events.
GET
/
tv
TV Episode Sources
curl --request GET \
--url https://missourimonster-vyla.hf.space/tvdata: {"type":"meta","meta":{"id":1396,"name":"Pilot","season_number":1,"episode_number":1,"air_date":"2008-01-20"},"subtitles":[{"label":"English","file":"https://sub.vdrk.site/v1/tv/1396/1/1/English.vtt","type":"vtt","source":"v1"}]}
data: {"type":"source","source":{"source":"vidlink","label":"VidLink","url":"https://missourimonster-vyla.hf.space/api?url=https%3A%2F%2F...&vl=1"}}
data: {"type":"source","source":{"source":"meowtv","label":"MeowTV","url":"https://missourimonster-vyla.hf.space/api?url=https%3A%2F%2F...&mt=1"}}
data: {"type":"done","total":2}
Identical to the movie endpoint in behavior, but requires a series ID plus season and episode numbers. Results stream via Server-Sent Events — the
Emitted first, before any provider resolves.
Emitted once per verified, working provider.
meta event fires immediately with subtitles and TMDB data, then each working provider emits its own source event as it resolves.
Query Parameters
TMDB series ID — not an episode ID. Find it on themoviedb.org in the URL of the show’s main page.Example:
themoviedb.org/tv/1396 → id=1396 (Breaking Bad)Season number. Use
1 for the first season.Episode number within the season. Use
1 for the first episode.Comma-separated list of provider keys to query. When omitted, all active providers are queried.Example:
sources=vidlink,vixsrc,meowtvUse GET /api?sources_meta=1 to retrieve the full list of available provider keys.Request
curl -N "https://missourimonster-vyla.hf.space/tv?id=1396&season=1&episode=1"
SSE Event Reference
meta
Emitted first, before any provider resolves.
Always
"meta".TMDB episode-level metadata — name, overview, air date, episode number, season number.
null if no TMDB_API_KEY is configured.source
Emitted once per verified, working provider.
Always
"source".Show Source object
Show Source object
Internal provider key.
Human-readable provider name.
Fully-qualified, proxied stream URL. For HLS sources, pass to
hls.loadSource() — all M3U8 segment and key URIs are rewritten to route through the proxy. For MP4 sources, set as video.src directly. No base URL prepending needed.done
Always
"done".Total number of working
source events emitted.Status Codes
| Status | Meaning |
|---|---|
200 | SSE stream opened successfully |
400 | Missing id, season, or episode parameter |
500 | Server error before the stream could begin |
data: {"type":"meta","meta":{"id":1396,"name":"Pilot","season_number":1,"episode_number":1,"air_date":"2008-01-20"},"subtitles":[{"label":"English","file":"https://sub.vdrk.site/v1/tv/1396/1/1/English.vtt","type":"vtt","source":"v1"}]}
data: {"type":"source","source":{"source":"vidlink","label":"VidLink","url":"https://missourimonster-vyla.hf.space/api?url=https%3A%2F%2F...&vl=1"}}
data: {"type":"source","source":{"source":"meowtv","label":"MeowTV","url":"https://missourimonster-vyla.hf.space/api?url=https%3A%2F%2F...&mt=1"}}
data: {"type":"done","total":2}
Notes
Filtering providers with sources=
Filtering providers with sources=
Pass a comma-separated list of provider keys to query only specific providers:Keys that don’t match any active provider are silently ignored. If none of the requested keys match, the response will emit
/tv?id=1396&season=1&episode=1&sources=vidlink,vixsrc
done with total: 0. Omit the parameter entirely to query all active providers.Series ID vs Episode ID
Series ID vs Episode ID
The
id parameter is the series TMDB ID — the same value regardless of which season or episode you request. Season and episode numbers are passed separately.| Wrong | Right |
|---|---|
| Episode-level TMDB ID | Series-level TMDB ID |
id=62085 (Pilot episode) | id=1396 (Breaking Bad series) |
Specials and bonus content
Specials and bonus content
Season
0 typically contains specials on TMDB. Support varies by provider — expect fewer working sources for specials.Meta field is episode-level
Meta field is episode-level
Unlike the movie endpoint where
meta describes the film, here meta contains episode data from TMDB — title, overview, air date, and episode number. Series-level metadata is not included.Zero sources
Zero sources
If all providers fail, you’ll receive a
done event with total: 0 and no source events. Check /health to see which providers are up.⌘I