MetaCDN - oEmbed API

This 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. The MetaCDN oEmbed API can be used to allow third party web sites to read meta-data about your content or media.

Get oEmbed meta-data

HTTP Operation:GET
URL: GET http://www.metacdn.com/api/oembed?url={metaCdnUrl}&format={format}&maxwidth={maxwidth}&maxheight={maxheight}
URL Scheme (media): http://www.metacdn.com/r/m/*
URL Scheme (content): http://www.metacdn.com/r/c/*
Auth: None
"Accept" header: application/json+oembed or text/xml+oembed
Expected HTTP response: HTTP/1.1 200 OK
Expected Format (mandatory, optional):

GET /api/oembed?url={metaCdnUrl}&format={json|xml|jsonp}&callback={callback} HTTP/1.1

Notes:

In the examples below the <iframe> ... ... </iframe> code has been abbreviated
JSONP responses can be requested by either specifying format=json and callback={callback}, or simply format=jsonp

Example Call #1:

GET http://www.metacdn.com/api/oembed?url=http://www.metacdn.com/r/m/5RJhVGiSZO/56IX9R&format=json HTTP/1.1
Accept: application/json+oembed

Expected Response #1:

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Accept-Ranges: bytes
Date: Sun, 07 Nov 2010 10:31:20 GMT
Server: Google Frontend
Cache-Control: private, x-gzip-ok=""
Connection: close {
    "version": "1.0",
    "type": "video",
    "provider_name": "MetaCDN",
    "provider_url": "http://www.metacdn.com",
    "width": 426,
    "height": 240,
    "html": "<iframe> ... ... </iframe>",
    "thumbnail_url": "http://lh4.ggpht.com/F8h40vwBtEJ9N1QAyqkSF_ZpapAr1iaum9U7CTvi2TeIRyl-6NgdmmeXATgw8a_KiS-8v5fxL71Fvifwvm8Pcw4qDEVusuw=s426",
    "thumbnail_width": 426,
    "thumbnail_height": 240,
    "title": "My Video",
    "description": "A longer description of my video.",
    "author_name": "joebloggs",
    "author_url": "http://www.metacdn.com/api/users/joebloggs"
}

Example Call #2:

GET http://www.metacdn.com/api/oembed?url=http://www.metacdn.com/r/m/5RJhVGiSZO/56IX9R&format=xml HTTP/1.1
Accept: text/xml+oembed

Expected Response #2:

HTTP/1.1 200 OK
Content-Type: text/xml; charset=UTF-8
Accept-Ranges: bytes
Date: Sun, 07 Nov 2010 12:00:03 GMT
Server: Google Frontend
Cache-Control: private, x-gzip-ok=""
Connection: close

http://www.metacdn.com
My Video
A longer description of my video
joebloggs
426
240
<html><iframe> ... ... </iframe></html>
http://lh4.ggpht.com/F8h40vwBtEJ9N1QAyqkSF_ZpapAr1iaum9U7CTvi2TeIRyl-6NgdmmeXATgw8a_KiS-8v5fxL71Fvifwvm8Pcw4qDEVusuw=s426
426
240
1.0
http://www.metacdn.com/api/users/joebloggs
MetaCDN
video

Example Call #3:

GET http://www.metacdn.com/api/oembed?url=http://www.metacdn.com/r/m/5RJhVGiSZO/56IX9R&format=jsonp HTTP/1.1
Accept: application/json+oembed

Expected Response #3:

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
Accept-Ranges: bytes
Date: Mon, 08 Nov 2010 06:45:08 GMT
Server: Google Frontend
Cache-Control: private, x-gzip-ok=""
Connection: close
callback ({
    "version": "1.0",
    "type": "video",
    "provider_name": "MetaCDN",
    "provider_url": "http://www.metacdn.com",
    "width": 426,"height": 240, 
    "html": "<iframe> ... ... </iframe>",
    "title": "My Video",
    "description": "A longer description of my video",
    "author_name": "joebloggs",
    "author_url": "http://www.metacdn.com/api/users/joebloggs"
});