Skip to main content

Embedding with oEmbed Tags

oEmbed is a format for allowing embedding of URLs on third party website. The simple API allows a website to display embedded content from Viostream.

You can view the full specification here.

Embedding with oEmbed​

For supported oEmbed platforms, you can simply copy the  Share link for your video and paste it into the platform. The platform will then generate the embed code for you and seamlessly display your video.

Customising your oEmbed request​

For advanced users, the oEmbed endpoint can be accessed directly. Here is an example of the expected request:

https://play.viostream.com/oembed?url=https%3A%2F%2Fshare.viostream.com%2F[mediakey]

Note: Replace [mediakey] with the media you wish to embed.

The response should look like the following:

{
  "type": "video",
  "version": "1.0",
  "html": "<iframe width=\"640\" height=\"360\" … ></iframe>",
  "width": 640,
  "height": 360,
  "provider_name": "Viostream",
  "provider_url": "https://www.viostream.com/"
}

Additional parameters​

You can customise your oEmbed with the following query parameters:

format​

Viostream supports both json and xml oEmbed formats (default json).

maxwidth​

Allows you to control the maximum width of your video (in pixels). Minimum allowable value is 256 (default 640).

maxheight​

Allows you to control the maximum height of your video (in pixels). Minimum allowable value is 144 (default 360).

Need help?​

If you have any further questions on oEmbed formatting, please contact Customer Success from within the platform's live chat.