Spotify

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

Add an item to the end of 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.

Add one or more items to a user's playlist. <<DEPRECATED use add_items_to_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.

Check to see if one or more spotify users are following a specified playlist.

Check if one or more albums is already saved in the current spotify user's 'your music' library.

Check if one or more audiobooks are already saved in the current spotify user's library.

This spotify api endpoint (in beta) checks if episodes are saved in a user's library. feedback and issues can be shared in the developer forum.

Check if one or more shows is already saved in the current spotify user's library.

Check if one or more tracks is already saved in the current spotify user's 'your music' library.

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.

Add the current user as a follower of a playlist.

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 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 a list of the playlists owned or followed by the current spotify user. <<DEPRECATED use get_current_user_s_playlists>>

Get spotify catalog information for a single artist identified by their unique spotify id. <<DEPRECATED use get_artist>>

Get spotify catalog information about an artist's albums. <<DEPRECATED use get_artist_s_albums>>

Get spotify catalog information about an artist's top tracks by country. <<DEPRECATED use get_artist_s_top_tracks>>

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 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 about an show’s episodes. optional parameters can be used to limit the number of episodes returned. <<DEPRECATED use get_show_episodes>>

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 information about a user’s available spotify connect devices. some device models are not supported and will not be listed in the api response. <<DEPRECATED use get_available_devices>>

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.

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

Get the list of markets where spotify is available.

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

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

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

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

Get detailed profile information about the current user (including the current user's username). <<DEPRECATED use get_current_user_s_profile>>

Get spotify catalog information for a single episode identified by its unique spotify id.

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. <<DEPRECATED use get_playback_state>>

Get a list of the playlists owned or followed by a spotify user. <<DEPRECATED use get_user_s_playlists>>

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

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

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.

Get the list of objects that make up the user's queue. <<DEPRECATED use get_the_user_s_queue>>

Get tracks from the current user's recently played tracks.  **note**: currently doesn't support podcast episodes.  <<DEPRECATED use get_recently_played_tracks>>

Get tracks from the current user's recently played tracks.  **note**: currently doesn't support podcast episodes. 

Recommendations are based on seed entity data, matched with similar artists and tracks. if data is ample, a track list and pool size are returned. for new or obscure artists and tracks, data may be insufficient for recommendations.

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 a list of categories used to tag items in spotify (on, for example, the spotify player’s “browse” tab).

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 several episodes based on their spotify ids.

Get spotify catalog information for several shows based on their spotify ids.

Get spotify catalog information for multiple tracks based on their spotify ids.

Get audio features for multiple tracks based on their spotify ids.

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 a single category used to tag items in spotify (on, for example, the spotify player’s “browse” tab).

Get the object currently being played on the user's spotify account. <<DEPRECATED use get_currently_playing_track>>

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

Get spotify catalog information for a single track 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 a list of the playlists owned or followed by a spotify user.

Get public profile information about a spotify user.

Get public profile information about a spotify user. <<DEPRECATED use get_user_s_profile>>

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.

This api endpoint, currently in beta, allows retrieving episodes saved in a spotify user's library. changes may occur without notice. feedback and issues can be shared in spotify's developer forum.

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 a list of the songs saved in the current spotify user's 'your music' library. <<DEPRECATED use get_user_s_saved_tracks>>

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

Get the current user's top artists based on calculated affinity. <<DEPRECATED use get_user_s_top_artists>>

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

Get the current user's top tracks based on calculated affinity. <<DEPRECATED use get_user_s_top_tracks>>

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 items from a user's playlist.

Remove one or more albums from the current user's 'your music' library.

Remove one or more audiobooks from the spotify user's library.

This api endpoint, currently in beta, allows for the removal of episodes from a user's library and may change without notice. feedback and issues can be shared on the spotify developer forum.

Delete one or more shows from current spotify user's library.

Remove one or more tracks from the current user's 'your music' library.

Save one or more albums to the current user's 'your music' library.

Save one or more albums to the current user's 'your music' library. <<DEPRECATED use save_albums_for_current_user>>

Save one or more audiobooks to the current spotify user's library.

This api endpoint, currently in beta, allows saving episodes to a user's library. users are encouraged to provide feedback or report issues in the spotify developer forum.

Save one or more shows to current spotify user's library.

Save one or more tracks to the current user's 'your music' library.

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. <<DEPRECATED use search_for_item>>

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 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.

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.

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.

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. <<DEPRECATED use skip_to_next>>

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. <<DEPRECATED use start_resume_playback>>

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.

Remove the current user as a follower of a playlist.

To modify a playlist, use rearrange (with `range start`, `insert before`, `range length`, `snapshot id`) or replace items (`uris` in body/query). replace overwrites items. operations can't combine in one request; they are exclusive but share an endpoint.