Spotify

Add one or more items to a user's playlist.

Add an item to be played next in the user's current playback queue. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.

**Deprecated:** Use [Add Items to Playlist](/documentation/web-api/reference/add-items-to-playlist) instead. Add one or more items to a user's playlist.

Change a playlist's name and public/private state. (The user must, of course, own the playlist.)

Check to see if the current user is following one or more artists or other Spotify users. **Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.

Check to see if the current user is following a specified playlist. **Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.

Check if one or more items are already saved in the current user's library. Accepts Spotify URIs for tracks, albums, episodes, shows, audiobooks, artists, users, and playlists.

Check if one or more albums is already saved in the current Spotify user's 'Your Music' library. **Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.

Check if one or more audiobooks are already saved in the current Spotify user's library. **Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.

Check if one or more episodes is already saved in the current Spotify user's 'Your Episodes' library. **Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.

Check if one or more shows is already saved in the current Spotify user's library. **Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.

Check if one or more tracks is already saved in the current Spotify user's 'Your Music' library. **Note:** This endpoint is deprecated. Use [Check User's Saved Items](/documentation/web-api/reference/check-library-contains) instead.

Create a playlist for the current Spotify user. (The playlist will be empty until you [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).) Each user is generally limited to a maximum of 11000 playlists.

**Deprecated**: Use [Create Playlist](/documentation/web-api/reference/create-playlist) instead. Create a playlist for a Spotify user. (The playlist will be empty until you [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).) Each user is generally limited to a maximum of 11000 playlists.

Add the current user as a follower of one or more artists or other Spotify users. **Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.

Add the current user as a follower of a playlist. **Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.

Get a list of Spotify playlists tagged with a particular category.

Get a single category used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).

Get Spotify catalog information for a single audiobook chapter. Chapters are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.

Get a list of the playlists owned or followed by the current Spotify user.

Get Spotify catalog information for a single show identified by its unique Spotify ID.

Get Spotify catalog information about an show’s episodes. Optional parameters can be used to limit the number of episodes returned.

Get information about a user’s available Spotify Connect devices. Some device models are not supported and will not be listed in the API response.

Get Spotify catalog information for a single album.

Get Spotify catalog information about an album’s tracks. Optional parameters can be used to limit the number of tracks returned.

Get Spotify catalog information for a single artist identified by their unique Spotify ID.

Get Spotify catalog information about an artist's albums.

Get Spotify catalog information about artists similar to a given artist. Similarity is based on analysis of the Spotify community's listening history.

Get Spotify catalog information about an artist's top tracks by country.

Get Spotify catalog information for a single audiobook. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.

Get Spotify catalog information for a single episode identified by its unique Spotify ID.

Get a low-level audio analysis for a track in the Spotify catalog. The audio analysis describes the track’s structure and musical content, including rhythm, pitch, and timbre.

Get audio feature information for a single track identified by its unique Spotify ID.

Get Spotify catalog information about an audiobook's chapters. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.

Get the list of markets where Spotify is available.

Get a list of categories used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).

