Virb

Documentation

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>"}

Documentation ›

Learn more about Virb:

Quick! Get some help:

Are you sure you want to delete that?