Staging docs

Embed API

Use VerHDLink public embed paths for the default player, or custom paths when a webmaster needs provider selection, branding options, or exact serial episode targeting.

Quickstart

Give webmasters the complete VerHDLink URL, ready to paste in an iframe. The numeric ID stays in the path, like https://verhdlink.cam/movie/{id}, instead of being shown as a detached ID.

<iframe src="https://verhdlink.cam/movie/{id}" allowfullscreen allow="autoplay; fullscreen; picture-in-picture"></iframe>

<iframe src="https://verhdlink.cam/serial/{id}" allowfullscreen allow="autoplay; fullscreen; picture-in-picture"></iframe>

Default Player

/movie/{id}Embeds a film using the default VerHDLink player. The ID can be a VerHDLink numeric ID or an IMDb ID.

/serial/{id}Embeds a serial using the default VerHDLink player without requiring season and episode in the iframe URL.

Custom Player

<iframe src="https://verhdlink.cam/custom/movie/{id}?color=%23e50914&autoplay=1" allowfullscreen allow="autoplay; fullscreen; picture-in-picture"></iframe>

<iframe src="https://verhdlink.cam/custom/serial/{id}/{season}/{episode}?color=%23e50914&lastserver=dropload" allowfullscreen allow="autoplay; fullscreen; picture-in-picture"></iframe>

/custom/movie/{id}Embeds a film with optional player settings in the query string.

/custom/serial/{id}/{season}/{episode}Embeds one exact serial episode for webmasters who need direct season and episode targeting.

/api/resolveResolves a title to its active sources: returns title, backdrop, IMDb mapping, and the source list as JSON.

/api/providersLists published providers available from the VerHDLink database.

Parameters

autoplayAutoplay is on by default; set to 0 or false to disable it.

mutedMuted is on by default; set to 0 or false to start unmuted.

controlsNative player controls are shown by default; set to 0 to hide them.

lastserverPreferred provider/server ID (alias: prioritize).

Behavior

ID Mapping

Numeric IDs are resolved to IMDb IDs before querying the provider database.

Source Selection

Movie embeds use the active provider hosts available in the VerHDLink database.

Default Serial

The default serial URL stays short as /serial/{id}, matching the public VerHDLink route.

No Store

Embed and API responses are sent with no-cache headers so player state stays fresh.

Player API

The embed exposes window.verhdlinkPlayer with play(), pause(), seek(seconds), getCurrentTime(), getDuration(), getPaused(), and getSource(). From the parent page, call these remotely with postMessage({ type: 'verhdlink:command', command: 'seek', args: [30] }, '*'); the player replies with a verhdlink:response event.

Events

VerHDLink player events:
verhdlink:ready
verhdlink:error
verhdlink:sourceused
verhdlink:response
verhdlink:close
verhdlink:play
verhdlink:pause
verhdlink:seeking
verhdlink:seeked
verhdlink:ended
verhdlink:loadedmetadata
verhdlink:volumechange
verhdlink:ratechange
verhdlink:timeupdate