how-to

How to use Playbuzz oEmbed API

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.

Endpoint URL

//oembed.playbuzz.com/item?id=<your_item_id> or //oembed.playbuzz.com/item?url=<your_item_url>

Parameters

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

Example

All following three requests return the following response.

Request

Response

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