Music — entry 028 of 32

Spotify

Verified Jul 2026

Spotify's Web API exposes the same catalog and personalization data that powers the Spotify apps: search, track/album/artist metadata, audio features, playlists, and OAuth-scoped access to a user's library and player state. Every endpoint requires an OAuth 2.0 token, from client-credentials grants for plain catalog reads up to full authorization-code flows for acting on a user's own account, and interactive playback control additionally requires the calling user to hold Spotify Premium. Registering an app and calling the API is free, with request volume throttled over a rolling 30-second window.

musicstreamingoauthcatalogrecommendations

Visit developer.spotify.com ↗More Music

AuthenticationOAuthRequires an OAuth flow; expect app registration.

HTTPSSupportedTraffic is encrypted in transit.

CORSEnabledCallable directly from browser JavaScript.

PricingFreeNo paid tier — free for the documented use case.

FormatsJSONResponses can be requested as JSON.

GreatAPIs Score

Score77out of 100

Authentication8/25OAuth flow required

Pricing20/20Free to use

Docs20/20Machine-readable spec file bundled

Formats9/15Single response format

Freshness20/20Verified within 6 months

Embed this badge

<a href="https://greatapis.com/api/spotify/"><img src="https://greatapis.com/badge/spotify.svg" alt="Scored 77 on greatapis.com"></a>

Auth quickstart

Register an app / run the OAuth flow to obtain a bearer token.
Send it as an Authorization headerAuthorization: Bearer <token>

Stored keyNo key stored

Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.

Endpoints

Servers

https://api.spotify.com/v1

Auth

oauth_2_0

Albums8

GET/albumsGet Several Albums

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/albums/{id}Get Album

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/albums/{id}/tracksGet Album Tracks

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/browse/new-releasesGet New Releases

Parameters

Name	In	Required	Type
`country`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/albumsGet User's Saved Albums

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/me/albumsSave Albums for Current User

Request body

application/json

Responses

Status	Description	Schema
`200`	The album is saved	—
`401`	—	—
`403`	—	—
`429`	—	—

DELETE/me/albumsRemove Users' Saved Albums

Request body

application/json

Responses

Status	Description	Schema
`200`	Album(s) have been removed from the library	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/albums/containsCheck User's Saved Albums

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

Artists5

GET/artistsGet Several Artists

Parameters

Name	In	Required	Type
`ids`	query	yes	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/artists/{id}Get Artist

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/artists/{id}/albumsGet Artist's Albums

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/artists/{id}/related-artistsGet Artist's Related Artists

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/artists/{id}/top-tracksGet Artist's Top Tracks

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

Audiobooks7

GET/audiobooksGet Several Audiobooks

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/audiobooks/{id}Get an Audiobook

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/audiobooks/{id}/chaptersGet Audiobook Chapters

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/audiobooksGet User's Saved Audiobooks

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/me/audiobooksSave Audiobooks for Current User

Responses

Status	Description	Schema
`200`	Audiobook(s) are saved to the library	—
`401`	—	—
`403`	—	—
`429`	—	—

DELETE/me/audiobooksRemove User's Saved Audiobooks

Responses

Status	Description	Schema
`200`	Audiobook(s) have been removed from the library	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/audiobooks/containsCheck User's Saved Audiobooks

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

Categories2

GET/browse/categoriesGet Several Browse Categories

Parameters

Name	In	Required	Type
`country`	query	no	string
`locale`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/browse/categories/{category_id}Get Single Browse Category

Parameters

Name	In	Required	Type
`category_id`	path	yes	string
`country`	query	no	string
`locale`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

Chapters2

GET/chaptersGet Several Chapters

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/chapters/{id}Get a Chapter

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

Episodes6

GET/episodesGet Several Episodes

Parameters

Name	In	Required	Type
`ids`	query	yes	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/episodes/{id}Get Episode

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/episodesGet User's Saved Episodes

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/me/episodesSave Episodes for Current User

Parameters

Name	In	Required	Type
`ids`	query	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	Episode saved	—
`401`	—	—
`403`	—	—
`429`	—	—

DELETE/me/episodesRemove User's Saved Episodes

Request body

application/json

Responses

Status	Description	Schema
`200`	Episode removed	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/episodes/containsCheck User's Saved Episodes

Parameters

Name	In	Required	Type
`ids`	query	yes	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

Genres1

GET/recommendations/available-genre-seedsGet Available Genre Seeds

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

Markets1

GET/marketsGet Available Markets

Responses

Status	Description	Schema
`200`	A markets object with an array of country codes	—
`401`	—	—
`403`	—	—
`429`	—	—

Player15

GET/me/playerGet Playback State

Responses

Status	Description	Schema
`200`	—	—
`204`	Playback not available or active	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/me/playerTransfer Playback

Request body

application/json

Responses

