Skip to content
DocumentationAPI Reference

Me

Get Current User's Profile
$ spotted me retrieve
GET/me

MeAudiobooks

Get User's Saved Audiobooks
$ spotted me:audiobooks list
GET/me/audiobooks
Save Audiobooks for Current User
$ spotted me:audiobooks save
PUT/me/audiobooks
Remove User's Saved Audiobooks
$ spotted me:audiobooks remove
DELETE/me/audiobooks
Check User's Saved Audiobooks
$ spotted me:audiobooks check
GET/me/audiobooks/contains

MePlaylists

Get Current User's Playlists
$ spotted me:playlists list
GET/me/playlists

MeTop

Get User's Top Tracks
$ spotted me:top list-top-tracks
GET/me/top/tracks
Get User's Top Artists
$ spotted me:top list-top-artists
GET/me/top/artists

MeAlbums

Get User's Saved Albums
$ spotted me:albums list
GET/me/albums
Save Albums for Current User
$ spotted me:albums save
PUT/me/albums
Remove Users' Saved Albums
$ spotted me:albums remove
DELETE/me/albums
Check User's Saved Albums
$ spotted me:albums check
GET/me/albums/contains

MeTracks

Get User's Saved Tracks
$ spotted me:tracks list
GET/me/tracks
Save Tracks for Current User
$ spotted me:tracks save
PUT/me/tracks
Remove User's Saved Tracks
$ spotted me:tracks remove
DELETE/me/tracks
Check User's Saved Tracks
$ spotted me:tracks check
GET/me/tracks/contains

MeEpisodes

Get User's Saved Episodes
$ spotted me:episodes list
GET/me/episodes
Save Episodes for Current User
$ spotted me:episodes save
PUT/me/episodes
Remove User's Saved Episodes
$ spotted me:episodes remove
DELETE/me/episodes
Check User's Saved Episodes
$ spotted me:episodes check
GET/me/episodes/contains

MeShows

Get User's Saved Shows
$ spotted me:shows list
GET/me/shows
Save Shows for Current User
$ spotted me:shows save
PUT/me/shows
Remove User's Saved Shows
$ spotted me:shows remove
DELETE/me/shows
Check User's Saved Shows
$ spotted me:shows check
GET/me/shows/contains

MeFollowing

Get Followed Artists
$ spotted me:following bulk-retrieve
GET/me/following
Follow Artists or Users
$ spotted me:following follow
PUT/me/following
Unfollow Artists or Users
$ spotted me:following unfollow
DELETE/me/following
Check If User Follows Artists or Users
$ spotted me:following check
GET/me/following/contains

MePlayer

Get Playback State
$ spotted me:player get-state
GET/me/player
Transfer Playback
$ spotted me:player transfer
PUT/me/player
Get Available Devices
$ spotted me:player get-devices
GET/me/player/devices
Get Currently Playing Track
$ spotted me:player get-currently-playing
GET/me/player/currently-playing
Start/Resume Playback
$ spotted me:player start-playback
PUT/me/player/play
Pause Playback
$ spotted me:player pause-playback
PUT/me/player/pause
Skip To Next
$ spotted me:player skip-next
POST/me/player/next
Skip To Previous
$ spotted me:player skip-previous
POST/me/player/previous
Seek To Position
$ spotted me:player seek-to-position
PUT/me/player/seek
Set Repeat Mode
$ spotted me:player set-repeat-mode
PUT/me/player/repeat
Set Playback Volume
$ spotted me:player set-volume
PUT/me/player/volume
Toggle Playback Shuffle
$ spotted me:player toggle-shuffle
PUT/me/player/shuffle
Get Recently Played Tracks
$ spotted me:player list-recently-played
GET/me/player/recently-played
ModelsExpand Collapse
context_object: object { external_urls, href, published, 2 more }
external_urls: optional object { published, spotify }

External URLs for this context.

published: optional boolean

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

spotify: optional string

The Spotify URL for the object.

href: optional string

A link to the Web API endpoint providing full details of the track.

published: optional boolean

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

type: optional string

The object type, e.g. "artist", "playlist", "album", "show".

uri: optional string

The Spotify URI for the context.

device_object: object { id, is_active, is_private_session, 6 more }
id: optional string

The device ID. This ID is unique and persistent to some extent. However, this is not guaranteed and any cached device_id should periodically be cleared out and refetched as necessary.

is_active: optional boolean

If this device is the currently active device.

is_private_session: optional boolean

If this device is currently in a private session.

is_restricted: optional boolean

Whether controlling this device is restricted. At present if this is "true" then no Web API commands will be accepted by this device.

name: optional string

A human-readable name for the device. Some devices have a name that the user can configure (e.g. "Loudest speaker") and some devices have a generic name associated with the manufacturer or device model.

published: optional boolean

The playlist's public/private status (if it should be added to the user's profile or not): true the playlist will be public, false the playlist will be private, null the playlist status is not relevant. For more about public/private status, see Working with Playlists

supports_volume: optional boolean

If this device can be used to set the volume.

type: optional string

Device type, such as "computer", "smartphone" or "speaker".

volume_percent: optional number

The current volume in percent.

minimum0
maximum100

MePlayerQueue

Get the User's Queue
$ spotted me:player:queue get
GET/me/player/queue
Add Item to Playback Queue
$ spotted me:player:queue add
POST/me/player/queue