Spreaker API Reference

<!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 API Reference</title> <meta name="description" content="This describes the resources that make up the official Spreaker API v2." />  <meta name="theme-color" content="#2b2e32">  <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 API Reference" /> <meta property="og:description" content="This describes the resources that make up the official Spreaker API v2." /> <meta property="og:image" content="https://developers.spreaker.com/assets/share_picture_default-14fd08b1e96453864723d8a8ae2521d80a27aafb9be46821f95f9e9a3ef654a5.jpg" />  <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">  <link type="text/css" rel="stylesheet" href="/assets/all-0d9972c3c0b2e2bafda864207e3e20faae5282d52a778af56d99bd8a28c5c130.css"> </head> <body>  <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>  <main> <div class="page page_with_sidebar">  <div class="page_content">  <h1 id="api-reference"> API Reference </h1>  <p>This section describes the resources that make up Spreaker’s official APIs v2. If you have any problems or requests in regards to them, please <a href="https://help.spreaker.com">contact our support</a>.</p> <h2 id="quick-reference-users"><a href="/api/users/">Users</a></h2> <table> <thead> <tr> <th>Method</th> <th>URL</th> <th>Functionality</th> </tr> </thead> <tbody> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID</code></td> <td><a href="/api/users/#retrieving-a-single-user">Retrieve a single user</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/me</code></td> <td><a href="/api/users/#retrieving-the-authenticated-user">Retrieve the authenticated user</a></td> </tr> <tr> <td><code>POST</code></td> <td><code>/v2/users/USER-ID</code></td> <td><a href="/api/users/#updating-a-user">Update a user</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/followers</code></td> <td><a href="/api/users/#retrieving-a-users-followers">Retrieve a user’s followers</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/followings</code></td> <td><a href="/api/users/#retrieving-who-a-user-follows">Retrieve who a user follows</a></td> </tr> <tr> <td><code>PUT</code></td> <td><code>/v2/users/USER-ID/followings/FOLLOWING-ID</code></td> <td><a href="/api/users/#following-an-user">Follow a user</a></td> </tr> <tr> <td><code>DELETE</code></td> <td><code>/v2/users/USER-ID/followings/FOLLOWING-ID</code></td> <td><a href="/api/users/#unfollowing-an-user">Unfollow a user</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/blocks</code></td> <td><a href="/api/users/#retrieving-a-users-blocked-users-list">Retrieve a user’s blocked users list</a></td> </tr> <tr> <td><code>PUT</code></td> <td><code>/v2/users/USER-ID/blocks/BLOCKED-ID</code></td> <td><a href="/api/users/#blocking-a-user">Block a user</a></td> </tr> <tr> <td><code>DELETE</code></td> <td><code>/v2/users/USER-ID/blocks/BLOCKED-ID</code></td> <td><a href="/api/users/#unblocking-a-user">Unblock a user</a></td> </tr> </tbody> </table> <h2 id="quick-reference-shows"><a href="/api/shows/">Shows</a></h2> <table> <thead> <tr> <th>Method</th> <th>URL</th> <th>Functionality</th> </tr> </thead> <tbody> <tr> <td><code>GET</code></td> <td><code>/v2/shows/SHOW-ID</code></td> <td><a href="/api/shows/#retrieving-a-single-show">Retrieve a single show</a></td> </tr> <tr> <td><code>POST</code></td> <td><code>/v2/shows/SHOW-ID</code></td> <td><a href="/api/shows/#updating-a-show">Update a show</a></td> </tr> <tr> <td><code>DELETE</code></td> <td><code>/v2/shows/SHOW-ID</code></td> <td><a href="/api/shows/#deleting-a-show">Delete a show</a></td> </tr> <tr> <td><code>POST</code></td> <td><code>/v2/shows</code></td> <td><a href="/api/shows/#creating-a-show">Create a show</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/shows</code></td> <td><a href="/api/shows/#retrieving-a-users-shows">Retrieve a user’s shows</a></td> </tr> <tr> <td><code>PUT</code></td> <td><code>/v2/users/USER-ID/favorites/SHOW-ID</code></td> <td><a href="/api/shows/#adding-a-show-to-favorites">Add a show to Favorites</a></td> </tr> <tr> <td><code>DELETE</code></td> <td><code>/v2/users/USER-ID/favorites/SHOW-ID</code></td> <td><a href="/api/shows/#removing-a-show-from-favorites">Remove a show from Favorites</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/favorites</code></td> <td><a href="/api/shows/#retrieving-favorite-shows">Retrieve favorited shows</a></td> </tr> </tbody> </table> <h2 id="quick-reference-episodes"><a href="/api/episodes/">Episodes</a></h2> <table> <thead> <tr> <th>Method</th> <th>URL</th> <th>Functionality</th> </tr> </thead> <tbody> <tr> <td><code>GET</code></td> <td><code>/v2/episodes/EPISODE-ID</code></td> <td><a href="/api/episodes/#retrieving-a-single-episode">Retrieve a single episode</a></td> </tr> <tr> <td><code>POST</code></td> <td><code>/v2/episodes/EPISODE-ID</code></td> <td><a href="/api/episodes/#updating-an-episode">Update an episode</a></td> </tr> <tr> <td><code>DELETE</code></td> <td><code>/v2/episodes/EPISODE-ID</code></td> <td><a href="/api/episodes/#deleting-an-episode">Delete an episode</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/episodes/EPISODE-ID/download</code></td> <td><a href="/api/episodes/#downloading-an-episode">Download an episode</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/episodes/EPISODE-ID/play</code></td> <td><a href="/api/episodes/#playing-an-episode">Play/stream an episode</a></td> </tr> <tr> <td><code>POST</code></td> <td><code>/v2/shows/SHOW-ID/episodes</code></td> <td><a href="/api/episodes/#uploading-a-recorded-episode">Upload a recorded episode</a></td> </tr> <tr> <td><code>POST</code></td> <td><code>/v2/episodes/drafts</code></td> <td><a href="/api/episodes/#creating-a-draft-episode">Create a draft episode</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/episodes</code></td> <td><a href="/api/episodes/#retrieving-a-users-episodes">Retrieve a user’s episodes</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/shows/SHOW-ID/episodes</code></td> <td><a href="/api/episodes/#retrieving-a-shows-episodes">Retrieve a show’s episodes</a></td> </tr> <tr> <td><code>PUT</code></td> <td><code>/v2/users/USER-ID/likes/EPISODE-ID</code></td> <td><a href="/api/episodes/#adding-an-episode-to-likes">Add an episode to Likes</a></td> </tr> <tr> <td><code>DELETE</code></td> <td><code>/v2/users/USER-ID/likes/EPISODE-ID</code></td> <td><a href="/api/episodes/#removing-an-episode-from-likes">Remove an episode from Likes</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/likes/EPISODE-ID</code></td> <td><a href="/api/episodes/#checking-if-an-user-likes-an-episode">Check if an User likes an Episode</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/likes</code></td> <td><a href="/api/episodes/#retrieving-liked-episodes">Retrieve liked episodes</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/episodes/EPISODE-ID/likes</code></td> <td><a href="/api/episodes/#retrieving-users-that-liked-an-episode">Retrieve users that liked an episode</a></td> </tr> <tr> <td><code>PUT</code></td> <td><code>/v2/users/USER-ID/bookmarks/EPISODE-ID</code></td> <td><a href="/api/episodes/#adding-an-episode-to-bookmarks">Add an episode to your bookmarks</a></td> </tr> <tr> <td><code>DELETE</code></td> <td><code>/v2/users/USER-ID/bookmarks/EPISODE-ID</code></td> <td><a href="/api/episodes/#removing-an-episode-from-bookmarks">Remove an episode from your bookmarks</a></td> </tr> </tbody> </table> <h2 id="quick-reference-episode-messages"><a href="/api/episode-messages/">Episode Messages</a></h2> <table> <thead> <tr> <th>Method</th> <th>URL</th> <th>Functionality</th> </tr> </thead> <tbody> <tr> <td><code>GET</code></td> <td><code>/v2/episodes/EPISODE-ID/messages</code></td> <td><a href="/api/episode-messages/#retrieving-an-episodes-messages">Retrieve an episode’s messages</a></td> </tr> <tr> <td><code>POST</code></td> <td><code>/v2/episodes/EPISODE-ID/messages</code></td> <td><a href="/api/episode-messages/#leaving-a-message">Leave a message</a></td> </tr> <tr> <td><code>DELETE</code></td> <td><code>/v2/episodes/EPISODE-ID/messages/MESSAGE-ID</code></td> <td><a href="/api/episode-messages/#deleting-an-episodes-message">Delete an episode’s message</a></td> </tr> <tr> <td><code>POST</code></td> <td><code>/v2/episodes/EPISODE-ID/messages/MESSAGE-ID/report-abuse</code></td> <td><a href="/api/episode-messages/#reporting-abuse">Report abuse</a></td> </tr> </tbody> </table> <h2 id="quick-reference-episode-chapters"><a href="/api/episode-chapters/">Episode Chapters</a></h2> <table> <thead> <tr> <th>Method</th> <th>URL</th> <th>Functionality</th> </tr> </thead> <tbody> <tr> <td><code>GET</code></td> <td><code>/v2/episodes/EPISODE-ID/chapters</code></td> <td><a href="/api/episode-chapters/#retrieving-an-episodes-chapters">Retrieve an episode’s chapters</a></td> </tr> <tr> <td><code>POST</code></td> <td><code>/v2/episodes/EPISODE-ID/chapters</code></td> <td><a href="/api/episode-chapters/#adding-a-chapter">Add a chapter</a></td> </tr> <tr> <td><code>POST</code></td> <td><code>/v2/episodes/EPISODE-ID/chapters/CHAPTER-ID</code></td> <td><a href="/api/episode-chapters/#updating-a-chapter">Update a chapter</a></td> </tr> <tr> <td><code>DELETE</code></td> <td><code>/v2/episodes/EPISODE-ID/chapters/CHAPTER-ID</code></td> <td><a href="/api/episode-chapters/#deleting-a-single-chapter">Delete a single chapter</a></td> </tr> <tr> <td><code>DELETE</code></td> <td><code>/v2/episodes/EPISODE-ID/chapters</code></td> <td><a href="/api/episode-chapters/#deleting-all-of-the-episodes-chapters">Delete all of the episode’s chapters</a></td> </tr> </tbody> </table> <h2 id="quick-reference-episode-cuepoints"><a href="/api/episode-cuepoints/">Episode Cuepoints</a></h2> <table> <thead> <tr> <th>Method</th> <th>URL</th> <th>Functionality</th> </tr> </thead> <tbody> <tr> <td><code>GET</code></td> <td><code>/v2/episodes/EPISODE-ID/cuepoints</code></td> <td><a href="/api/episode-cuepoints/#retrieving-an-episodes-cuepoints">Retrieve an episode’s cuepoints</a></td> </tr> <tr> <td><code>POST</code></td> <td><code>/v2/episodes/EPISODE-ID/cuepoints</code></td> <td><a href="/api/episode-cuepoints/#updating-an-episodes-cuepoints">Update an episode’s cuepoints</a></td> </tr> <tr> <td><code>DELETE</code></td> <td><code>/v2/episodes/EPISODE-ID/cuepoints</code></td> <td><a href="/api/episode-cuepoints/#deleting-all-of-the-episodes-cuepoints">Delete all of the episode’s cuepoints</a></td> </tr> </tbody> </table> <h2 id="quick-reference-statistics"><a href="/api/statistics/">Statistics</a></h2> <h3 id="user-statistics">User Statistics</h3> <table> <thead> <tr> <th>Method</th> <th>URL</th> <th>Functionality</th> </tr> </thead> <tbody> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/statistics</code></td> <td><a href="/api/statistics/#retrieving-a-users-overall-statistics">Retrieve a User’s Overall Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/statistics/plays</code></td> <td><a href="/api/statistics/#retrieving-a-users-play-statistics">Retrieve a User’s Play Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/statistics/likes</code></td> <td><a href="/api/statistics/#retrieving-a-users-likes-statistics">Retrieve a User’s Likes Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/statistics/followers</code></td> <td><a href="/api/statistics/#retrieving-a-users-followers-statistics">Retrieve a User’s Followers Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/statistics/sources</code></td> <td><a href="/api/statistics/#retrieving-a-users-sources-statistics">Retrieve a User’s Sources Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/statistics/devices</code></td> <td><a href="/api/statistics/#retrieving-a-users-devices-statistics">Retrieve a User’s Devices Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/statistics/os</code></td> <td><a href="/api/statistics/#retrieving-a-users-operating-systems-statistics">Retrieve a User’s Operating Systems Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/statistics/geographics</code></td> <td><a href="/api/statistics/#retrieving-a-users-geographic-statistics">Retrieve a User’s Geographic Statistics</a></td> </tr> </tbody> </table> <h3 id="show-statistics">Show Statistics</h3> <table> <thead> <tr> <th>Method</th> <th>URL</th> <th>Functionality</th> </tr> </thead> <tbody> <tr> <td><code>GET</code></td> <td><code>/v2/shows/SHOW-ID/statistics</code></td> <td><a href="/api/statistics/#retrieving-a-shows-overall-statistics">Retrieve a Show’s Overall Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/shows/SHOW-ID/statistics/plays</code></td> <td><a href="/api/statistics/#retrieving-a-shows-play-statistics">Retrieve a Show’s Play Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/shows/SHOW-ID/statistics/likes</code></td> <td><a href="/api/statistics/#retrieving-a-shows-likes-statistics">Retrieve a Show’s Likes Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/shows/SHOW-ID/statistics/sources</code></td> <td><a href="/api/statistics/#retrieving-a-shows-sources-statistics">Retrieve a Show’s Sources Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/shows/SHOW-ID/statistics/devices</code></td> <td><a href="/api/statistics/#retrieving-a-shows-devices-statistics">Retrieve a Show’s Devices Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/shows/SHOW-ID/statistics/os</code></td> <td><a href="/api/statistics/#retrieving-a-shows-operating-systems-statistics">Retrieve a Show’s Operating Systems Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/shows/SHOW-ID/statistics/geographics</code></td> <td><a href="/api/statistics/#retrieving-a-shows-geographic-statistics">Retrieve a Show’s Geographic Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/users/USER-ID/shows/statistics/plays/totals</code></td> <td><a href="/api/statistics/#retrieving-a-users-shows-total-play-statistics">Retrieve a User’s Shows’ Total Play Statistics</a></td> </tr> </tbody> </table> <h3 id="episode-statistics">Episode Statistics</h3> <table> <thead> <tr> <th>Method</th> <th>URL</th> <th>Functionality</th> </tr> </thead> <tbody> <tr> <td><code>GET</code></td> <td><code>/v2/episodes/EPISODE-ID/statistics</code></td> <td><a href="/api/statistics/#retrieving-an-episodes-overall-statistics">Retrieve an Episode’s Overall Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/episodes/EPISODE-ID/statistics/plays</code></td> <td><a href="/api/statistics/#retrieving-an-episodes-play-statistics">Retrieve an Episode’s Play Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/episodes/EPISODE-ID/statistics/likes</code></td> <td><a href="/api/statistics/#retrieving-an-episodes-likes-statistics">Retrieve an Episode’s Likes Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/episodes/EPISODE-ID/statistics/sources</code></td> <td><a href="/api/statistics/#retrieving-an-episodes-sources-statistics">Retrieve an Episode’s Sources Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/episodes/EPISODE-ID/statistics/devices</code></td> <td><a href="/api/statistics/#retrieving-an-episodes-devices-statistics">Retrieve an Episode’s Devices Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/episodes/EPISODE-ID/statistics/os</code></td> <td><a href="/api/statistics/#retrieving-an-episodes-operating-systems-statistics">Retrieve an Episode’s Operating Systems Statistics</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/shows/SHOW-ID/episodes/statistics/plays/totals</code></td> <td><a href="/api/statistics/#retrieving-a-shows-episodes-total-play-statistics">Retrieve a Show’s Episodes’ Total Play Statistics</a></td> </tr> </tbody> </table> <h2 id="quick-reference-search"><a href="/api/search/">Search</a></h2> <table> <thead> <tr> <th>Method</th> <th>URL</th> <th>Functionality</th> </tr> </thead> <tbody> <tr> <td><code>GET</code></td> <td><code>/v2/search?type=shows</code></td> <td><a href="/api/search/#searching-shows">Search shows</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/search?type=episodes</code></td> <td><a href="/api/search/#searching-episodes">Search episodes</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/search/users/USER-ID?type=shows</code></td> <td><a href="/api/search/#searching-shows-by-author">Search shows by author</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/search/users/USER-ID?type=episodes</code></td> <td><a href="/api/search/#searching-episodes-by-author">Search episodes by author</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/search/shows/SHOW-ID?type=episodes</code></td> <td><a href="/api/search/#searching-episodes-by-show">Search episodes by show</a></td> </tr> </tbody> </table> <h2 id="quick-reference-explore"><a href="/api/explore/">Explore</a></h2> <table> <thead> <tr> <th>Method</th> <th>URL</th> <th>Functionality</th> </tr> </thead> <tbody> <tr> <td><code>GET</code></td> <td><code>/v2/explore/lists</code></td> <td><a href="/api/explore/#retrieving-curated-lists">Retrieve Curated Lists</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/explore/lists/LIST-ID</code></td> <td><a href="/api/explore/#retrieving-a-single-curated-list">Retrieve a Single Curated List</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/explore/lists/LIST-ID/items</code></td> <td><a href="/api/explore/#retrieving-a-curated-lists-items">Retrieve a Curated List’s Items</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/explore/categories/CATEGORY-ID/items</code></td> <td><a href="/api/explore/#retrieving-a-categorys-items">Retrieving a Category’s items</a></td> </tr> </tbody> </table> <h2 id="quick-reference-tags"><a href="/api/tags/">Tags</a></h2> <table> <thead> <tr> <th>Method</th> <th>URL</th> <th>Functionality</th> </tr> </thead> <tbody> <tr> <td><code>GET</code></td> <td><code>/v2/tags/TAG-NAME/episodes</code></td> <td><a href="/api/tags/#retrieve-the-latest-episodes-by-tag-name">Retrieve the Latest Episodes by Tag name</a></td> </tr> </tbody> </table> <h2 id="quick-reference-miscellaneous"><a href="/api/miscellaneous/">Miscellaneous</a></h2> <table> <thead> <tr> <th>Method</th> <th>URL</th> <th>Functionality</th> </tr> </thead> <tbody> <tr> <td><code>GET</code></td> <td><code>/v2/show-categories</code></td> <td><a href="/api/miscellaneous/#list-of-show-categories">List of show categories</a></td> </tr> <tr> <td><code>GET</code></td> <td><code>/v2/show-languages</code></td> <td><a href="/api/miscellaneous/#list-of-show-languages">List of show languages</a></td> </tr> </tbody> </table> <h2 id="quick-reference-widget"><a href="/guides/embedding-the-widget">Widgets</a></h2> <p>The widget is a player you can embed in your own website or blog. The easiest way to configure the widget and generate the markup to embed is through our <a href="https://www.spreaker.com/cms/shows">CMS</a> but there’s some people who needs to manually generate it or control it via JavaScript, so we’ve created a <a href="/guides/embedding-the-widget">dedicated guide</a>.</p> <table> <thead> <tr> <th>Method</th> <th>URL</th> <th>Functionality</th> </tr> </thead> <tbody> <tr> <td><code>GET</code></td> <td><code>/oembed</code></td> <td><a href="/api/widgets/#oembed-provider">oEmbed Provider</a></td> </tr> </tbody> </table> </div>  <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> </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> <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 2025 - Spreaker Inc. - New York, NY</small> </footer> </body> </html>

CINXE.COM

Spreaker API Reference