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.