Video embed API

Video embed API
for movie and TV streaming

Embeddable video player with adaptive HLS playback, 40+ OpenSubtitles languages, audio-based subtitle sync, automatic server failover, and a TV episode drawer.

Signed proxy & CDN caching
40+ OpenSubtitles languages
250ms auto-failover
Iframe and JSON manifest API
Live preview

Test the player in your browser

Try HLS playback, subtitle selection, episode switching, and custom player controls.

Presets:
https://apiplayer.ru/embed/movie/746036?autoplay=1&lang=en
Embed code generator

Configure and copy an embed

Set media IDs, subtitle language, server selection, and theme color to generate an iframe or API request.

Direct streaming URL

Architecture

How the player works

Stream resolution, subtitle handling, and caching across the embed player and proxy nodes.

Adaptive HLS stream pipeline

Rewrites upstream HLS playlists through signed proxy or edge CDN URLs while passing CORS headers and upstream session cookies.

OpenSubtitles and audio sync

Loads 40+ subtitle languages from OpenSubtitles, converts SRT to WebVTT, translates tracks on demand, and aligns cue timing against dialogue audio.

250ms automatic failover

Races multiple providers during initial resolution and switches to the next available server in 250ms if playback stalls or returns an error.

TV episode drawer and prewarming

Includes an in-player season and episode selector, prewarms the next episode at 95% playback progress, and shows a countdown prompt before the episode ends.

Resume memory and deep linking

Saves playback progress in local storage across sessions and supports timestamp query parameters such as start=120.

Request coalescing and locking

Deduplicates concurrent browser harvest jobs in the Node queue and uses file locks with atomic writes for shared disk caches.

Developer reference

Query parameters

Configure playback, subtitle selection, UI localization, and accent color via URL query parameters.

Parameter Type Accepted values Description
autoplay boolean 1, 0, true, false Controls whether playback starts automatically. Defaults to 1.
lang / ds_lang string en, es, ru, ar, fr, de, pt, tr, it, hi Selects the matching subtitle track and localizes player UI text into the target language.
resume string|int 0 (disable), 1 (prompt), auto (direct seek) Controls saved timestamp resume behavior. Set to 0 to always start at 00:00.
start / t integer Seconds (e.g. 45, 120, 300) Seeks to the specified timestamp when the stream is ready.
server / s string s2, s1, s5 Selects the initial streaming provider on load.
color / theme hex string 38bdf8, e11d48, 10b981 Applies a custom accent color to buttons, badges, and the progress bar.
muted boolean 1, true Starts playback muted for mobile autoplay policies.
Integration routes

URL routes and manifest API

Embed the player directly by URL path or query the JSON manifest endpoint for custom video players.

Movie embed routes

# TMDB ID
https://apiplayer.ru/embed/movie/746036

# IMDb ID
https://apiplayer.ru/embed/movie/tt1684562

# Shorthand route
https://apiplayer.ru/embed/746036

TV show embed routes

# TMDB format: /embed/tv/{id}/{season}/{episode}
https://apiplayer.ru/embed/tv/2004/1/2

# IMDb format: /embed/tv/{imdb_id}/{season}/{episode}
https://apiplayer.ru/embed/tv/tt0212671/1/2

JSON manifest API for custom players

Fetch HLS sources, stream URLs, and WebVTT subtitle tracks as JSON for Plyr, Video.js, ExoPlayer, or AVPlayer.

GET https://apiplayer.ru/manifest.php?path=/embed/movie/746036&server=s2&vid=v_user123
Embed snippet copied to clipboard.