Spotify

Spotify integration (Design, Social). Imported from open-connector.

OAuth85 toolshttps://api.spotify.com/v1

GET

spotify_get_current_user_profile

Get Current User Profile using the Spotify Web API.

/me

3 parameters

Param	Type	Required	Description
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.

GET

spotify_search_items

Search Items using the Spotify Web API.

/search

5 parameters

Param	Type	Required	Description
query	string	required	Spotify search query.
types	array	required	Spotify item types to search.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.

GET

spotify_get_user_top_tracks

Get User Top Tracks using the Spotify Web API.

/me/top/tracks

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_user_top_artists

Get User Top Artists using the Spotify Web API.

/me/top/artists

6 parameters

Param	Type	Required	Description
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
timestamp	string	optional	ISO timestamp for featured playlist lookup.

GET

spotify_get_playlist

Get Playlist using the Spotify Web API.

/playlists/{playlistId}

32 parameters

Param	Type	Required	Description
playlistId	string	required	Spotify playlist ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_playlist_items

Get Playlist Items using the Spotify Web API.

/playlists/{playlistId}/tracks

32 parameters

Param	Type	Required	Description
playlistId	string	required	Spotify playlist ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_album

Get Album using the Spotify Web API.

/albums/{albumId}

32 parameters

Param	Type	Required	Description
albumId	string	required	Spotify album ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_album_tracks

Get Album Tracks using the Spotify Web API.

/albums/{albumId}/tracks

32 parameters

Param	Type	Required	Description
albumId	string	required	Spotify album ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_artist

Get Artist using the Spotify Web API.

/artists/{artistId}

4 parameters

Param	Type	Required	Description
artistId	string	required	Spotify artist ID.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.

GET

spotify_get_artist_albums

Get Artist Albums using the Spotify Web API.

/artists/{artistId}/albums

32 parameters

Param	Type	Required	Description
artistId	string	required	Spotify artist ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_artist_related_artists

Get Artist Related Artists using the Spotify Web API.

/artists/{artistId}/related-artists

4 parameters

Param	Type	Required	Description
artistId	string	required	Spotify artist ID.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.

GET

spotify_get_artist_top_tracks

Get Artist Top Tracks using the Spotify Web API.

/artists/{artistId}/top-tracks

32 parameters

Param	Type	Required	Description
artistId	string	required	Spotify artist ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	required	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_track

Get Track using the Spotify Web API.

/tracks/{trackId}

32 parameters

Param	Type	Required	Description
trackId	string	required	Spotify track ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_several_tracks

Get Several Tracks using the Spotify Web API.

/tracks

32 parameters

Param	Type	Required	Description
trackIds	array	required	Spotify track IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_several_artists

Get Several Artists using the Spotify Web API.

/artists

4 parameters

Param	Type	Required	Description
artistIds	array	required	Spotify artist IDs.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.

GET

spotify_get_several_albums

Get Several Albums using the Spotify Web API.

/albums

32 parameters

Param	Type	Required	Description
albumIds	array	required	Spotify album IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_track_audio_features

Get Track Audio Features using the Spotify Web API.

/audio-features/{trackId}

32 parameters

Param	Type	Required	Description
trackId	string	required	Spotify track ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_several_track_audio_features

Get Several Track Audio Features using the Spotify Web API.

/audio-features

32 parameters

Param	Type	Required	Description
trackIds	array	required	Spotify track IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_track_audio_analysis

Get Track Audio Analysis using the Spotify Web API.

/audio-analysis/{trackId}

32 parameters

Param	Type	Required	Description
trackId	string	required	Spotify track ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_recommendations

Get Recommendations using the Spotify Web API.

/recommendations

3 parameters

Param	Type	Required	Description
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.

GET

spotify_get_available_genre_seeds

Get Available Genre Seeds using the Spotify Web API.

/recommendations/available-genre-seeds

3 parameters

Param	Type	Required	Description
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.

GET

spotify_get_available_markets

Get Available Markets using the Spotify Web API.

/markets

3 parameters

Param	Type	Required	Description
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.

GET

spotify_get_playlist_cover_image

Get Playlist Cover Image using the Spotify Web API.

/playlists/{playlistId}/images

32 parameters

Param	Type	Required	Description
playlistId	string	required	Spotify playlist ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

POST

spotify_create_playlist

Create Playlist using the Spotify Web API.

/users/{userId}/playlists

33 parameters

Param	Type	Required	Description
userId	string	required	Spotify user ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
name	string	required	Playlist name.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

PUT

spotify_change_playlist_details

Change Playlist Details using the Spotify Web API.

/playlists/{playlistId}

32 parameters

Param	Type	Required	Description
playlistId	string	required	Spotify playlist ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

POST

spotify_add_items_to_playlist

Add Items To Playlist using the Spotify Web API.

/playlists/{playlistId}/tracks

32 parameters

Param	Type	Required	Description
playlistId	string	required	Spotify playlist ID.
uris	array	required	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

PUT

spotify_follow_playlist

Follow Playlist using the Spotify Web API.

/playlists/{playlistId}/followers

32 parameters

Param	Type	Required	Description
playlistId	string	required	Spotify playlist ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

DELETE

spotify_unfollow_playlist

Unfollow Playlist using the Spotify Web API.

/playlists/{playlistId}/followers

32 parameters

Param	Type	Required	Description
playlistId	string	required	Spotify playlist ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_show

Get Show using the Spotify Web API.

/shows/{showId}

32 parameters

Param	Type	Required	Description
showId	string	required	Spotify show ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_show_episodes

Get Show Episodes using the Spotify Web API.

/shows/{showId}/episodes

32 parameters

Param	Type	Required	Description
showId	string	required	Spotify show ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_episode

Get Episode using the Spotify Web API.

/episodes/{episodeId}

32 parameters

Param	Type	Required	Description
episodeId	string	required	Spotify episode ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_several_episodes

Get Several Episodes using the Spotify Web API.

/episodes

32 parameters

Param	Type	Required	Description
episodeIds	array	required	Spotify episode IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_audiobook

Get Audiobook using the Spotify Web API.

/audiobooks/{audiobookId}

32 parameters

Param	Type	Required	Description
audiobookId	string	required	Spotify audiobook ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_audiobook_chapters

Get Audiobook Chapters using the Spotify Web API.

/audiobooks/{audiobookId}/chapters

32 parameters

Param	Type	Required	Description
audiobookId	string	required	Spotify audiobook ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_chapter

Get Chapter using the Spotify Web API.

/chapters/{chapterId}

32 parameters

Param	Type	Required	Description
chapterId	string	required	Spotify chapter ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_several_audiobooks

Get Several Audiobooks using the Spotify Web API.

/audiobooks

32 parameters

Param	Type	Required	Description
audiobookIds	array	required	Spotify audiobook IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_several_chapters

Get Several Chapters using the Spotify Web API.

/chapters

32 parameters

Param	Type	Required	Description
chapterIds	array	required	Spotify chapter IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_several_shows

Get Several Shows using the Spotify Web API.

/shows

32 parameters

Param	Type	Required	Description
showIds	array	required	Spotify show IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_featured_playlists

Get Featured Playlists using the Spotify Web API.

/browse/featured-playlists

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_new_releases

Get New Releases using the Spotify Web API.

/browse/new-releases

6 parameters

Param	Type	Required	Description
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
timestamp	string	optional	ISO timestamp for featured playlist lookup.

GET

spotify_get_browse_categories

Get Browse Categories using the Spotify Web API.

/browse/categories

6 parameters

Param	Type	Required	Description
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
timestamp	string	optional	ISO timestamp for featured playlist lookup.

GET

spotify_get_browse_category

Get Browse Category using the Spotify Web API.

/browse/categories/{categoryId}

7 parameters

Param	Type	Required	Description
categoryId	string	required	Spotify browse category ID.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
timestamp	string	optional	ISO timestamp for featured playlist lookup.

GET

spotify_get_category_playlists

Get Category Playlists using the Spotify Web API.

/browse/categories/{categoryId}/playlists

32 parameters

Param	Type	Required	Description
categoryId	string	required	Spotify browse category ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_user_profile

Get User Profile using the Spotify Web API.

/users/{userId}

4 parameters

Param	Type	Required	Description
userId	string	required	Spotify user ID.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.

GET

spotify_get_current_user_playlists

Get Current User Playlists using the Spotify Web API.

/me/playlists

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_user_playlists

Get User Playlists using the Spotify Web API.

/users/{userId}/playlists

32 parameters

Param	Type	Required	Description
userId	string	required	Spotify user ID.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

