spotify-web-api

name	spotify-web-api
description	Spotify Web API skill. Use when working with Spotify Web for albums, artists, shows. Covers 96 endpoints.
version	1.0.0
generator	lapsh

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

Method	Path	Description
GET	/albums/{id}	Get Album
GET	/albums	Get Several Albums
GET	/albums/{id}/tracks	Get Album Tracks

artists

Method	Path	Description
GET	/artists/{id}	Get Artist
GET	/artists	Get Several Artists
GET	/artists/{id}/albums	Get Artist's Albums
GET	/artists/{id}/top-tracks	Get Artist's Top Tracks
GET	/artists/{id}/related-artists	Get Artist's Related Artists

shows

Method	Path	Description
GET	/shows/{id}	Get Show
GET	/shows	Get Several Shows
GET	/shows/{id}/episodes	Get Show Episodes

episodes

Method	Path	Description
GET	/episodes/{id}	Get Episode
GET	/episodes	Get Several Episodes

audiobooks

Method	Path	Description
GET	/audiobooks/{id}	Get an Audiobook
GET	/audiobooks	Get Several Audiobooks
GET	/audiobooks/{id}/chapters	Get Audiobook Chapters

me

Method	Path	Description
GET	/me/audiobooks	Get User's Saved Audiobooks
PUT	/me/audiobooks	Save Audiobooks for Current User
DELETE	/me/audiobooks	Remove User's Saved Audiobooks
GET	/me/audiobooks/contains	Check User's Saved Audiobooks
GET	/me	Get Current User's Profile
GET	/me/playlists	Get Current User's Playlists
POST	/me/playlists	Create Playlist
PUT	/me/library	Save Items to Library
DELETE	/me/library	Remove Items from Library
GET	/me/library/contains	Check User's Saved Items
GET	/me/albums	Get User's Saved Albums
PUT	/me/albums	Save Albums for Current User
DELETE	/me/albums	Remove Users' Saved Albums
GET	/me/albums/contains	Check User's Saved Albums
GET	/me/tracks	Get User's Saved Tracks
PUT	/me/tracks	Save Tracks for Current User
DELETE	/me/tracks	Remove User's Saved Tracks
GET	/me/tracks/contains	Check User's Saved Tracks
GET	/me/episodes	Get User's Saved Episodes
PUT	/me/episodes	Save Episodes for Current User
DELETE	/me/episodes	Remove User's Saved Episodes
GET	/me/episodes/contains	Check User's Saved Episodes
GET	/me/shows	Get User's Saved Shows
PUT	/me/shows	Save Shows for Current User
DELETE	/me/shows	Remove User's Saved Shows
GET

chapters

Method	Path	Description
GET	/chapters/{id}	Get a Chapter
GET	/chapters	Get Several Chapters

tracks

Method	Path	Description
GET	/tracks/{id}	Get Track
GET	/tracks	Get Several Tracks

search

Method	Path	Description
GET	/search	Search for Item

playlists

Method	Path	Description
GET	/playlists/{playlist_id}	Get Playlist
PUT	/playlists/{playlist_id}	Change Playlist Details
GET	/playlists/{playlist_id}/tracks	Get Playlist Items [DEPRECATED]
POST	/playlists/{playlist_id}/tracks	Add Items to Playlist [DEPRECATED]
PUT	/playlists/{playlist_id}/tracks	Update Playlist Items [DEPRECATED]
DELETE	/playlists/{playlist_id}/tracks	Remove Playlist Items [DEPRECATED]
GET	/playlists/{playlist_id}/items	Get Playlist Items
POST	/playlists/{playlist_id}/items	Add Items to Playlist
PUT	/playlists/{playlist_id}/items	Update Playlist Items
DELETE	/playlists/{playlist_id}/items	Remove Playlist Items
PUT	/playlists/{playlist_id}/followers	Follow Playlist
DELETE	/playlists/{playlist_id}/followers	Unfollow Playlist
GET	/playlists/{playlist_id}/images	Get Playlist Cover Image
PUT	/playlists/{playlist_id}/images	Add Custom Playlist Cover Image
GET	/playlists/{playlist_id}/followers/contains	Check if Current User Follows Playlist

users

Method	Path	Description
GET	/users/{user_id}	Get User's Profile
GET	/users/{user_id}/playlists	Get User's Playlists
POST	/users/{user_id}/playlists	Create Playlist for user

browse

Method	Path	Description
GET	/browse/featured-playlists	Get Featured Playlists
GET	/browse/categories	Get Several Browse Categories
GET	/browse/categories/{category_id}	Get Single Browse Category
GET	/browse/categories/{category_id}/playlists	Get Category's Playlists
GET	/browse/new-releases	Get New Releases

audio-features

Method	Path	Description
GET	/audio-features	Get Several Tracks' Audio Features
GET	/audio-features/{id}	Get Track's Audio Features

audio-analysis

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

recommendations

Method	Path	Description
GET	/recommendations	Get Recommendations
GET	/recommendations/available-genre-seeds	Get Available Genre Seeds

markets

Method	Path	Description
GET	/markets	Get Available 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

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