PrecisionBook a discovery call
Menu

Spotify for AI agents

Agents read Spotify at once. Changes and sends are held for a person's approval by default.

Book a discovery callBrowse all connectors

About Spotify

Spotify is a digital music and podcast streaming service with millions of tracks, personalized playlists, and social sharing features

What an agent can do in Spotify

Every Spotify action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.

Runs at once (reads)

Looks things up in Spotify without asking first. 55 actions.

  • Get Artist's Top TracksGet Spotify catalog information about an artist's top tracks by country/market. Returns up to 10 of the artist's most popular tracks in the specified market. Each track includes detailed metadata such
  • Get playlistGet a playlist owned by a Spotify user. This endpoint retrieves detailed information about a specific Spotify playlist, including its metadata (name, description, public/collaborative status), owner i
  • Get showGet Spotify catalog information for a single show (podcast) identified by its unique Spotify ID.
  • Get show episodesGet Spotify catalog information about a show's episodes. Optional parameters can be used to limit the number of episodes returned. This endpoint retrieves a paginated list of episodes for a specific p
  • Check if user follows artists or usersCheck to see if the current user is following one or more artists or other Spotify users.
  • Check if users follow playlistCheck if the current authenticated user is following a specified playlist. This endpoint checks whether the authenticated user follows the given playlist. It returns a boolean value indicating whether
  • Check user s saved albumsCheck if one or more albums is already saved in the current Spotify user's 'Your Music' library.
  • Check user s saved audiobooksCheck if one or more audiobooks are already saved in the current Spotify user's library. Returns an array of boolean values indicating whether each audiobook (by ID) is saved in the user's library. Re
  • Check User's Saved EpisodesCheck if one or more podcast episodes are saved in the current Spotify user's 'Your Episodes' library. Returns an array of boolean values corresponding to each episode ID provided. **Required OAuth Sc
  • Check user's saved showsCheck if one or more shows is already saved in the current Spotify user's library. This endpoint checks whether the specified shows are saved in the authenticated user's library. It returns a list of
  • Check User's Saved TracksCheck if one or more tracks is already saved in the current Spotify user's 'Your Music' library. Returns an array of boolean values indicating whether each track is saved (true) or not (false), in the
  • Get a chapterGet Spotify catalog information for a single audiobook chapter including name, description, duration, release date, narrators, and playback information. Audiobook chapters are only available within th
