oEmbed

Paste a share link into a CMS, a chat or a document, and it becomes a player.

Share links

A playlist is shared at /embed/<playlist id> and a single item at /embed/media/<media id> on your share host, optionally with key, player and t. Both pages announce an oEmbed endpoint, so WordPress, Notion, Slack and other consumers find it on their own.

The endpoint

GET /control-plane/api/v1/public/oembed?url=https%3A%2F%2F<share host>%2Fembed%2Fply_…&maxwidth=480&format=json
{
    "version": "1.0",
    "type": "video",
    "title": "Tonight",
    "width": 480,
    "height": 270,
    "html": "<iframe src=\"https://<share host>/embed/ply_…\" width=\"480\" height=\"270\" …></iframe>"
}

The answer is an iframe of the share page, which loads the player through the loader. It never contains a media address: each viewer is held to georestriction, signed delivery and your account's state when the frame plays. maxwidth and maxheight cap the 640×360 default and keep 16:9. A thumbnail is included only for an item with no georestriction whose poster is not a signed address.

Anything it will not describe — another host, an unknown id, an unpublished, scheduled, expired or still-encoding item, an empty playlist, a suspended account — is the same 404, PBP-110190, so the endpoint never reveals that a hidden item exists. A format other than json is 501, PBP-110191.