oEmbed Service


The oEmbed Service delivers a full media embed code from a URL.

The default output of the oEmbed Service is a JSON encoded string containing the embed code and information about the video (e.g. provider, author, size, thumbnail). Several options can be specified/overruled by issuing query string parameters of which the url query string parameter is compulsory. To obtain an XML response instead of the default JSON response, use the format query string parameter by setting this to format=xml. It’s also possible to change the width and height of the playout and the width and height of the thumbnail image.

The information about the resource provider in the oEmbed output will remain empty unless it is specified through the configuration fields in the publication’s portal.
To set up the provider name and provider url go to the configuration tab in your publication portal and create a field called “providerName” and a field called “providerUrl”.
If you’re not sure where to do this, please send a mail to support@bluebillywig.com asking us to set up the fields for you.

Request
https://<publication>.bbvms.com/oembed/?url=https%3A//<publication>.bbvms.com/p/default/c/<clipId>.html&[Optional Parameters]

Required parameters Description
url The url containing the clip id and playout (e.g. url=https://<publication>.bbvms.com/p/[playout}/c/[clip id].html)
Optional parameters
width Set the width of the embed code
height Set the height of the embed code
thumbWidth Set the width of the thumbnail
thumbHeight Set the height of the thumbnail
format xml or json; Defaults to json
Updated on August 25, 2020

Was this article helpful?

Related Articles