Web API Endpoint Reference

Our Web API endpoints give external applications access to Spotify catalog and user data.

Web API Base URL: https://api.spotify.com User Guide | Tutorial | Code Examples

Method	Endpoint	Usage	Returns
GET	/v1/albums/{id}	Get an album	album
GET	/v1/albums?ids={ids}	Get several albums	albums
GET	/v1/albums/{id}/tracks	Get an album's tracks	tracks*
GET	/v1/artists/{id}	Get an artist	artist
GET	/v1/artists?ids={ids}	Get several artists	artists
GET	/v1/artists/{id}/albums	Get an artist's albums	albums*
GET	/v1/artists/{id}/top-tracks	Get an artist's top tracks	tracks
GET	/v1/artists/{id}/related-artists	Get an artist's related artists	artists
GET	/v1/browse/featured-playlists	Get a list of featured playlists	playlists	OAuth
GET	/v1/browse/new-releases	Get a list of new releases	albums*	OAuth
GET	/v1/browse/categories	Get a list of categories	categories	OAuth
GET	/v1/browse/categories/{id}	Get a category	category	OAuth
GET	/v1/browse/categories/{id}/playlists	Get a category's playlists	playlists*	OAuth
GET	/v1/me	Get current user's profile	user	OAuth
PUT	/v1/me/following	Follow Artists or Users	-	OAuth
DELETE	/v1/me/following	Unfollow Artists or Users	-	OAuth
GET	/v1/me/following/contains	Check if User Follows Users or Artists	true/false	OAuth
PUT	/v1/users/{owner_id}/playlists/{playlist_id}/followers	Follow a Playlist	-	OAuth
DELETE	/v1/users/{owner_id}/playlists/{playlist_id}/followers	Unfollow a Playlist	-	OAuth
PUT	/v1/me/tracks?ids={ids}	Save tracks for user	-	OAuth
GET	/v1/me/tracks	Get user's saved tracks	tracks	OAuth
DELETE	/v1/me/tracks?ids={ids}	Remove user's saved tracks	-	OAuth
GET	/v1/me/tracks/contains?ids={ids}	Check user's saved tracks	true/false	OAuth
GET	/v1/search?type=album	Search for an album	albums*
GET	/v1/search?type=artist	Search for an artist	artists
GET	/v1/search?type=playlist	Search for a playlist	playlists*
GET	/v1/search?type=track	Search for a track	tracks
GET	/v1/tracks/{id}	Get a track	tracks
GET	/v1/tracks?ids={ids}	Get several tracks	tracks
GET	/v1/users/{user_id}	Get a user's profile	user*
GET	/v1/users/{user_id}/playlists	Get a list of a user's playlists	playlists*	OAuth
GET	/v1/users/{user_id}/playlists/{playlist_id}	Get a playlist	playlist	OAuth
GET	/v1/users/{user_id}/playlists/{playlist_id}/tracks	Get a playlist's tracks	tracks	OAuth
POST	/v1/users/{user_id}/playlists	Create a playlist	playlist	OAuth
PUT	/v1/users/{user_id}/playlists/{playlist_id}	Change a playlist's details	-	OAuth
POST	/v1/users/{user_id}/playlists/{playlist_id}/tracks	Add tracks to a playlist	-	OAuth
DELETE	/v1/users/{user_id}/playlists/{playlist_id}/tracks	Remove tracks from a playlist	snapshot_id	OAuth
PUT	/v1/users/{user_id}/playlists/{playlist_id}/tracks	Reorder a playlist's tracks	snapshot_id	OAuth
PUT	/v1/users/{user_id}/playlists/{playlist_id}/tracks	Replace a playlist's tracks	-	OAuth
GET	/v1/users/{user_id}/playlists/{playlist_id}/followers/contains	Check if Users Follow a Playlist	true/false	OAuth

* Simplified objects

Authorization

Endpoints marked “OAuth” above require application registration and user authorization via the Spotify Accounts Service to access certain data.

Accounts Service Base URL: https://accounts.spotify.com Authorization Guide | Using Scopes | Tutorial

Method	Endpoint	Usage
GET	/authorize	Get an authorization code
POST	/api/token	Get an access token (or an access token and refresh token)

Note that all endpoints benefit from increased rate limits when a valid access token is passed in the call.

Newsletter

Authorization