VidSrc API & Embed Documentation

The VidSrc API provides a simple, embeddable video player that streams movies and TV shows from 12+ providers. No API key, no authentication, no rate limits — just construct an iframe URL and embed it.

The API is completely free and designed for developers who want to add video streaming to their projects without building backend infrastructure. Full documentation is available on our homepage.

VidSrc uses TMDB IDs for content identification. Two endpoint patterns are supported:

Customize the player appearance and behavior with URL query parameters:

Parameter	Type	Description
theme	hex	Primary accent color (default: da3633)
autoPlay	boolean	Start playback automatically
poster	boolean	Show cinematic backdrop (default: true)
hideServer	boolean	Disable server selection menu
hideControls	boolean	Hide all player UI controls
startAt	number	Start playback at N seconds
sub	string	Preferred subtitle language code

The VidSrc player emits real-time playback events via the browser's postMessage API. Use these to build watch history, progress tracking, or synchronized viewing features.

window.addEventListener('message', (event) => { if (event.data.type === 'VIDRACK_PLAYER_EVENT') { const { event: name, currentTime, duration } = event.data.data; console.log('Player:', name, currentTime, duration); } });

Events emitted: play, pause, timeupdate, ended, error

For developers interested in streaming source code and how VidSrc works under the hood:

• Provider aggregation — Queries 12+ upstream providers concurrently via SSE and REST APIs
• Source ranking — Sorts providers by latency, quality, and reliability using a weighted scoring algorithm
• HLS proxy — Rewrites m3u8 manifests to handle CORS and header injection transparently
• Intelligent caching — PostgreSQL-backed cache with per-provider TTL and HEAD-check validation
• Failover — Client-side fallback chain: tries sources sequentially, then refetches if all fail

The player frontend uses hls.js for adaptive bitrate streaming with native HLS fallback for Safari. The entire system is built with Next.js API routes and serverless functions.