Spotify Web API

Spotify Web API

API version: 1.0.0

Auth

OAuth2

Base URL

https://api.spotify.com/v1

Setup

1. Configure auth: OAuth2
2. GET /albums -- verify access
3. POST /playlists/{playlist_id}/tracks -- create first tracks

Endpoints

96 endpoints across 16 groups. See references/api-spec.lap for full details.

albums

artists

shows

episodes

audiobooks

me

chapters

tracks

search

playlists

users

browse

audio-features

audio-analysis

recommendations

markets

Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:

• "Get album details?" -> GET /albums/{id}
• "List all albums?" -> GET /albums
• "List all tracks?" -> GET /albums/{id}/tracks
• "Get artist details?" -> GET /artists/{id}
• "List all artists?" -> GET /artists
• "List all albums?" -> GET /artists/{id}/albums
• "List all top-tracks?" -> GET /artists/{id}/top-tracks
• "List all related-artists?" -> GET /artists/{id}/related-artists
• "Get show details?" -> GET /shows/{id}
• "List all shows?" -> GET /shows
• "List all episodes?" -> GET /shows/{id}/episodes
• "Get episode details?" -> GET /episodes/{id}
• "List all episodes?" -> GET /episodes
• "Get audiobook details?" -> GET /audiobooks/{id}
• "List all audiobooks?" -> GET /audiobooks
• "List all chapters?" -> GET /audiobooks/{id}/chapters
• "List all audiobooks?" -> GET /me/audiobooks
• "List all contains?" -> GET /me/audiobooks/contains
• "Get chapter details?" -> GET /chapters/{id}
• "List all chapters?" -> GET /chapters
• "Get track details?" -> GET /tracks/{id}
• "List all tracks?" -> GET /tracks
• "Search search?" -> GET /search
• "List all me?" -> GET /me
• "Get playlist details?" -> GET /playlists/{playlist_id}
• "Update a playlist?" -> PUT /playlists/{playlist_id}
• "List all tracks?" -> GET /playlists/{playlist_id}/tracks
• "Create a track?" -> POST /playlists/{playlist_id}/tracks
• "List all items?" -> GET /playlists/{playlist_id}/items
• "Create a item?" -> POST /playlists/{playlist_id}/items
• "List all playlists?" -> GET /me/playlists
• "Create a playlist?" -> POST /me/playlists
• "List all contains?" -> GET /me/library/contains
• "List all albums?" -> GET /me/albums
• "List all contains?" -> GET /me/albums/contains
• "List all tracks?" -> GET /me/tracks
• "List all contains?" -> GET /me/tracks/contains
• "List all episodes?" -> GET /me/episodes
• "List all contains?" -> GET /me/episodes/contains
• "List all shows?" -> GET /me/shows
• "List all contains?" -> GET /me/shows/contains
• "Get top details?" -> GET /me/top/{type}
• "Get user details?" -> GET /users/{user_id}
• "List all playlists?" -> GET /users/{user_id}/playlists
• "Create a playlist?" -> POST /users/{user_id}/playlists
• "List all featured-playlists?" -> GET /browse/featured-playlists
• "List all categories?" -> GET /browse/categories
• "Get category details?" -> GET /browse/categories/{category_id}
• "List all playlists?" -> GET /browse/categories/{category_id}/playlists
• "List all images?" -> GET /playlists/{playlist_id}/images
• "List all new-releases?" -> GET /browse/new-releases
• "List all following?" -> GET /me/following
• "List all contains?" -> GET /me/following/contains
• "List all contains?" -> GET /playlists/{playlist_id}/followers/contains
• "List all audio-features?" -> GET /audio-features
• "Get audio-feature details?" -> GET /audio-features/{id}
• "Get audio-analysis details?" -> GET /audio-analysis/{id}
• "List all recommendations?" -> GET /recommendations
• "List all available-genre-seeds?" -> GET /recommendations/available-genre-seeds
• "List all player?" -> GET /me/player
• "List all devices?" -> GET /me/player/devices
• "List all currently-playing?" -> GET /me/player/currently-playing
• "Create a next?" -> POST /me/player/next
• "Create a previous?" -> POST /me/player/previous
• "List all recently-played?" -> GET /me/player/recently-played
• "List all queue?" -> GET /me/player/queue
• "Create a queue?" -> POST /me/player/queue
• "List all markets?" -> GET /markets
• "How to authenticate?" -> See Auth section

Response Tips

• Check response schemas in references/api-spec.lap for field details
• List endpoints may support pagination; check for limit, offset, or cursor params
• Create/update endpoints typically return the created/updated object

References

• Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

Generated from the official API spec by LAP