Add something new to Virb:

Virb

Are you sure you want to delete that?

or Cancel

 

Help Docs

Reach out, touch the stars and get your knowledge on.

oEmbed

Note: Support for this is in Alpha, not ready for production use. Please feel free to give it a try, and let us know about any issues

"oEmbed is a format for allowing an embedded representation of a URL on third party sites. The simple API allows a website to display embedded content (such as photos or videos) when a user posts a link to that resource, without having to parse the resource directly." Find more information about the oEmbed standard.

oEmbed Endpoint

Available formats are xml or json

http://virb.com/services/oembed/1.0/request?format=format

Virb uses any of the following urls:

http://virb.com/*/videos/*
http://virb.com/*/audio/*

Arguments

All arguments are sent as query parameters and must be urlencoded (as per RFC 1738).

url
The URL to the item on Virb
width (optional)
The exact width of the video. Defaults to original size.
maxwidth (optional)
Same as width, but video will not exceed original size.

Example Call

http://virb.com/services/oembed/1.0/request?format=xml&url=http://virb.com/boniver/videos/1731129

Example Responses

These are sample responses

XML

Call:

http://virb.com/services/oembed/1.0/request?format=xml&url=http://virb.com/boniver/videos/1731129

Response:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<oembed>
  <version>1.0</version>
  <type>video</type>
  <provider_name>Virb</provider_name>
  <provider_url>http://virb.com</provider_url>
  <width>430</width>
  <height>380</height>
  <title>Bon Iver performs "Flume" for The Fader</title>
  <html><![CDATA[<object height="380px" width="430px" type="application/x-shockwave-flash" data="http://virb.com/external/video/2438/zyBdDJDOcWOOBJ2pcaQ8dQmTe55B22WQ"><param name="movie" value="http://virb.com/external/video/2438/zyBdDJDOcWOOBJ2pcaQ8dQmTe55B22WQ" /><param name="quality" value="best" /><param name="wmode" value="transparent" /><param name="salign" value="tl" /></object>]]></html>
</oembed>
JSON

Call:

http://virb.com/services/oembed/1.0/request?format=json&url=http://virb.com/boniver/videos/1731129

Response:

{"version":"1.0","type":"video","provider_name":"Virb","provider_url":"http:\/\/virb.com","width":430,"height":380,"title":"Bon Iver performs \"Flume\" for The Fader","html":"<object height=\"380px\" width=\"430px\" type=\"application\/x-shockwave-flash\" data=\"http:\/\/virb.com\/external\/video\/2438\/zyBdDJDOcWOOBJ2pcaQ8dQmTe55B22WQ\"><param name=\"movie\" value=\"http:\/\/virb.com\/external\/video\/2438\/zyBdDJDOcWOOBJ2pcaQ8dQmTe55B22WQ\" \/><param name=\"quality\" value=\"best\" \/><param name=\"wmode\" value=\"transparent\" \/><param name=\"salign\" value=\"tl\" \/><\/object>"}

Help Docs ›

Quick! Get some help: