Get the currently playing track or episode and full playback state

Lightweight poll of what is playing right now: the item, progress, and playing state

Search Spotify by name and immediately play the best match. Works for songs and podcast episodes — no URI needed.

Start or resume playback. Optionally target specific content.

Pause playback on the active device

Skip to the next track in the queue or context

Skip to the previous track. If more than 3 seconds in, restarts the current track first.

Seek to a position in the current track

Set playback volume (0–100)

Enable or disable shuffle mode

Set repeat mode: off, context (repeat playlist/album), or track (repeat single track)

Get the current playback queue

Add a track or episode to the end of the playback queue

List available Spotify Connect devices

Move playback to a different Spotify Connect device

Search Spotify's catalog for tracks, artists, albums, playlists, shows, or episodes. Pass types as an array (e.g. ["artist"]) to search a single kind — no track/album fallback noise.

Get full details for a track by ID

Get artist info by ID

List an artist's albums and singles

Get album details and track list by ID

List the tracks of an album with pagination

Get full details for a podcast show

List a podcast show's episodes with pagination. Resume positions require the user-read-playback-position scope.

Get full details for a podcast episode

Get the current user's Spotify profile: display name, user ID, email, country, and subscription level. Email requires the user-read-email scope; country and product require user-read-private.

Get the user's most-played tracks

Get the user's most-played artists

Get recently played tracks with timestamps

Get tracks saved in the user's Liked Songs. Set fetch_all=true to retrieve the entire collection (capped at 500 items).

Get albums saved in the user's library. Set fetch_all=true to retrieve the entire collection (capped at 500 items).

Get podcast shows saved in the user's library. Set fetch_all=true to retrieve the entire collection (capped at 500 items).

Get podcast episodes saved in the user's library. Set fetch_all=true to retrieve the entire collection (capped at 500 items).

Save one or more items to the user's library. Accepts track, album, show, and episode URIs (e.g. spotify:track:abc). Max 50.

Remove one or more items from the user's library. Max 50.

Check whether items are saved in the user's library. Returns a boolean per URI. Max 40.

Get all artists the user follows (cursor-based pagination)

Check if the user follows specific artists. Returns a boolean per ID. Max 50.

Get full details for an audiobook by ID. Audiobooks are only available in the US, UK, Canada, Ireland, New Zealand and Australia markets.

List the chapters of an audiobook with pagination. Audiobooks are only available in the US, UK, Canada, Ireland, New Zealand and Australia markets.

Get full details for a single audiobook chapter by ID. Resume position requires the user-read-playback-position scope. Audiobooks are only available in the US, UK, Canada, Ireland, New Zealand and Australia markets.

List the audiobooks saved in the current user's Spotify library. Requires the user-library-read scope.

List the current user's playlists

Get a playlist's metadata (including cover image) and items

Get a playlist's cover image URLs

Replace a playlist's cover image with a base64-encoded JPEG. Requires the ugc-image-upload scope on the Spotify developer dashboard app (plus playlist-modify-public/private); without it Spotify rejects the upload with 403.

Create a new playlist for the current user

Add tracks or episodes to a playlist. Max 100 URIs per call.

Remove tracks or episodes from a playlist

Update a playlist's name, description, or visibility

Move a range of items within a playlist