Show all 55
  • Get Album DetailsGet Spotify catalog information for a single album. Returns comprehensive album data including metadata, track listing, artist information, cover artwork, popularity score, and availability by market.
  • Get album tracksGet Spotify catalog information about an album's tracks. Optional parameters can be used to limit the number of tracks returned.
  • Get an audiobookGet Spotify catalog information for a single audiobook. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.
  • Get artistGet detailed Spotify catalog information for a single artist. Returns comprehensive artist data including the artist's name, genres, follower count, profile images, popularity score (0-100), and links
  • Get artist s albumsGet Spotify catalog information about an artist's albums.
  • Get artist s related artistsGet Spotify catalog information about artists similar to a given artist. Similarity is based on analysis of the Spotify community's listening history.
  • Get audiobook chaptersGet Spotify catalog information about an audiobook's chapters. Audiobooks are only available within the US, UK, Canada, Ireland, New Zealand and Australia markets.
  • Get Available DevicesGet information about the user's available Spotify Connect devices. Returns a list of devices that can be used for playback, including their names, types (computer, smartphone, speaker), active status
  • Get available marketsGet the list of markets where Spotify is available. Returns an array of ISO 3166-1 alpha-2 country codes.
  • Get currently playing trackGet the object currently being played on the user's Spotify account.
  • Get current user s playlistsGet a list of the playlists owned or followed by the current Spotify user. Returns a paginated list of playlists (both public and private) that the current user owns or follows. Each playlist includes
  • Get current user s profileGet detailed profile information about the current authenticated user. This endpoint returns comprehensive user profile data including display name, email address, country, subscription level (premium
  • Get episodeGet Spotify catalog information for a single podcast episode identified by its unique Spotify ID. This endpoint retrieves detailed information about a podcast episode including its name, description,
  • Get featured playlistsGet a list of Spotify's editorially curated featured playlists. These are the playlists shown on a Spotify player's 'Browse' tab and are updated regularly by Spotify's editorial team. The response inc
  • Get followed artistsGet all artists followed by the current user. Returns a cursor-paginated list of artist objects with full details including name, genres, popularity, images, and follower counts. Use the 'after' param
  • Get new releasesGet a list of new album releases featured in Spotify (shown, for example, on a Spotify player's "Browse" tab).
  • Get playback stateGet information about the user's current playback state, including track or episode, progress, and active device. Returns detailed playback information when content is actively playing, including the
  • Get playlist cover imageGet the current image(s) associated with a specific playlist. Returns an array of image objects containing the URL, height, and width of each cover image. The array may be empty if the playlist has no
  • Get playlist itemsGet full details of the items of a playlist owned by a Spotify user. This endpoint retrieves the tracks and/or episodes in a playlist. It supports pagination and allows filtering the response fields f
  • Get recently played tracksGet tracks from the current user's recently played tracks. _**Note**: Currently doesn't support podcast episodes._
  • Get recommendationsGet track recommendations based on seed artists, genres, and/or tracks. At least one seed is required (up to 5 total). Optionally tune recommendations with audio feature parameters (acousticness, danc
  • Get several albumsGet Spotify catalog information for multiple albums identified by their Spotify IDs. Returns detailed album data including name, artists, tracks, release date, images, and more. Maximum 20 album IDs p
  • Get several artistsGet Spotify catalog information for several artists based on their Spotify IDs.
  • Get several audiobooksRetrieve Spotify catalog information for multiple audiobooks in a single request. This action fetches detailed metadata for up to 50 audiobooks at once using their Spotify IDs. Each audiobook object i
  • Get several browse categoriesGet a list of categories used to tag items in Spotify (on, for example, the Spotify player's "Browse" tab).
  • Get several chaptersGet Spotify catalog information for several audiobook chapters identified by their Spotify IDs. This endpoint allows you to fetch detailed information about up to 50 chapters at once, including chapte
  • Get several episodesGet Spotify catalog information for several episodes based on their Spotify IDs.
  • Get several showsGet Spotify catalog information for several shows (podcasts) based on their Spotify IDs. This endpoint allows you to retrieve detailed information about multiple shows in a single request, with a maxi
  • Get several tracksGet Spotify catalog information for multiple tracks based on their Spotify IDs.
  • Get single browse categoryGet a single category used to tag items in Spotify (on, for example, the Spotify player's "Browse" tab). Returns detailed information about the category including its name, icons, and unique identifie
  • Get the user's queueGet the list of tracks and episodes in the user's playback queue. Returns the currently playing track/episode and the queue of upcoming items. This is a read-only operation that does not modify the qu
  • Get trackGet Spotify catalog information for a single track identified by its unique Spotify ID.
  • Get Track's Audio AnalysisGet a comprehensive audio analysis for a Spotify track. Returns detailed structural and musical characteristics including: - Meta information (analyzer version, timestamp, processing time) - Track pro
  • Get user's playlistsGet a paginated list of playlists owned or followed by a Spotify user. This endpoint retrieves all public playlists for any user. To access private and collaborative playlists, you must have the appro
  • Get user's profileGet public profile information about a Spotify user. This endpoint retrieves publicly available information for any Spotify user, including their display name, profile images, follower count, and Spot
  • Get user s saved albumsGet a list of albums saved in the current Spotify user's library ('Your Music'). Returns a paginated list of albums that the user has saved to their library, including when each album was added and fu
  • Get user s saved audiobooksGet a list of the audiobooks saved in the current Spotify user's 'Your Music' library.
  • Get user's saved episodesGet a list of episodes saved in the current Spotify user's library. This endpoint retrieves a paginated list of podcast episodes that the authenticated user has saved to their Spotify library. Each it
  • Get User's Saved ShowsGet a list of shows saved in the current Spotify user's library. Optional parameters can be used to limit the number of shows returned.
  • Get User's Saved TracksGet a list of the songs saved in the current Spotify user's 'Your Music' library. Returns paginated results with track details including album info, artists, duration, and when each track was saved.
  • Get User's Top ArtistsGet the current user's top artists based on calculated affinity. This endpoint retrieves the current user's top artists based on their listening history and calculated affinity. The affinity is comput
  • Get User's Top TracksGet the current user's top tracks based on calculated affinity. Returns the user's most-played tracks over different time periods based on their listening history and calculated affinity. Required OAu
  • Search for itemGet Spotify catalog information about albums, artists, playlists, tracks, shows, episodes or audiobooks that match a keyword string. Audiobooks are only available within the US, UK, Canada, Ireland, N

Held for approval by default (changes and sends)

Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 29 actions.

  • Add items to playlistAdd one or more items to a user's playlist.
  • Create playlistCreate a playlist for a Spotify user. (The playlist will be empty until you [add tracks](/documentation/web-api/reference/add-tracks-to-playlist).) Each user is generally limited to a maximum of 11000
  • Save albums for current userSave one or more albums to the current user's 'Your Music' library. This action adds albums to the user's saved albums collection, which can be accessed later through 'Your Library'. The operation is
  • Save tracks for current userSave one or more tracks to the current user's 'Your Music' library. This action adds tracks to the user's saved tracks collection. You can provide either: - A simple list of track IDs (up to 50) - A l
  • Add item to playback queueAdd an item to the end of the user's current playback queue. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player AP
  • Change playlist detailsChange a playlist's name and public/private state. The user must own the playlist. This action allows updating the playlist name, description, public/private status, and collaborative mode. At least o
  • Follow artists or usersFollow one or more artists or Spotify users on behalf of the current authenticated user. This action adds the specified artists or users to the current user's "Following" list, making their content ap
  • Follow playlistAdd the current user as a follower of a playlist. This action adds the current user as a follower of a specified playlist. The 'public' parameter controls whether the playlist will appear in the user'
  • Pause playbackPause playback on the user's account. Pauses playback on the currently active device or on a specified device. Returns immediately with success when playback is paused. If no device is specified, the
  • Remove playlist itemsRemove one or more items from a user's playlist. This endpoint removes tracks or episodes from a playlist. You can remove items by URI (removes all occurrences) or by URI + positions (removes specific
  • Remove users saved albumsRemove one or more albums from the current user's 'Your Music' library. This action removes albums from the user's saved albums collection in 'Your Library'. The operation is idempotent - removing an
  • Remove User's Saved AudiobooksRemove one or more audiobooks from the current user's Spotify library. This endpoint removes saved audiobooks from the user's library. Audiobook IDs can be specified as a comma-separated string or as
Show all 29
  • Remove user's saved episodesRemove one or more episodes from the current user's library. This endpoint removes episodes that have been saved to the user's "Your Episodes" library. The operation is idempotent - removing an episod
  • Remove user s saved showsDelete one or more shows from current Spotify user's library.
  • Remove user s saved tracksRemove one or more tracks from the current user's 'Your Music' library.
  • Save audiobooks for current userSave one or more audiobooks to the current user's library. This action adds audiobooks to the user's saved audiobooks collection, which can be accessed later through 'Your Library'. The operation is i
  • Save episodes for current userSave one or more podcast episodes to the current user's library. This endpoint saves episodes to the user's "Your Episodes" library, making them easily accessible for later playback. The operation is
  • Save shows for current userSave one or more shows to current Spotify user's library. Requires the user-library-modify scope. Maximum of 50 show IDs per request.
  • Seek to positionSeek to a specific position in the user's currently playing track. This action allows you to skip to any point in the currently playing track by specifying a position in milliseconds. For example, to
  • Set playback volumeSet the volume for the user's current playback device. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endp
  • Set repeat modeSet the repeat mode for the user's playback. Controls whether playback should repeat the current track, the current context (playlist, album, etc.), or not repeat at all. The change takes effect immed
  • Skip to nextSkips to next track in the user's queue. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints.
  • Skip to previousSkips to the previous track in the user's queue. Requirements: - Spotify Premium subscription - Active playback (user must be currently playing music) - Requires 'user-modify-playback-state' scope Not
  • Start resume playbackStart a new context or resume current playback on the user's active device. Starts playback of a specific context (album, artist, or playlist), a list of tracks, or resumes currently paused playback.
  • Toggle playback shuffleToggle shuffle on or off for user's playback. This API only works for users who have Spotify Premium. The order of execution is not guaranteed when you use this API with other Player API endpoints. Re
  • Transfer playbackTransfer playback to a new device and optionally begin playback. Requirements: - Spotify Premium subscription is required - Target device must be active and available (use Get Available Devices to ret
  • Unfollow artists or usersRemove the current user as a follower of one or more artists or other Spotify users. This action removes the specified artists or users from the current user's "Following" list, stopping their content
  • Unfollow playlistRemove the current user as a follower of a playlist. This action removes the current user from following a playlist. The user no longer receives updates from the playlist and it is removed from their
  • Update playlist itemsEither replace all tracks in a playlist OR reorder existing tracks within it. **REPLACE mode**: Use `uris` parameter to completely overwrite all tracks in the playlist. Example: Replace all tracks wit

Changes wait in Needs you

Changes and sends in Spotify are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

How approvals work

Spotify questions

Can an agent change data in Spotify on its own?

Not by default. Changes and sends in Spotify are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

What can an agent read in Spotify?

This connector lists 55 read actions. Reads run at once, without waiting for approval.

How does Spotify connect?

It connects with OAuth 2.0. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.

Bring Spotify to your agents.

Book a discovery call