Skip to main content
GET
Get oEmbed data

Query Parameters

url
string | null

The bunny.net player URL of the video to generate oEmbed data for (legacy iframe.mediadelivery.net or new player.mediadelivery.net player). Both /embed/ and /play/ paths are accepted.

maxWidth
integer<int32> | null

Maximum width in pixels for the embedded player; the player is scaled down to fit while preserving aspect ratio.

maxHeight
integer<int32> | null

Maximum height in pixels for the embedded player; the player is scaled down to fit while preserving aspect ratio.

token
string | null
default:""

Signed access token, required when the video library has token authentication enabled. An allowed referer is checked separately and does not exempt the request from this requirement.

expires
integer<int64>
default:0

Unix timestamp (seconds) the token is valid until, required when the video library has token authentication enabled.

Response

The oEmbed data for the video

version
string | null

The oEmbed spec version implemented by this response. Always "1.0".

title
string | null

The title of the video.

type
string | null

The oEmbed resource type. Always "video" for this endpoint.

thumbnail_url
string | null

The CDN URL of the video's thumbnail image.

thumbnail_width
integer<int32> | null

Width in pixels of the thumbnail image. Omitted for custom-uploaded thumbnails, whose dimensions are not known.

thumbnail_height
integer<int32> | null

Height in pixels of the thumbnail image. Omitted for custom-uploaded thumbnails, whose dimensions are not known.

width
integer<int32>

Width in pixels of the embedded player iframe, scaled to fit within maxWidth/maxHeight while preserving the video's aspect ratio.

height
integer<int32>

Height in pixels of the embedded player iframe, scaled to fit within maxWidth/maxHeight while preserving the video's aspect ratio.

html
string | null

The HTML markup required to embed the video player.

provider_name
string | null

The name of the embed provider. Always "bunny.net".

provider_url
string | null

The URL of the embed provider. Always "https://bunny.net/".

Last modified on September 9, 2026