One endpoint. Every provider.
Resolve playable .m3u8 / .mpd URLs for any movie or TV episode from 10 providers in parallel — with embed fallbacks, caching and provider health reporting.
10 providers in parallelHLS / DASH / MP4 + embed fallback
Metadata appears here when a TMDB API key is provided (Advanced options). Try the built-in presets below.
Quick test:
Enter a TMDB id above (or click a preset) and hit Find Streams.
Providers unreachable from this network will be flagged OFFLINE — the resolver still returns their embed URLs.
Providers unreachable from this network will be flagged OFFLINE — the resolver still returns their embed URLs.
API reference
Single endpoint, multi-provider resolution, 10-minute server-side cache, CORS enabled.
GET/api/stream?tmdb=27205&type=movie
| Param | Type | Required | Description |
|---|---|---|---|
| tmdb | integer | required | TMDB id of the movie or series (e.g. 27205) |
| type | movie | tv | optional | Defaults to `movie` |
| season | integer | optional | Required when type=tv |
| episode | integer | optional | Required when type=tv |
| providers | csv | optional | Only query these provider ids (e.g. vidjoy,vidlink) |
| exclude | csv | optional | Skip these provider ids (e.g. demo) |
| key | string | optional | TMDB v3 API key — enriches response with title/poster and unlocks IMDB-dependent providers |
| refresh | 0 | 1 | optional | Bypass the 10-minute result cache |
cURL
curl "http://localhost:3000/api/stream?tmdb=27205&type=movie"
Consume from your app
const res = await fetch("/api/stream?tmdb=27205&type=movie");
const data = await res.json();
if (data.best) {
// { provider, url, kind: "hls" | "dash" | "mp4", quality }
playWithHlsJs(data.best.url);
} else {
// fall back to an iframe embed player
iframe.src = data.embeds[0].url;
}Registered providers
vidjoydirectJSON API → HLS playlists per quality
embedsudirectBase64 server list → m3u8 when decodable
autoembedhybridBest-effort JSON extraction + embed
vidsrchybridTMDB-native embed, API via IMDB id
vidlinkembedReliable TMDB-native embed player
twoembedembedTMDB-based embed endpoints
multiembedembedSuperEmbed-style, native TMDB support
vidfastembedFast embed player
moviesapiembedClassic embed endpoint
demodirectBuilt-in public test streams (HLS/DASH/MP4)