Skip to content
Search, browse and follow podcasts using the new Podcast APIs

Posted March 20, 2020

Josh Brown

A sample app written with podcast API endpoints

Today we are excited to announce the launch of our new Podcast APIs, a set of API features that allow developers to build podcast experiences for Spotify users. You can use the Podcast APIs to search Spotify’s podcast catalog, programmatically follow or unfollow podcasts, and fetch information about episodes and podcast shows. Read on for more information about using the Podcast APIs in your app.

New endpoints

This launch includes nine new Web API endpoints:

Updated endpoints

Three endpoints have been enhanced with new features that support podcasts:


GET https://api.spotify.com/v1/me/player/currently-playing


GET https://api.spotify.com/v1/me/player


These endpoints are now able to return information about a playing podcast episode. Set the type query parameter to episode,track if your client would like to receive information about currently playing tracks and episodes.


GET https://api.spotify.com/v1/search
The search API now returns podcast shows and episodes. Set the type parameter to show or episode to query these new types of content.

A new OAuth scope

The new APIs allow apps to retrieve episode resume points. Resume points tell your app about the user's position in podcast episodes that they've listened to. If your app requires access to this data then you'll want to request our new user-read-playback-position OAuth scope when users install your app. See Using Scopes for more information. Other podcast endpoints rely on existing Spotify scopes, or require no scopes at all.

Tell us what you think

The new podcast API endpoints are in beta. We anticipate that the features available today could be useful for writing apps that import shows to a user's Spotify library, integrations with calendar apps, or social podcasting experiences to help Spotify users share what they're listening to with their friends.

We plan to continue improving our podcasting APIs and we know that you may have suggestions for other APIs you'd like to see. Interested in giving us feedback? Drop us a note at podcasts-api-beta@spotify.com and let us know what Spotify platform features you'd like to see next.