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 <a href="https://developer.spotify.com/documentation/general/guides/authorization-guide/">OAuth 2.0</a>.
The base URI for all Web API requests is `https://api.spotify.com/v1`.
Need help? See our <a href="https://developer.spotify.com/documentation/web-api/guides/">Web API guides</a> for more information, or visit the <a href="https://community.spotify.com/t5/Spotify-for-Developers/bd-p/Spotify_Developer">Spotify for Developers community forum</a> to ask questions and connect with other developers.
Albums GET /albums/{id}Get Album
GET /albumsGet Several Albums
GET /albums/{id}/tracksGet Album Tracks
GET /artists/{id}/albumsGet Artist's Albums
GET /me/albumsGet User's Saved Albums
PUT /me/albumsSave Albums for Current User
DELETE /me/albumsRemove Users' Saved Albums
GET /me/albums/containsCheck User's Saved Albums
GET /browse/new-releasesGet New Releases
Artists GET /artists/{id}Get Artist
GET /artistsGet Several Artists
GET /artists/{id}/albumsGet Artist's Albums
GET /artists/{id}/top-tracksGet Artist's Top Tracks
GET /artists/{id}/related-artistsGet Artist's Related Artists
GET /me/followingGet Followed Artists
PUT /me/followingFollow Artists or Users
DELETE /me/followingUnfollow Artists or Users
GET /me/following/containsCheck If User Follows Artists or Users
GET /me/top/artistsGet User's Top Artists
Audiobooks GET /audiobooks/{id}Get an Audiobook
GET /audiobooksGet Several Audiobooks
GET /audiobooks/{id}/chaptersGet Audiobook Chapters
GET /me/audiobooksGet User's Saved Audiobooks
PUT /me/audiobooksSave Audiobooks for Current User
DELETE /me/audiobooksRemove User's Saved Audiobooks
GET /me/audiobooks/containsCheck User's Saved Audiobooks
Categories GET /browse/categoriesGet Several Browse Categories
GET /browse/categories/{category_id}Get Single Browse Category
GET /browse/categories/{category_id}/playlistsGet Category's Playlists
Chapters GET /audiobooks/{id}/chaptersGet Audiobook Chapters
GET /chapters/{id}Get a Chapter
GET /chaptersGet Several Chapters
Episodes GET /shows/{id}/episodesGet Show Episodes
GET /episodes/{id}Get Episode
GET /episodesGet Several Episodes
GET /me/episodesGet User's Saved Episodes
PUT /me/episodesSave Episodes for Current User
DELETE /me/episodesRemove User's Saved Episodes
GET /me/episodes/containsCheck User's Saved Episodes
Library GET /me/audiobooksGet User's Saved Audiobooks
PUT /me/audiobooksSave Audiobooks for Current User
DELETE /me/audiobooksRemove User's Saved Audiobooks
GET /me/audiobooks/containsCheck User's Saved Audiobooks
PUT /playlists/{playlist_id}Change Playlist Details
GET /me/playlistsGet Current User's Playlists
POST /me/playlistsCreate Playlist
PUT /me/librarySave Items to Library
DELETE /me/libraryRemove Items from Library
GET /me/library/containsCheck User's Saved Items
GET /me/albumsGet User's Saved Albums
PUT /me/albumsSave Albums for Current User
DELETE /me/albumsRemove Users' Saved Albums
GET /me/albums/containsCheck User's Saved Albums
GET /me/tracksGet User's Saved Tracks
PUT /me/tracksSave Tracks for Current User
DELETE /me/tracksRemove User's Saved Tracks
GET /me/tracks/containsCheck User's Saved Tracks
GET /me/episodesGet User's Saved Episodes
PUT /me/episodesSave Episodes for Current User
DELETE /me/episodesRemove User's Saved Episodes
GET /me/episodes/containsCheck User's Saved Episodes
GET /me/showsGet User's Saved Shows
PUT /me/showsSave Shows for Current User
DELETE /me/showsRemove User's Saved Shows
GET /me/shows/containsCheck User's Saved Shows
POST /users/{user_id}/playlistsCreate Playlist for user
GET /me/followingGet Followed Artists
PUT /me/followingFollow Artists or Users
DELETE /me/followingUnfollow Artists or Users
GET /me/following/containsCheck If User Follows Artists or Users
GET /me/top/artistsGet User's Top Artists
GET /me/top/tracksGet User's Top Tracks
Genres GET /recommendations/available-genre-seedsGet Available Genre Seeds
Markets GET /marketsGet Available Markets
Player GET /me/playerGet Playback State
PUT /me/playerTransfer Playback
GET /me/player/devicesGet Available Devices
GET /me/player/currently-playingGet Currently Playing Track
PUT /me/player/playStart/Resume Playback
PUT /me/player/pausePause Playback
POST /me/player/nextSkip To Next
POST /me/player/previousSkip To Previous
PUT /me/player/seekSeek To Position
PUT /me/player/repeatSet Repeat Mode
PUT /me/player/volumeSet Playback Volume
PUT /me/player/shuffleToggle Playback Shuffle
GET /me/player/recently-playedGet Recently Played Tracks
GET /me/player/queueGet the User's Queue
POST /me/player/queueAdd Item to Playback Queue
Playlists GET /playlists/{playlist_id}Get Playlist
PUT /playlists/{playlist_id}Change Playlist Details
GET /playlists/{playlist_id}/tracksGet Playlist Items [DEPRECATED]
POST /playlists/{playlist_id}/tracksAdd Items to Playlist [DEPRECATED]
PUT /playlists/{playlist_id}/tracksUpdate Playlist Items [DEPRECATED]
DELETE /playlists/{playlist_id}/tracksRemove Playlist Items [DEPRECATED]
GET /playlists/{playlist_id}/itemsGet Playlist Items
POST /playlists/{playlist_id}/itemsAdd Items to Playlist
PUT /playlists/{playlist_id}/itemsUpdate Playlist Items
DELETE /playlists/{playlist_id}/itemsRemove Playlist Items
GET /me/playlistsGet Current User's Playlists
POST /me/playlistsCreate Playlist
GET /users/{user_id}/playlistsGet User's Playlists
POST /users/{user_id}/playlistsCreate Playlist for user
PUT /playlists/{playlist_id}/followersFollow Playlist
DELETE /playlists/{playlist_id}/followersUnfollow Playlist
GET /browse/featured-playlistsGet Featured Playlists
GET /browse/categories/{category_id}/playlistsGet Category's Playlists
GET /playlists/{playlist_id}/imagesGet Playlist Cover Image
PUT /playlists/{playlist_id}/imagesAdd Custom Playlist Cover Image
GET /playlists/{playlist_id}/followers/containsCheck if Current User Follows Playlist
Search GET /searchSearch for Item
Shows GET /shows/{id}Get Show
GET /showsGet Several Shows
GET /shows/{id}/episodesGet Show Episodes
GET /me/showsGet User's Saved Shows
PUT /me/showsSave Shows for Current User
DELETE /me/showsRemove User's Saved Shows
GET /me/shows/containsCheck User's Saved Shows
Tracks GET /albums/{id}/tracksGet Album Tracks
GET /artists/{id}/top-tracksGet Artist's Top Tracks
GET /tracks/{id}Get Track
GET /tracksGet Several Tracks
GET /playlists/{playlist_id}/tracksGet Playlist Items [DEPRECATED]
POST /playlists/{playlist_id}/tracksAdd Items to Playlist [DEPRECATED]
PUT /playlists/{playlist_id}/tracksUpdate Playlist Items [DEPRECATED]
DELETE /playlists/{playlist_id}/tracksRemove Playlist Items [DEPRECATED]
GET /playlists/{playlist_id}/itemsGet Playlist Items
POST /playlists/{playlist_id}/itemsAdd Items to Playlist
PUT /playlists/{playlist_id}/itemsUpdate Playlist Items
DELETE /playlists/{playlist_id}/itemsRemove Playlist Items
GET /me/tracksGet User's Saved Tracks
PUT /me/tracksSave Tracks for Current User
DELETE /me/tracksRemove User's Saved Tracks
GET /me/tracks/containsCheck User's Saved Tracks
GET /audio-featuresGet Several Tracks' Audio Features
GET /audio-features/{id}Get Track's Audio Features
GET /audio-analysis/{id}Get Track's Audio Analysis
GET /recommendationsGet Recommendations
GET /me/top/tracksGet User's Top Tracks
Users GET /meGet Current User's Profile
GET /users/{user_id}Get User's Profile
GET /users/{user_id}/playlistsGet User's Playlists
PUT /playlists/{playlist_id}/followersFollow Playlist
DELETE /playlists/{playlist_id}/followersUnfollow Playlist
GET /me/followingGet Followed Artists
PUT /me/followingFollow Artists or Users
DELETE /me/followingUnfollow Artists or Users
GET /me/following/containsCheck If User Follows Artists or Users
GET /playlists/{playlist_id}/followers/containsCheck if Current User Follows Playlist
GET /me/top/artistsGet User's Top Artists
GET /me/top/tracksGet User's Top Tracks
Wedv2025.5.18