PUT

spotify_save_albums_for_current_user

Save Albums For Current User using the Spotify Web API.

/me/albums

32 parameters

Param	Type	Required	Description
albumIds	array	required	Spotify album IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

DELETE

spotify_remove_users_saved_albums

Remove Users Saved Albums using the Spotify Web API.

/me/albums

32 parameters

Param	Type	Required	Description
albumIds	array	required	Spotify album IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

PUT

spotify_save_audiobooks_for_current_user

Save Audiobooks For Current User using the Spotify Web API.

/me/audiobooks

32 parameters

Param	Type	Required	Description
audiobookIds	array	required	Spotify audiobook IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

DELETE

spotify_remove_user_s_saved_audiobooks

Remove User S Saved Audiobooks using the Spotify Web API.

/me/audiobooks

32 parameters

Param	Type	Required	Description
audiobookIds	array	required	Spotify audiobook IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

PUT

spotify_save_episodes_for_current_user

Save Episodes For Current User using the Spotify Web API.

/me/episodes

32 parameters

Param	Type	Required	Description
episodeIds	array	required	Spotify episode IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

DELETE

spotify_remove_user_s_saved_episodes

Remove User S Saved Episodes using the Spotify Web API.

/me/episodes

32 parameters

Param	Type	Required	Description
episodeIds	array	required	Spotify episode IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

PUT

spotify_save_shows_for_current_user

Save Shows For Current User using the Spotify Web API.

/me/shows

32 parameters

Param	Type	Required	Description
showIds	array	required	Spotify show IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

DELETE

spotify_remove_user_s_saved_shows

Remove User S Saved Shows using the Spotify Web API.

/me/shows

32 parameters

Param	Type	Required	Description
showIds	array	required	Spotify show IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

PUT

spotify_save_tracks_for_current_user

Save Tracks For Current User using the Spotify Web API.

/me/tracks

32 parameters

Param	Type	Required	Description
trackIds	array	required	Spotify track IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

DELETE

spotify_remove_user_s_saved_tracks

Remove User S Saved Tracks using the Spotify Web API.

/me/tracks

32 parameters

Param	Type	Required	Description
trackIds	array	required	Spotify track IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_user_saved_albums

Get User Saved Albums using the Spotify Web API.

/me/albums

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_user_saved_audiobooks

Get User Saved Audiobooks using the Spotify Web API.

/me/audiobooks

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_user_saved_episodes

Get User Saved Episodes using the Spotify Web API.

/me/episodes

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_user_saved_shows

Get User Saved Shows using the Spotify Web API.

/me/shows

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_user_saved_tracks

Get User Saved Tracks using the Spotify Web API.

/me/tracks

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_check_saved_albums

Check Saved Albums using the Spotify Web API.

/me/albums/contains

32 parameters

Param	Type	Required	Description
albumIds	array	required	Spotify album IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_check_saved_audiobooks

Check Saved Audiobooks using the Spotify Web API.

/me/audiobooks/contains

32 parameters

Param	Type	Required	Description
audiobookIds	array	required	Spotify audiobook IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_check_saved_episodes

Check Saved Episodes using the Spotify Web API.

/me/episodes/contains

32 parameters

Param	Type	Required	Description
episodeIds	array	required	Spotify episode IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_check_saved_shows

Check Saved Shows using the Spotify Web API.

/me/shows/contains

32 parameters

Param	Type	Required	Description
showIds	array	required	Spotify show IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_check_saved_tracks

Check Saved Tracks using the Spotify Web API.

/me/tracks/contains

32 parameters

Param	Type	Required	Description
trackIds	array	required	Spotify track IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

PUT

spotify_follow_artists_or_users

Follow Artists Or Users using the Spotify Web API.

/me/following

5 parameters

Param	Type	Required	Description
ids	array	required	Spotify artist or user IDs.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
type	string	required	Whether the follow target is an artist or user.

DELETE

spotify_unfollow_artists_or_users

Unfollow Artists Or Users using the Spotify Web API.

/me/following

5 parameters

Param	Type	Required	Description
ids	array	required	Spotify artist or user IDs.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
type	string	required	Whether the follow target is an artist or user.

GET

spotify_get_followed_artists

Get Followed Artists using the Spotify Web API.

/me/following

3 parameters

Param	Type	Required	Description
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.