Get detailed profile information about the current user (including the current user's username).

Get a list of Spotify featured playlists (shown, for example, on a Spotify player's 'Browse' tab).

Get the current user's followed artists.

Get information about the user’s current playback state, including track or episode, progress, and active device.

Get a list of the playlists owned or followed by a Spotify user.

Get Spotify catalog information for multiple albums identified by their Spotify IDs.

Get Spotify catalog information for several artists based on their Spotify IDs.

Get Spotify catalog information for several audiobooks identified by their Spotify IDs. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.

Get Spotify catalog information for several episodes based on their Spotify IDs.

Get Spotify catalog information for several shows based on their Spotify IDs.

Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player’s “Browse” tab).

Get a playlist owned by a Spotify user.

Get the current image associated with a specific playlist.

Get full details of the items of a playlist owned by a Spotify user. **Note**: This endpoint is only accessible for playlists owned by the current user or playlists the user is a collaborator of. A `403 Forbidden` status code will be returned if the user is neither the owner nor a collaborator of the playlist.

**Deprecated:** Use [Get Playlist Items](/documentation/web-api/reference/get-playlists-items) instead. Get full details of the items of a playlist owned by a Spotify user.

Get the list of objects that make up the user's queue.

Get tracks from the current user's recently played tracks. _**Note**: Currently doesn't support podcast episodes._

Retrieve a list of available genres seed parameter values for [recommendations](/documentation/web-api/reference/get-recommendations).

Recommendations are generated based on the available information for a given seed entity and matched against similar artists and tracks. If there is sufficient information about the provided seeds, a list of tracks will be returned together with pool size details. For artists and tracks that are very new or obscure there might not be enough data to generate a list of tracks.

Get audio features for multiple tracks based on their Spotify IDs.

Get Spotify catalog information for several audiobook chapters identified by their Spotify IDs. Chapters are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.

Get Spotify catalog information for multiple tracks based on their Spotify IDs.

Get the object currently being played on the user's Spotify account.

Get Spotify catalog information for a single track identified by its unique Spotify ID.

Get public profile information about a Spotify user.

Get a list of the albums saved in the current Spotify user's 'Your Music' library.

Get a list of the audiobooks saved in the current Spotify user's 'Your Music' library.

Get a list of the episodes saved in the current Spotify user's library.

Get a list of shows saved in the current Spotify user's library. Optional parameters can be used to limit the number of shows returned.

Get a list of the songs saved in the current Spotify user's 'Your Music' library.

Get the current user's top artists or tracks based on calculated affinity.

Pause playback on the user's account. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.

Remove one or more albums from the current user's 'Your Music' library. **Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.

Remove one or more audiobooks from the Spotify user's library. **Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.

Remove one or more episodes from the current user's library. **Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.

Remove one or more items from a user's playlist.

Remove one or more items from the current user's library. Accepts Spotify URIs for tracks, albums, episodes, shows, audiobooks, users, and playlists.

Delete one or more shows from current Spotify user's library. **Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.

**Deprecated:** Use [Remove Playlist Items](/documentation/web-api/reference/remove-items-playlist) instead. Remove one or more items from a user's playlist.

Remove one or more tracks from the current user's 'Your Music' library. **Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.

Either reorder or replace items in a playlist depending on the request's parameters. To reorder items, include `range_start`, `insert_before`, `range_length` and `snapshot_id` in the request's body. To replace items, include `uris` as either a query parameter or in the request's body. Replacing items in a playlist will overwrite its existing items. This operation can be used for replacing or clearing items in a playlist. <br/> **Note**: Replace and reorder are mutually exclusive operations which share the same endpoint, but have different parameters. These operations can't be applied together in a single request.

**Deprecated:** Use [Update Playlist Items](/documentation/web-api/reference/reorder-or-replace-playlists-items) instead. Either reorder or replace items in a playlist depending on the request's parameters. To reorder items, include `range_start`, `insert_before`, `range_length` and `snapshot_id` in the request's body. To replace items, include `uris` as either a query parameter or in the request's body. Replacing items in a playlist will overwrite its existing items. This operation can be used for replacing or clearing items in a playlist. <br/> **Note**: Replace and reorder are mutually exclusive operations which share the same endpoint, but have different parameters. These operations can't be applied together in a single request.

Save one or more albums to the current user's 'Your Music' library. **Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.

Save one or more audiobooks to the current Spotify user's library. **Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.

Save one or more episodes to the current user's library. **Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.

Add one or more items to the current user's library. Accepts Spotify URIs for tracks, albums, episodes, shows, audiobooks, users, and playlists.

Save one or more shows to current Spotify user's library. **Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.

Save one or more tracks to the current user's 'Your Music' library. **Note:** This endpoint is deprecated. Use [Save Items to Library](/documentation/web-api/reference/save-library-items) instead.

Get Spotify catalog information about albums, artists, playlists, tracks, shows, episodes or audiobooks that match a keyword string. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.

Seeks to the given position in the user’s currently playing track. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.

Set the repeat mode for the user's playback. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.

Set the volume for the user’s current playback device. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.

Skips to next track in the user’s queue. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.

Skips to previous track in the user’s queue. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.

Start a new context or resume current playback on the user's active device. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.

Toggle shuffle on or off for user’s playback. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.

Transfer playback to a new device and optionally begin playback. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.

Remove the current user as a follower of one or more artists or other Spotify users. **Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.

Remove the current user as a follower of a playlist. **Note:** This endpoint is deprecated. Use [Remove Items from Library](/documentation/web-api/reference/remove-library-items) instead.