oEmbed - Publishing

Last Updated 4 months ago

oEmbed is a standard (http://oembed.com) for making publishing of content easy.

Any URL to a video page from the Account Console or from the Videosite can be used with the Screen9 oEmbed.

An embed code can be retrieved for any video, but only videos that have moderation set to allowed and are within any publication windows can be accessed.


Please consult your sales representative about activating oEmbed on your account.


API endpoint: http://api.screen9.com/oembed

Supported parameters
format Returned format (json or xml)
maxheight Maximum allowed height of video
maxwidth Maximum allowed width of video
url URL of resource to embed; please note the unsafe and reserved characters in the URL need to be quoted as per RFC-1738, section 2.2.

If maxheight or maxwidth is not set, The height and width of the video is used. Due to the oEmbed specification, the returned embed code is not responsive.

The returned format is always json unless explicitly set to XML. Format may also be specified by Accept headers in the request.

Response fields
height Height of video embed
html Embed code returned
provider_name Name of oEmbed provider
provider_url URL to oEmbed provider
thumbnail_height Thumbnail height
thumbnail_url Url to thumbnail of video
thumbnail_width Thumbnail width
title Title of video
type Type of content: "video"
version oEmbed version: 1.0
width Width of video embed

Example call


A sample response would be:

  "provider_url": "https://www.screen9.com",
  "version": 1.0,
  "thumbnail_width": 160,
  "height": 1080,
  "thumbnail_url": "https://csp.screen9.com/img/thumbnail.jpg",
  "thumbnail_height": 120,
  "title": "ateam onepass vbv 1.0 1.0",
  "width": 1920,
  "html": "",
  "provider_name": "Screen9",
  "type": "video"
This website relies on cookies to function, but no personal data is ever stored in the cookies.

Loading ...