Skip to main content
Each Bunny Stream video can be reached through several stable URL patterns, depending on whether you want the direct play URL, the original file, HLS, or per-resolution files. Use the patterns below to access videos programmatically or in your own player.

Direct play URL

https://player.mediadelivery.net/play/{video_library_id}/{video_id}

Direct play URL example

https://player.mediadelivery.net/play/{video_library_id}/{video_id}?t=30s
This example uses a query parameter which means the direct play URL will start video playback at 30 seconds. For more information about supported query parameters.

Embed URL

https://player.mediadelivery.net/embed/{video_library_id}/{video_id}

Embed URL example

<div style="position:relative;padding-top:56.25%;"><iframe src="https://player.mediadelivery.net/embed/{video_library_id}/{video_id}?autoplay=true&loop=true&muted=true&preload=true&responsive=true" loading="lazy" style="border:0;position:absolute;top:0;height:100%;width:100%;" allow="accelerometer;gyroscope;autoplay;encrypted-media;picture-in-picture;fullscreen;" allowfullscreen="true"></iframe></div>
Embed URL is best for embedding the video player into websites or browser experiences but it requires an iframe. Read more about embedding videos here.

Original file URL

https://{pull_zone}.b-cdn.net/{video_id}/original
Keep original files within your video library encoding settings is required to store your uploaded video file. Read more about it here.

HLS playlist URL

https://{pull_zone}.b-cdn.net/{video_id}/playlist.m3u8

Custom thumbnail URL

https://{pull_zone}.b-cdn.net/{video_id}/{thumbnail_filename}

Default thumbnail URLs

https://{pull_zone}.b-cdn.net/{video_id}/thumbnail.jpg
https://{pull_zone}.b-cdn.net/{video_id}/thumbnail_1.jpg
https://{pull_zone}.b-cdn.net/{video_id}/thumbnail_2.jpg
https://{pull_zone}.b-cdn.net/{video_id}/thumbnail_3.jpg
https://{pull_zone}.b-cdn.net/{video_id}/thumbnail_4.jpg
https://{pull_zone}.b-cdn.net/{video_id}/thumbnail_5.jpg

Player seek thumbnail sprite URLs

https://{pull_zone}.b-cdn.net/{video_id}/seek/{_0}.jpg

Example:

  https://{pull_zone}.b-cdn.net/{video_id}/seek/_0.jpg
  https://{pull_zone}.b-cdn.net/{video_id}/seek/_1.jpg
  https://{pull_zone}.b-cdn.net/{video_id}/seek/_2.jpg
  https://{pull_zone}.b-cdn.net/{video_id}/seek/_3.jpg
Player seek thumbnail sprites appear in the video player timeline, generated every 2s (or every 1s for videos under 10s in duration).Each thumbnail sprite sheet is a 6×6 grid of up to 36 frames, 1800px wide with 300px-wide cells; cell height follows the video’s aspect ratio (e.g. 168px for 16:9).Files are numbered sequentially (_0.jpg, _1.jpg, etc.), each covering up to 36 frames (~72s of video).

Preview animation URL (WebP & Gif)

https://{pull_zone}.b-cdn.net/{video_id}/preview.webp
https://{pull_zone}.b-cdn.net/{video_id}/preview.gif

Preview animation URL high quality (WebM & Mp4)

https://{pull_zone}.b-cdn.net/{video_id}/preview_hq.webm
https://{pull_zone}.b-cdn.net/{video_id}/preview_hq.mp4

MP4 fallback URL

1080p MP4 URL
https://{pull_zone}.b-cdn.net/{video_id}/play_1080p.mp4
720p MP4 URL
https://{pull_zone}.b-cdn.net/{video_id}/play_720p.mp4
360p MP4 URL
https://{pull_zone}.b-cdn.net/{video_id}/play_360p.mp4
240p MP4 URL
https://{pull_zone}.b-cdn.net/{video_id}/play_240p.mp4

Subtitle file URL

https://{pull_zone}.b-cdn.net/{video_id}/captions/{language_code}.vtt