CINXE.COM
Spreaker for Developers
<!DOCTYPE html> <html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml"> <head> <meta charset='utf-8'> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no" /> <title>Spreaker for Developers</title> <meta name="description" content="Spreaker API Reference and Guides" /> <!-- Theme color --> <meta name="theme-color" content="#2b2e32"> <!-- Facebook --> <meta property="fb:app_id" content="215002133707" /> <meta property="og:site_name" content="Spreaker for Developers" /> <meta property="og:type" content="article" /> <meta property="og:title" content="Spreaker for Developers" /> <meta property="og:description" content="Spreaker API Reference and Guides" /> <meta property="og:image" content="https://developers.spreaker.com/assets/share_picture_default-14fd08b1e96453864723d8a8ae2521d80a27aafb9be46821f95f9e9a3ef654a5.jpg" /> <!-- Favicon --> <link rel="apple-touch-icon" sizes="57x57" href="https://developers.spreaker.com/assets/favicon/apple-icon-57x57-b276c120fcd029c7b1017d275d711b79ee5bb6e29e54baf265f8d6f2b794ad4c.png"> <link rel="apple-touch-icon" sizes="60x60" href="https://developers.spreaker.com/assets/favicon/apple-icon-60x60-24a615764e329edaa3189e292fa8e65e1d20ee3a15558a8f1b421a74ee595c96.png"> <link rel="apple-touch-icon" sizes="72x72" href="https://developers.spreaker.com/assets/favicon/apple-icon-72x72-6f8c7becbddbcb63a3a707f83a32f5300228c4a3476696d7c107fdf50c459bc7.png"> <link rel="apple-touch-icon" sizes="76x76" href="https://developers.spreaker.com/assets/favicon/apple-icon-76x76-0d4bcbc5ee09aac893e27d05398ef76b16517bfdadfa8c8fe853ac07fb3ee414.png"> <link rel="apple-touch-icon" sizes="114x114" href="https://developers.spreaker.com/assets/favicon/apple-icon-114x114-ab7356f8ad7fbdf13cb9ee9fd48c710dff76c1c5884f07f7bd400fc3458225ed.png"> <link rel="apple-touch-icon" sizes="120x120" href="https://developers.spreaker.com/assets/favicon/apple-icon-120x120-7b780e00c482712d068a4681eb1ec8bec1dae4158b9a8ce54ffac26f9bbef852.png"> <link rel="apple-touch-icon" sizes="144x144" href="https://developers.spreaker.com/assets/favicon/apple-icon-144x144-589692ddbc9404f9531584fa90f6a84709f89ae0870f216a73b3b9b2c9292fad.png"> <link rel="apple-touch-icon" sizes="152x152" href="https://developers.spreaker.com/assets/favicon/apple-icon-152x152-a82061a36d11cff67363fb902dce448c13d5780afd3341ffc1b77c0541821903.png"> <link rel="apple-touch-icon" sizes="180x180" href="https://developers.spreaker.com/assets/favicon/apple-icon-180x180-05c3c16650de1ff094cfa4bc79437a20afc2fa9ab0dbe418360d949fc8fc7b27.png"> <link rel="icon" type="image/png" sizes="192x192" href="https://developers.spreaker.com/assets/favicon/android-icon-192x192-15aee1271338376079efb14758fed72ec4b5f141322a8bdfca7806d7f142a4cd.png"> <link rel="icon" type="image/png" sizes="32x32" href="https://developers.spreaker.com/assets/favicon/favicon-32x32-1730b74ab227bb2f65ba1aa095fa2f7b3cdf65f2edb422c9761e22ea9a6a6df5.png"> <link rel="icon" type="image/png" sizes="96x96" href="https://developers.spreaker.com/assets/favicon/favicon-96x96-d6825e13beecae90c201bab1e467b027804a2c53175a1f9020eb83caa2b9e9e8.png"> <link rel="icon" type="image/png" sizes="16x16" href="https://developers.spreaker.com/assets/favicon/favicon-16x16-0abbd9089e7aa3d4fef4ded2d344c0e1c0457c3d90c67fc80567623d8c856408.png"> <meta name="msapplication-TileImage" content="https://developers.spreaker.com/assets/favicon/ms-icon-144x144-589692ddbc9404f9531584fa90f6a84709f89ae0870f216a73b3b9b2c9292fad.png"> <!-- CSS --> <link type="text/css" rel="stylesheet" href="/assets/all-0d9972c3c0b2e2bafda864207e3e20faae5282d52a778af56d99bd8a28c5c130.css"> </head> <body> <!-- Header --> <header> <nav class="hd_nav"> <a class="hd_logo" href="/">Spreaker for Developers</a> <ul class="hd_menu"> <li><a href="/api/">API</a></li> <li><a href="/guides/">Guides</a></li> <li><a href="https://help.spreaker.com" target="_blank">Support</a></li> </ul> </nav> </header> <!-- Content --> <main> <div class="page page_with_sidebar"> <!-- Content --> <div class="page_content"> <!-- <div class="announcement"> <p>Interested in working with us? We offer a superb REMOTE work opportunity for a DEVOP.</p> <p><a target="_blank" href="https://www.spreaker.com/jobs/devop">Click here to find out more.</a></p> </div> --> <h1 id="widgets"> <a href="/api/">API</a>: Widgets </h1> <div class="page_content_toc"> <h2>In this page</h2> <ul class="section-nav"> <li class="toc-entry toc-h2"><a href="#oembed-provider">oEmbed Provider</a></li> <li class="toc-entry toc-h4"><a href="#example">Example</a></li> </ul> </div> <h2 id="oembed-provider">oEmbed Provider</h2> <figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span></span>GET /oembed</code></pre></figure> <p>oEmbed is an open standard to easily embed content on third party sites. This simple API allows a website to display the <a href="/guides/embedding-the-player/">Embedded Player</a> 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 <a href="http://oembed.com">oembed.com</a>.</p> <h4 id="example">Example</h4> <figure class="highlight"><pre><code class="language-bash" data-lang="bash"><span></span>curl <span class="s2">"https://api.spreaker.com/oembed?url=https://www.spreaker.com/show/jamie-lees-show"</span></code></pre></figure> <p>The response body will contain an oEmbed <code>rich</code> content, with the <code>html</code> code to display the Embedded Player for the input resource URL:</p> <figure class="highlight"><pre><code class="language-json" data-lang="json"><span></span><span class="p">{</span> <span class="nt">"type"</span><span class="p">:</span> <span class="s2">"rich"</span><span class="p">,</span> <span class="nt">"version"</span><span class="p">:</span> <span class="s2">"1.0"</span><span class="p">,</span> <span class="nt">"provider_name"</span><span class="p">:</span> <span class="s2">"Spreaker"</span><span class="p">,</span> <span class="nt">"provider_url"</span><span class="p">:</span> <span class="s2">"https://www.spreaker.com/"</span><span class="p">,</span> <span class="nt">"title"</span><span class="p">:</span> <span class="s2">"Jamie Lee's Best of the Worst"</span><span class="p">,</span> <span class="nt">"author_name"</span><span class="p">:</span> <span class="s2">"Jamie Lee"</span><span class="p">,</span> <span class="nt">"author_url"</span><span class="p">:</span> <span class="s2">"https://www.spreaker.com/user/jamielee"</span><span class="p">,</span> <span class="nt">"html"</span><span class="p">:</span> <span class="s2">"<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>"</span><span class="p">,</span> <span class="nt">"width"</span><span class="p">:</span> <span class="s2">"100%"</span><span class="p">,</span> <span class="nt">"height"</span><span class="p">:</span> <span class="mi">500</span><span class="p">,</span> <span class="nt">"thumbnail_url"</span><span class="p">:</span> <span class="s2">"https://d3wo5wojvuv7l.cloudfront.net/t_widget_player_cover_medium/images.spreaker.com/original/b6bee332d0d2fbda5f5791ab0388c6cc.jpg"</span> <span class="p">}</span></code></pre></figure> </div> <!-- Menu --> <nav id="page_menu" class="page_menu"> <div class="page_menu_item"> <h2><a href="/api/">API</a></h2> <h3>Complete API Reference</h3> <ul> <li> <h4><a href="/api/users/" title="Users">Users</a></h4> </li> <li> <h4><a href="/api/shows/" title="Shows">Shows</a></h4> </li> <li> <h4><a href="/api/show-rss-metadata/" title="Show RSS Metadata">Show RSS Metadata</a></h4> </li> <li> <h4><a href="/api/episodes/" title="Episodes">Episodes</a></h4> </li> <li> <h4><a href="/api/episode-messages/" title="Episode Messages">Episode Messages</a></h4> </li> <li> <h4><a href="/api/episode-chapters/" title="Episode Chapters">Episode Chapters</a></h4> </li> <li> <h4><a href="/api/episode-cuepoints/" title="Episode Cuepoints">Episode Cuepoints</a></h4> </li> <li> <h4><a href="/api/statistics/" title="Statistics">Statistics</a></h4> </li> <li> <h4><a href="/api/search/" title="Search">Search</a></h4> </li> <li> <h4><a href="/api/explore/" title="Explore">Explore</a></h4> </li> <li> <h4><a href="/api/tags/" title="Tags">Tags</a></h4> </li> <li> <h4><a href="/api/widgets/" title="Widgets">Widgets</a></h4> <ul class="section-nav"> <li class="toc-entry toc-h2"><a href="#oembed-provider">oEmbed Provider</a></li> <li class="toc-entry toc-h4"><a href="#example">Example</a></li> </ul> </li> <li> <h4><a href="/api/miscellaneous/" title="Miscellaneous">Miscellaneous</a></h4> </li> </ul> </div> <div class="page_menu_item"> <h2><a href="/guides/">GUIDES</a></h2> <h3>Getting Started Guides</h3> <ul> <li> <h4><a href="/guides/overview/" title="Overview">Overview</a></h4> </li> <li> <h4><a href="/guides/authentication/" title="Authentication">Authentication</a></h4> </li> <li> <h4><a href="/guides/upload-an-episode/" title="Upload an episode">Upload an episode</a></h4> </li> <li> <h4><a href="/guides/manage-your-shows/" title="Manage your Shows">Manage your Shows</a></h4> </li> <li> <h4><a href="/guides/manage-your-episodes/" title="Manage Your Episodes">Manage Your Episodes</a></h4> </li> <li> <h4><a href="/guides/working-with-draft-episodes/" title="Working with Draft Episodes">Working with Draft Episodes</a></h4> </li> <li> <h4><a href="/guides/displaying-the-episode-s-waveform/" title="Displaying the Episode's Waveform">Displaying the Episode's Waveform</a></h4> </li> <li> <h4><a href="/guides/embedding-the-player/" title="Embedding the Player">Embedding the Player</a></h4> </li> <li> <h4><a href="/guides/user-agent-format/" title="User Agent format">User Agent format</a></h4> </li> <li> <h4><a href="/guides/terminology/" title="Terminology">Terminology</a></h4> </li> </ul> </div> </nav> </div> </main> <!-- Footer --> <footer> <ul class="ft_links"> <li><a href="https://www.spreaker.com">Spreaker</a></li> <li><a href="https://www.spreaker.com/terms">Terms</a></li> <li><a href="https://www.spreaker.com/privacy">Privacy</a></li> <li><a href="https://help.spreaker.com">Support</a></li> <li><a href="https://status.spreaker.com">Status</a></li> </ul> <small class="ft_copyright">Copyright 2024 - Spreaker Inc. - New York, NY</small> </footer> </body> </html>