Embedding with oEmbed Tags

Documentation on Viostream's oEmbed formatting

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.

Creating an oEmbed request

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 customize 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.