Status	Description	Schema
`204`	Playback transferred	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/player/currently-playingGet Currently Playing Track

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/player/devicesGet Available Devices

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

POST/me/player/nextSkip To Next

Parameters

Name	In	Required	Type
`device_id`	query	no	string

Responses

Status	Description	Schema
`204`	Command sent	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/me/player/pausePause Playback

Parameters

Name	In	Required	Type
`device_id`	query	no	string

Responses

Status	Description	Schema
`204`	Playback paused	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/me/player/playStart/Resume Playback

Parameters

Name	In	Required	Type
`device_id`	query	no	string

Request body

application/json

Responses

Status	Description	Schema
`204`	Playback started	—
`401`	—	—
`403`	—	—
`429`	—	—

POST/me/player/previousSkip To Previous

Parameters

Name	In	Required	Type
`device_id`	query	no	string

Responses

Status	Description	Schema
`204`	Command sent	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/player/queueGet the User's Queue

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

POST/me/player/queueAdd Item to Playback Queue

Parameters

Name	In	Required	Type
`uri`	query	yes	string
`device_id`	query	no	string

Responses

Status	Description	Schema
`204`	Command received	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/player/recently-playedGet Recently Played Tracks

Parameters

Name	In	Required	Type
`limit`	query	no	integer
`after`	query	no	integer
`before`	query	no	integer

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/me/player/repeatSet Repeat Mode

Parameters

Name	In	Required	Type
`state`	query	yes	string
`device_id`	query	no	string

Responses

Status	Description	Schema
`204`	Command sent	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/me/player/seekSeek To Position

Parameters

Name	In	Required	Type
`position_ms`	query	yes	integer
`device_id`	query	no	string

Responses

Status	Description	Schema
`204`	Command sent	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/me/player/shuffleToggle Playback Shuffle

Parameters

Name	In	Required	Type
`state`	query	yes	boolean
`device_id`	query	no	string

Responses

Status	Description	Schema
`204`	Command sent	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/me/player/volumeSet Playback Volume

Parameters

Name	In	Required	Type
`volume_percent`	query	yes	integer
`device_id`	query	no	string

Responses

Status	Description	Schema
`204`	Command sent	—
`401`	—	—
`403`	—	—
`429`	—	—

Playlists13

GET/browse/categories/{category_id}/playlistsGet Category's Playlists

Parameters

Name	In	Required	Type
`category_id`	path	yes	string
`country`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/browse/featured-playlistsGet Featured Playlists

Parameters

Name	In	Required	Type
`country`	query	no	string
`locale`	query	no	string
`timestamp`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/playlistsGet Current User's Playlists

Parameters

Name	In	Required	Type
`offset`	query	no	integer

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/playlists/{playlist_id}Get Playlist

Parameters

Name	In	Required	Type
`fields`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/playlists/{playlist_id}Change Playlist Details

Request body

application/json

Responses

Status	Description	Schema
`200`	Playlist updated	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/playlists/{playlist_id}/imagesGet Playlist Cover Image

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/playlists/{playlist_id}/imagesAdd Custom Playlist Cover Image

Responses

Status	Description	Schema
`200`	Image uploaded	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/playlists/{playlist_id}/tracksGet Playlist Items

Parameters

Name	In	Required	Type
`fields`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

POST/playlists/{playlist_id}/tracksAdd Items to Playlist

Parameters

Name	In	Required	Type
`position`	query	no	integer
`uris`	query	no	string

Request body

application/json

Responses

Status	Description	Schema
`201`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/playlists/{playlist_id}/tracksUpdate Playlist Items

Parameters

Name	In	Required	Type
`uris`	query	no	string

Request body

application/json

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

DELETE/playlists/{playlist_id}/tracksRemove Playlist Items

Request body

application/json

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/users/{user_id}/playlistsGet User's Playlists

Parameters

Name	In	Required	Type
`offset`	query	no	integer

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

POST/users/{user_id}/playlistsCreate Playlist

Request body

application/json

Responses

Status	Description	Schema
`201`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

Search1

GET/searchSearch for Item

Parameters

Name	In	Required	Type
`q`	query	yes	string
`type`	query	yes	array
`limit`	query	no	integer
`offset`	query	no	integer
`include_external`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

Shows7

GET/me/showsGet User's Saved Shows

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/me/showsSave Shows for Current User

Responses

Status	Description	Schema
`200`	Show saved	—
`401`	—	—
`403`	—	—
`429`	—	—

DELETE/me/showsRemove User's Saved Shows

Responses

Status	Description	Schema
`200`	Show removed	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/shows/containsCheck User's Saved Shows

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/showsGet Several Shows

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/shows/{id}Get Show

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/shows/{id}/episodesGet Show Episodes

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

Tracks10

