API: Widgets

In this page

oEmbed Provider

GET /oembed

oEmbed is an open standard to easily embed content on third party sites. This simple API allows a website to display the Embedded Player given an URL to a playable resource on the Spreaker website (ie. user page, show page or episode page). To find out more about the oEmbed standard, have a look at oembed.com.

Example

curl "https://api.spreaker.com/oembed?url=https://www.spreaker.com/show/jamie-lees-show"

The response body will contain an oEmbed rich content, with the html code to display the Embedded Player for the input resource URL:

{
    "type": "rich",
    "version": "1.0",
    "provider_name": "Spreaker",
    "provider_url": "https://www.spreaker.com/",
    "title": "Jamie Lee's Best of the Worst",
    "author_name": "Jamie Lee",
    "author_url": "https://www.spreaker.com/user/jamielee",
    "html": "<iframe src=\"https://widget.spreaker.com/player?show_id=1928929&amp;theme=light&amp;cover_image_url=https%3A%2F%2Fd3wo5wojvuv7l.cloudfront.net%2Fimages.spreaker.com%2Foriginal%2Fb6bee332d0d2fbda5f5791ab0388c6cc.jpg&amp;playlist=true\" width=\"100%\" height=\"500\" frameborder=\"0\"></iframe>",
    "width": "100%",
    "height": 500,
    "thumbnail_url": "https://d3wo5wojvuv7l.cloudfront.net/t_widget_player_cover_medium/images.spreaker.com/original/b6bee332d0d2fbda5f5791ab0388c6cc.jpg"
}