Documentation

Everything you need to embed StreamVault into your site.

Quickstart

All content is identified by TMDB IDs. Find any ID at themoviedb.org.

Movie Embed

TV Show Embed

💡 Wrap the iframe in a position:relative; padding-top:56.25% container for a responsive 16:9 ratio. Set the iframe to position:absolute; inset:0; width:100%; height:100%.

URL Structure

Type	Pattern
Movie	https://streamvaultsrc.click/embed/movie/{tmdb_id}
TV Show	https://streamvaultsrc.click/embed/tv/{tmdb_id}/{season}/{episode}

Season and episode numbers are 1-indexed (season 1, episode 1 = /tv/1396/1/1).

Parameters

Append query parameters to the embed URL to customise behaviour.

Parameter	Type	Description
t	optional	Resume playback at a given time in seconds. Example: t=120 (alias: seek)

Example with parameters

https://streamvaultsrc.click/embed/movie/550?t=120

Player Events

Listen for postMessage events from the player to sync your own UI (e.g. Continue Watching progress):

window.addEventListener('message', (event) => {
  if (event.origin !== 'https://streamvaultsrc.click') return;
  const { type, data } = event.data;
  console.log(type, data);
});

Event type	Description
timeupdate	Current time changed (fires periodically during playback) — data.time / data.duration in seconds
ended	Playback finished — data.time / data.duration in seconds

The player does not currently accept commands sent into the iframe (e.g. play/pause/seek via postMessage) — playback controls are handled by the player's own UI.

Best Practices

Always verify message origin — check event.origin === 'https://streamvaultsrc.click' before processing postMessage events.
Use a responsive container — wrap the iframe in a 16:9 ratio container rather than setting a fixed pixel height.
Allow required permissions — include allow="autoplay; fullscreen; encrypted-media; picture-in-picture" on the iframe. Without this, fullscreen and autoplay can silently fail in some browsers.
Don't cache embed URLs — stream URLs expire. Always use a fresh embed URL; never store the resolved stream URL.
Test across devices — the player attempts autoplay automatically, but browsers block unmuted autoplay without prior user interaction on your domain; the player falls back to its own tap/click-to-play UI in that case.

FAQ

Is the embed free to use?

Yes — completely free, no API key required. Just drop in the iframe.

Where do I find TMDB IDs?

Search for any title at themoviedb.org. The ID is the number in the URL — e.g. themoviedb.org/movie/550.

Why does it take a moment to find streams?

On first visit, 12+ providers are queried in parallel. Subsequent visits for the same title load from cache in under 100ms. The player shows its own loading UI while sources are found — no action needed on your end.

Do you have a rate limit?

There are soft limits per IP to prevent abuse. For high-volume use or custom arrangements, contact us via Telegram.

Something broken?

Join our Telegram support channel for help.