GET/audio-analysis/{id}Get Track's Audio Analysis

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/audio-featuresGet Tracks' Audio Features

Parameters

Name	In	Required	Type
`ids`	query	yes	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/audio-features/{id}Get Track's Audio Features

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/tracksGet User's Saved Tracks

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/me/tracksSave Tracks for Current User

Request body

application/json

Responses

Status	Description	Schema
`200`	Track saved	—
`401`	—	—
`403`	—	—
`429`	—	—

DELETE/me/tracksRemove User's Saved Tracks

Request body

application/json

Responses

Status	Description	Schema
`200`	Track removed	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/tracks/containsCheck User's Saved Tracks

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/recommendationsGet Recommendations

Parameters

Name	In	Required	Type
`limit`	query	no	integer
`seed_artists`	query	yes	string
`seed_genres`	query	yes	string
`seed_tracks`	query	yes	string
`min_acousticness`	query	no	number
`max_acousticness`	query	no	number
`target_acousticness`	query	no	number
`min_danceability`	query	no	number
`max_danceability`	query	no	number
`target_danceability`	query	no	number
`min_duration_ms`	query	no	integer
`max_duration_ms`	query	no	integer
`target_duration_ms`	query	no	integer
`min_energy`	query	no	number
`max_energy`	query	no	number
`target_energy`	query	no	number
`min_instrumentalness`	query	no	number
`max_instrumentalness`	query	no	number
`target_instrumentalness`	query	no	number
`min_key`	query	no	integer
`max_key`	query	no	integer
`target_key`	query	no	integer
`min_liveness`	query	no	number
`max_liveness`	query	no	number
`target_liveness`	query	no	number
`min_loudness`	query	no	number
`max_loudness`	query	no	number
`target_loudness`	query	no	number
`min_mode`	query	no	integer
`max_mode`	query	no	integer
`target_mode`	query	no	integer
`min_popularity`	query	no	integer
`max_popularity`	query	no	integer
`target_popularity`	query	no	integer
`min_speechiness`	query	no	number
`max_speechiness`	query	no	number
`target_speechiness`	query	no	number
`min_tempo`	query	no	number
`max_tempo`	query	no	number
`target_tempo`	query	no	number
`min_time_signature`	query	no	integer
`max_time_signature`	query	no	integer
`target_time_signature`	query	no	integer
`min_valence`	query	no	number
`max_valence`	query	no	number
`target_valence`	query	no	number

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/tracksGet Several Tracks

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/tracks/{id}Get Track

Parameters

Name	In	Required	Type
`id`	path	yes	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

Users10

GET/meGet Current User's Profile

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/followingGet Followed Artists

Parameters

Name	In	Required	Type
`type`	query	yes	string
`after`	query	no	string
`limit`	query	no	integer

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/me/followingFollow Artists or Users

Parameters

Name	In	Required	Type
`type`	query	yes	string
`ids`	query	yes	string

Request body

application/json

Responses

Status	Description	Schema
`204`	Artist or user followed	—
`401`	—	—
`403`	—	—
`429`	—	—

DELETE/me/followingUnfollow Artists or Users

Parameters

Name	In	Required	Type
`type`	query	yes	string
`ids`	query	yes	string

Request body

application/json

Responses

Status	Description	Schema
`200`	Artist or user unfollowed	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/following/containsCheck If User Follows Artists or Users

Parameters

Name	In	Required	Type
`type`	query	yes	string
`ids`	query	yes	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/me/top/{type}Get User's Top Items

Parameters

Name	In	Required	Type
`type`	path	yes	string
`time_range`	query	no	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

PUT/playlists/{playlist_id}/followersFollow Playlist

Request body

application/json

Responses

Status	Description	Schema
`200`	Playlist followed	—
`401`	—	—
`403`	—	—
`429`	—	—

DELETE/playlists/{playlist_id}/followersUnfollow Playlist

Responses

Status	Description	Schema
`200`	Playlist unfollowed	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/playlists/{playlist_id}/followers/containsCheck if Users Follow Playlist

Parameters

Name	In	Required	Type
`ids`	query	yes	string

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

GET/users/{user_id}Get User's Profile

Responses

Status	Description	Schema
`200`	—	—
`401`	—	—
`403`	—	—
`429`	—	—

Try it

Operation

API key

Developer reference

Base URLhttps://api.spotify.com/v1

Rate limit

Dynamic — calculated over a rolling 30-second window; a higher ceiling applies in extended quota mode

Key endpoints

GET/search
GET/tracks/{id}
GET/artists/{id}
GET/me/player
GET/recommendations

SDKs

iOS ↗Android ↗

GreatAPIs Score

Embed this badge

Auth quickstart

Endpoints

Try it

Developer reference

People comparing Spotify also look at…

Lyrics.ovh

Radio Browser

Verome

Deezer

Genrenator

iTunes Search