Search for tracks, albums, artists, playlists, podcast episodes, or shows on Spotify. For episodes and shows, the query matches against title, description, and publisher. Use type "episode" to find individual podcast episodes by topic or guest name, and type "show" to find podcast series.

Get information about the currently playing track on Spotify, including device and volume info

Get a list of the current user's playlists on Spotify

Get a list of tracks in a Spotify playlist

Get a list of recently played tracks on Spotify

Get a list of tracks saved in the user's "Liked Songs" library

Remove one or more tracks from the user's "Liked Songs" library (max 40 per request)

Get a list of the currently playing track and the next items in your Spotify queue

Get information about the user's available Spotify Connect devices

Get the current user's top (most-played) tracks over a given time range. This is the closest thing Spotify exposes to listening statistics.

Get the current user's top (most-played) artists over a given time range. This is the closest thing Spotify exposes to listening statistics.

Start playing a Spotify track, album, artist, or playlist. Pass a Spotify URI (e.g. spotify:track:xxx, spotify:album:xxx) via "uri". For albums/playlists you can also use "context_uri". Device is selected automatically, so "deviceId" and "device_id" are optional.

Pause Spotify playback on the active device

Skip to the next track in the current Spotify playback queue

Skip to the previous track in the current Spotify playback queue

Create a new playlist on Spotify

Add tracks or podcast episodes to a Spotify playlist. Accepts Spotify track IDs, episode IDs, or full Spotify URIs (e.g. spotify:episode:xxx).

Resume Spotify playback on the active device

Adds a track, album, artist or playlist to the playback queue

Set the playback volume to a specific percentage (0-100). Requires Spotify Premium.

Adjust the playback volume up or down by a relative amount. Use positive values to increase, negative to decrease. Requires Spotify Premium.

Get detailed information about one or more albums by their Spotify IDs

Get tracks from a specific album with pagination support

Save or remove albums from the user's "Your Music" library

Check if albums are saved in the user's "Your Music" library

Get details of a specific Spotify playlist including tracks count, description and owner

Update the details of a Spotify playlist (name, description, public/private, collaborative)

Remove one or more tracks from a Spotify playlist (max 100 tracks per request)

Reorder a range of tracks within a Spotify playlist by moving them to a new position

Remove a playlist from the current user's library (unfollow). Note: Spotify does not allow permanent deletion of playlists via the API.

Get BPM, key, mode, energy, danceability, valence, and related audio features for 1–100 exact Spotify track IDs with field-level provenance.

Legacy tempo/energy ordering utility. Use planDjSet for professional set planning. Dry-run is the safe default.

Compare exact Spotify track IDs across available audio-analysis providers. Reports field-level provenance, missing providers, half/double-time-aware conflicts, and provider failures without changing Spotify.

Audit a complete Spotify playlist for audio-feature coverage, duplicate recordings, tempo ambiguity, provider conflicts, and heuristic opening/peak/reset candidates without changing Spotify.

Analyze a complete Spotify playlist for professional set-order planning. Returns snapshot-bound BPM, Camelot key, relative energy, provenance, confidence when available, and unresolved data without changing Spotify.

Create an immutable, snapshot-bound professional DJ set-order plan balancing tempo, Camelot compatibility, energy arc, artist spacing, constraints, and data quality. Does not change Spotify.

Dry-run, apply, or dynamically restore an immutable DJ plan with snapshot checks, durable progress receipts, ambiguous-write reconciliation, and final order verification. Dry-run is the default.