The endpoint returns an item, specified by an item URL or item ID, in an oEmbed-compatible format.
The item URL may be of two forms - //www.playbuzz.com/item/<item-id>
and //www.playbuzz.com/<user-name>/<item-title>
.
The API enables customization of the embedded item by setting parameters to the oEmbed endpoint.
//oembed.playbuzz.com/item?id=<your_item_id>
or
//oembed.playbuzz.com/item?url=<your_item_url>
Parameter | Description | Default |
---|---|---|
id | the id of the item to embed | - |
url | the url of the item to embed | - |
omit-script | do not include script in the html returned | false |
show-share | show share bar above and below the item | true |
show-info | show item cover, title and description | true |
All following three requests return the following response.
//oembed.playbuzz.com/item?id=8fb2343f-fa5d-48d4-8723-f8b5d51cc1a9
//oembed.playbuzz.com/item?url=www.playbuzz.com/item/8fb2343f-fa5d-48d4-8723-f8b5d51cc1a9
//oembed.playbuzz.com/item?url=http://www.playbuzz.com/paolagarcia10/remembering-september-11th-flash-back-to-images-we-will-never-forget
{
author_name: "Paola Garcia",
author_url: "//www.playbuzz.com/paolagarcia10",
html: "<script>(function (d, s, id) {var js, fjs = d.getElementsByTagName(s)[0];if (d.getElementById(id)) return;js = d.createElement(s);js.id = id;js.src = "//embed.playbuzz.com/sdk.js";fjs.parentNode.insertBefore(js, fjs);}(document, 'script', 'playbuzz-sdk'));</script><div class="playbuzz" data-id="8fb2343f-fa5d-48d4-8723-f8b5d51cc1a9"></div>",
provider_name: "Playbuzz",
provider_url: "//www.playbuzz.com",
thumbnail_url: "//cdn.playbuzz.com/cdn/8fb2343f-fa5d-48d4-8723-f8b5d51cc1a9/6868d660-9f42-49c7-bedb-ea6416a56860.jpg",
thumbnail_height: 83,
thumbnail_width: 126,
title: "Remembering September 11th: Flash Back To Images We Will Never Forget",
type: "rich",
url: "//www.playbuzz.com/item/8fb2343f-fa5d-48d4-8723-f8b5d51cc1a9",
version: "1.0"
}