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:
```plain text 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:
```json
{
"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.