GET

spotify_check_user_follows_artists_or_users

Check User Follows Artists Or Users using the Spotify Web API.

/me/following/contains

5 parameters

Param	Type	Required	Description
ids	array	required	Spotify artist or user IDs.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
type	string	required	Whether the follow target is an artist or user.

GET

spotify_check_users_follow_playlist

Check Users Follow Playlist using the Spotify Web API.

/playlists/{playlistId}/followers/contains

33 parameters

Param	Type	Required	Description
playlistId	string	required	Spotify playlist ID.
userIds	array	required	Spotify user IDs.
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_available_devices

Get Available Devices using the Spotify Web API.

/me/player/devices

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

PUT

spotify_pause_playback

Pause Playback using the Spotify Web API.

/me/player/pause

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

PUT

spotify_seek_to_position

Seek To Position using the Spotify Web API.

/me/player/seek

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	required	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

PUT

spotify_set_repeat_mode

Set Repeat Mode using the Spotify Web API.

/me/player/repeat

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	required	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

PUT

spotify_set_playback_volume

Set Playback Volume using the Spotify Web API.

/me/player/volume

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	required	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

POST

spotify_skip_to_next

Skip To Next using the Spotify Web API.

/me/player/next

3 parameters

Param	Type	Required	Description
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.

POST

spotify_skip_to_previous

Skip To Previous using the Spotify Web API.

/me/player/previous

3 parameters

Param	Type	Required	Description
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.

PUT

spotify_toggle_playback_shuffle

Toggle Playback Shuffle using the Spotify Web API.

/me/player/shuffle

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

PUT

spotify_transfer_playback

Transfer Playback using the Spotify Web API.

/me/player

32 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
deviceIds	array	required	Spotify Connect device IDs.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

POST

spotify_add_item_to_playback_queue

Add Item To Playback Queue using the Spotify Web API.

/me/player/queue

32 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
uri	string	required	Spotify URI.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_playback_state

Get Playback State using the Spotify Web API.

/me/player

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_currently_playing_track

Get Currently Playing Track using the Spotify Web API.

/me/player/currently-playing

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_recently_played_tracks

Get Recently Played Tracks using the Spotify Web API.

/me/player/recently-played

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.

GET

spotify_get_user_queue

Get User Queue using the Spotify Web API.

/me/player/queue

31 parameters

Param	Type	Required	Description
uris	array	optional	Spotify URIs in the order Spotify should use.
description	string	optional	Playlist description.
public	boolean	optional	Whether the playlist should be public.
collaborative	boolean	optional	Whether the playlist should be collaborative.
market	string	optional	An ISO 3166-1 alpha-2 country code or from_token to apply market filtering.
country	string	optional	An ISO 3166-1 alpha-2 country code.
locale	string	optional	Locale code such as en_US used by Spotify browse endpoints.
limit	integer	optional	Maximum number of items to return.
offset	integer	optional	Zero-based index of the first item to return.
timeRange	string	optional	Spotify top-items time range.
includeGroups	array	optional	Album groups to include.
seedArtists	array	optional	Artist seeds used by Spotify recommendations.
seedTracks	array	optional	Track seeds used by Spotify recommendations.
seedGenres	array	optional	Genre seeds used by Spotify recommendations.
includeExternalAudio	boolean	optional	Whether externally hosted audio should be included in search results.
position	integer	optional	Zero-based playlist insert position.
rangeStart	integer	optional	The position of the first item to reorder.
insertBefore	integer	optional	The position where the reordered items should be inserted.
rangeLength	integer	optional	The number of items to reorder.
snapshotId	string	optional	Playlist snapshot ID.
after	integer	optional	Unix timestamp in milliseconds or cursor after which to return items.
before	integer	optional	Unix timestamp in milliseconds before which to return items.
deviceId	string	optional	Spotify Connect device ID.
state	string	optional	Playback repeat or shuffle state.
volumePercent	integer	optional	Volume percentage from 0 to 100.
positionMs	integer	optional	Playback position in milliseconds.
play	boolean	optional	Whether playback should start after transfer.
contextUri	string	optional	Spotify context URI to play.
additionalTypes	array	optional	Additional item types for playback endpoints.
timestamp	string	optional	ISO timestamp for featured playlist lookup.
timestampedTrackIds	array	optional	Timestamped track IDs for saved-track import.