You can use Spotify's Web API to discover music and podcasts, manage your Spotify library, control audio playback, and much more. Browse our available Web API endpoints using the sidebar at left, or via the navigation bar on top of this page on smaller screens. In order to make successful Web API r
Every row below was read from the vendor's own OpenAPI document. The summary text is theirs. What this registry adds is that each operation is indexed with its method, path, base URL and auth scheme, so a search for a capability can answer with a call rather than a name, and that the endpoint is probed on a schedule.
Specifications as held by the APIs.guru corpus, whose newest record is 2023-04-21. Operations the vendor has added since are not listed here; the origin links above are the vendor's own current documents.
base URLs: https://api.spotify.com/v1
auth: o a u t h 2
find it by capability: POST /search {"query":{"text":"..."}} returns these
operations with their invocation detail. Connect any agent client.
You can use Spotify's Web API to discover music and podcasts, manage your Spotify library, control audio playback, and much more. Browse our available Web API endpoints using the sidebar at left, or via the navigation bar on top of this page on smaller screens. In order to make successful Web API requests your app will need a valid access token. One can be obtained through OAuth 2.0. The base UR
| method | path | what the vendor says it does |
|---|---|---|
GET | /albums | Get Several Albums Get Spotify catalog information for multiple albums identified by their Spotify IDs. Albums |
GET | /albums/{id} | Get Album Get Spotify catalog information for a single album. Albums |
GET | /albums/{id}/tracks | Get Album Tracks Get Spotify catalog information about an album’s tracks. Optional parameters can be used to l |
GET | /artists | Get Several Artists Get Spotify catalog information for several artists based on their Spotify IDs. Artists |
GET | /artists/{id} | Get Artist Get Spotify catalog information for a single artist identified by their unique Spotify ID. Artists |
GET | /artists/{id}/albums | Get Artist's Albums Get Spotify catalog information about an artist's albums. Artists Albums |
GET | /artists/{id}/related-artists | Get Artist's Related Artists Get Spotify catalog information about artists similar to a given artist. Similari |
GET | /artists/{id}/top-tracks | Get Artist's Top Tracks Get Spotify catalog information about an artist's top tracks by country. Artists Track |
GET | /audio-analysis/{id} | Get Track's Audio Analysis Get a low-level audio analysis for a track in the Spotify catalog. The audio analys |
GET | /audio-features | Get Tracks' Audio Features Get audio features for multiple tracks based on their Spotify IDs. Tracks |
GET | /audio-features/{id} | Get Track's Audio Features Get audio feature information for a single track identified by its unique Spotify I |
GET | /audiobooks | Get Several Audiobooks Get Spotify catalog information for several audiobooks identified by their Spotify IDs. |
GET | /audiobooks/{id} | Get an Audiobook Get Spotify catalog information for a single audiobook. **Note: Audiobooks are only available |
GET | /audiobooks/{id}/chapters | Get Audiobook Chapters Get Spotify catalog information about an audiobook's chapters. **Note: Audiobooks are o |
GET | /browse/categories | Get Several Browse Categories Get a list of categories used to tag items in Spotify (on, for example, the Spot |
GET | /browse/categories/{category_id} | Get Single Browse Category Get a single category used to tag items in Spotify (on, for example, the Spotify pl |
GET | /browse/categories/{category_id}/playlists | Get Category's Playlists Get a list of Spotify playlists tagged with a particular category. Playlists Categori |
GET | /browse/featured-playlists | Get Featured Playlists Get a list of Spotify featured playlists (shown, for example, on a Spotify player's 'Br |
GET | /browse/new-releases | Get New Releases Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player |
GET | /chapters | Get Several Chapters Get Spotify catalog information for several chapters identified by their Spotify IDs. **N |
GET | /chapters/{id} | Get a Chapter Get Spotify catalog information for a single chapter. **Note: Chapters are only available for th |
GET | /episodes | Get Several Episodes Get Spotify catalog information for several episodes based on their Spotify IDs. Episodes |
GET | /episodes/{id} | Get Episode Get Spotify catalog information for a single episode identified by its unique Spotify ID. Episodes |
GET | /markets | Get Available Markets Get the list of markets where Spotify is available. Markets |
GET | /me | Get Current User's Profile Get detailed profile information about the current user (including the current user |
GET | /me/albums | Get User's Saved Albums Get a list of the albums saved in the current Spotify user's 'Your Music' library. Alb |
PUT | /me/albums | Save Albums for Current User Save one or more albums to the current user's 'Your Music' library. Albums Librar |
DELETE | /me/albums | Remove Users' Saved Albums Remove one or more albums from the current user's 'Your Music' library. Albums Libr |
GET | /me/albums/contains | Check User's Saved Albums Check if one or more albums is already saved in the current Spotify user's 'Your Mus |
GET | /me/audiobooks | Get User's Saved Audiobooks Get a list of the audiobooks saved in the current Spotify user's 'Your Music' libr |
PUT | /me/audiobooks | Save Audiobooks for Current User Save one or more audiobooks to the current Spotify user's library. Audiobooks |
DELETE | /me/audiobooks | Remove User's Saved Audiobooks Remove one or more audiobooks from the Spotify user's library. Audiobooks Libra |
GET | /me/audiobooks/contains | Check User's Saved Audiobooks Check if one or more audiobooks are already saved in the current Spotify user's |
GET | /me/episodes | Get User's Saved Episodes Get a list of the episodes saved in the current Spotify user's library. Episodes Lib |
PUT | /me/episodes | Save Episodes for Current User Save one or more episodes to the current user's library. Episodes Library |
DELETE | /me/episodes | Remove User's Saved Episodes Remove one or more episodes from the current user's library. Episodes Library |
GET | /me/episodes/contains | Check User's Saved Episodes Check if one or more episodes is already saved in the current Spotify user's 'Your |
GET | /me/following | Get Followed Artists Get the current user's followed artists. Users Library Artists |
PUT | /me/following | Follow Artists or Users Add the current user as a follower of one or more artists or other Spotify users. User |
DELETE | /me/following | Unfollow Artists or Users Remove the current user as a follower of one or more artists or other Spotify users. |
and 49 more operation(s) in this specification, all searchable.
specification origin: https://raw.githubusercontent.com/sonallux/spotify-web-api/main/fixed-spotify-open-api.yml
You can use Spotify's Web API to discover music and podcasts, manage your Spotify library, control audio playback, and much more. Browse our available Web API endpoints using the sidebar at left, or via the navigation bar on top of this page on smaller screens. In order to make successful Web API requests your app will need a valid access token. One can be obtained through OAuth 2.0. The base UR
| method | path | what the vendor says it does |
|---|---|---|
GET | /albums | Get Several Albums Get Spotify catalog information for multiple albums identified by their Spotify IDs. Albums |
GET | /albums/{id} | Get Album Get Spotify catalog information for a single album. Albums |
GET | /albums/{id}/tracks | Get Album Tracks Get Spotify catalog information about an album’s tracks. Optional parameters can be used to l |
GET | /artists | Get Several Artists Get Spotify catalog information for several artists based on their Spotify IDs. Artists |
GET | /artists/{id} | Get Artist Get Spotify catalog information for a single artist identified by their unique Spotify ID. Artists |
GET | /artists/{id}/albums | Get Artist's Albums Get Spotify catalog information about an artist's albums. Artists Albums |
GET | /artists/{id}/related-artists | Get Artist's Related Artists Get Spotify catalog information about artists similar to a given artist. Similari |
GET | /artists/{id}/top-tracks | Get Artist's Top Tracks Get Spotify catalog information about an artist's top tracks by country. Artists Track |
GET | /audio-analysis/{id} | Get Track's Audio Analysis Get a low-level audio analysis for a track in the Spotify catalog. The audio analys |
GET | /audio-features | Get Tracks' Audio Features Get audio features for multiple tracks based on their Spotify IDs. Tracks |
GET | /audio-features/{id} | Get Track's Audio Features Get audio feature information for a single track identified by its unique Spotify I |
GET | /audiobooks | Get Several Audiobooks Get Spotify catalog information for several audiobooks identified by their Spotify IDs. |
GET | /audiobooks/{id} | Get an Audiobook Get Spotify catalog information for a single audiobook. **Note: Audiobooks are only available |
GET | /audiobooks/{id}/chapters | Get Audiobook Chapters Get Spotify catalog information about an audiobook's chapters. **Note: Audiobooks are o |
GET | /browse/categories | Get Several Browse Categories Get a list of categories used to tag items in Spotify (on, for example, the Spot |
GET | /browse/categories/{category_id} | Get Single Browse Category Get a single category used to tag items in Spotify (on, for example, the Spotify pl |
GET | /browse/categories/{category_id}/playlists | Get Category's Playlists Get a list of Spotify playlists tagged with a particular category. Playlists Categori |
GET | /browse/featured-playlists | Get Featured Playlists Get a list of Spotify featured playlists (shown, for example, on a Spotify player's 'Br |
GET | /browse/new-releases | Get New Releases Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player |
GET | /chapters | Get Several Chapters Get Spotify catalog information for several chapters identified by their Spotify IDs. **N |
GET | /chapters/{id} | Get a Chapter Get Spotify catalog information for a single chapter. **Note: Chapters are only available for th |
GET | /episodes | Get Several Episodes Get Spotify catalog information for several episodes based on their Spotify IDs. Episodes |
GET | /episodes/{id} | Get Episode Get Spotify catalog information for a single episode identified by its unique Spotify ID. Episodes |
GET | /markets | Get Available Markets Get the list of markets where Spotify is available. Markets |
GET | /me | Get Current User's Profile Get detailed profile information about the current user (including the current user |
GET | /me/albums | Get User's Saved Albums Get a list of the albums saved in the current Spotify user's 'Your Music' library. Alb |
PUT | /me/albums | Save Albums for Current User Save one or more albums to the current user's 'Your Music' library. Albums Librar |
DELETE | /me/albums | Remove Users' Saved Albums Remove one or more albums from the current user's 'Your Music' library. Albums Libr |
GET | /me/albums/contains | Check User's Saved Albums Check if one or more albums is already saved in the current Spotify user's 'Your Mus |
GET | /me/audiobooks | Get User's Saved Audiobooks Get a list of the audiobooks saved in the current Spotify user's 'Your Music' libr |
PUT | /me/audiobooks | Save Audiobooks for Current User Save one or more audiobooks to the current Spotify user's library. Audiobooks |
DELETE | /me/audiobooks | Remove User's Saved Audiobooks Remove one or more audiobooks from the Spotify user's library. Audiobooks Libra |
GET | /me/audiobooks/contains | Check User's Saved Audiobooks Check if one or more audiobooks are already saved in the current Spotify user's |
GET | /me/episodes | Get User's Saved Episodes Get a list of the episodes saved in the current Spotify user's library. Episodes Lib |
PUT | /me/episodes | Save Episodes for Current User Save one or more episodes to the current user's library. Episodes Library |
DELETE | /me/episodes | Remove User's Saved Episodes Remove one or more episodes from the current user's library. Episodes Library |
GET | /me/episodes/contains | Check User's Saved Episodes Check if one or more episodes is already saved in the current Spotify user's 'Your |
GET | /me/following | Get Followed Artists Get the current user's followed artists. Users Library Artists |
PUT | /me/following | Follow Artists or Users Add the current user as a follower of one or more artists or other Spotify users. User |
DELETE | /me/following | Unfollow Artists or Users Remove the current user as a follower of one or more artists or other Spotify users. |
and 48 more operation(s) in this specification, all searchable.
specification origin: https://developer.spotify.com/_data/documentation/web-api/reference/open-api-schema.yml
nothing on this page is a rating, an endorsement or a claim about quality. Reachability is what our probes observed from one network; answering is a floor under usefulness, not a measure of it.