Skip to content
DocumentationAPI Reference

Me

Get Current User's Profile
client.Me.Get(ctx) (*MeGetResponse, error)
GET/me

MeAudiobooks

Get User's Saved Audiobooks
client.Me.Audiobooks.List(ctx, query) (*CursorURLPage[MeAudiobookListResponse], error)
GET/me/audiobooks
Save Audiobooks for Current User
client.Me.Audiobooks.Save(ctx, body) error
PUT/me/audiobooks
Remove User's Saved Audiobooks
client.Me.Audiobooks.Remove(ctx, body) error
DELETE/me/audiobooks
Check User's Saved Audiobooks
client.Me.Audiobooks.Check(ctx, query) (*[]bool, error)
GET/me/audiobooks/contains

MePlaylists

Get Current User's Playlists
client.Me.Playlists.List(ctx, query) (*CursorURLPage[SimplifiedPlaylistObject], error)
GET/me/playlists

MeTop

Get User's Top Tracks
client.Me.Top.ListTopTracks(ctx, query) (*CursorURLPage[TrackObject], error)
GET/me/top/tracks
Get User's Top Artists
client.Me.Top.ListTopArtists(ctx, query) (*CursorURLPage[ArtistObject], error)
GET/me/top/artists

MeAlbums

Get User's Saved Albums
client.Me.Albums.List(ctx, query) (*CursorURLPage[MeAlbumListResponse], error)
GET/me/albums
Save Albums for Current User
client.Me.Albums.Save(ctx, body) error
PUT/me/albums
Remove Users' Saved Albums
client.Me.Albums.Remove(ctx, body) error
DELETE/me/albums
Check User's Saved Albums
client.Me.Albums.Check(ctx, query) (*[]bool, error)
GET/me/albums/contains

MeTracks

Get User's Saved Tracks
client.Me.Tracks.List(ctx, query) (*CursorURLPage[MeTrackListResponse], error)
GET/me/tracks
Save Tracks for Current User
client.Me.Tracks.Save(ctx, body) error
PUT/me/tracks
Remove User's Saved Tracks
client.Me.Tracks.Remove(ctx, body) error
DELETE/me/tracks
Check User's Saved Tracks
client.Me.Tracks.Check(ctx, query) (*[]bool, error)
GET/me/tracks/contains

MeEpisodes

Get User's Saved Episodes
client.Me.Episodes.List(ctx, query) (*CursorURLPage[MeEpisodeListResponse], error)
GET/me/episodes
Save Episodes for Current User
client.Me.Episodes.Save(ctx, body) error
PUT/me/episodes
Remove User's Saved Episodes
client.Me.Episodes.Remove(ctx, body) error
DELETE/me/episodes
Check User's Saved Episodes
client.Me.Episodes.Check(ctx, query) (*[]bool, error)
GET/me/episodes/contains

MeShows

Get User's Saved Shows
client.Me.Shows.List(ctx, query) (*CursorURLPage[MeShowListResponse], error)
GET/me/shows
Save Shows for Current User
client.Me.Shows.Save(ctx, body) error
PUT/me/shows
Remove User's Saved Shows
client.Me.Shows.Remove(ctx, body) error
DELETE/me/shows
Check User's Saved Shows
client.Me.Shows.Check(ctx, query) (*[]bool, error)
GET/me/shows/contains

MeFollowing

Get Followed Artists
client.Me.Following.BulkGet(ctx, query) (*MeFollowingBulkGetResponse, error)
GET/me/following
Follow Artists or Users
client.Me.Following.Follow(ctx, body) error
PUT/me/following
Unfollow Artists or Users
client.Me.Following.Unfollow(ctx, body) error
DELETE/me/following
Check If User Follows Artists or Users
client.Me.Following.Check(ctx, query) (*[]bool, error)
GET/me/following/contains

MePlayer

Get Playback State
client.Me.Player.GetState(ctx, query) (*MePlayerGetStateResponse, error)
GET/me/player
Transfer Playback
client.Me.Player.Transfer(ctx, body) error
PUT/me/player
Get Available Devices
client.Me.Player.GetDevices(ctx) (*MePlayerGetDevicesResponse, error)
GET/me/player/devices
Get Currently Playing Track
client.Me.Player.GetCurrentlyPlaying(ctx, query) (*MePlayerGetCurrentlyPlayingResponse, error)
GET/me/player/currently-playing
Start/Resume Playback
client.Me.Player.StartPlayback(ctx, params) error
PUT/me/player/play
Pause Playback
client.Me.Player.PausePlayback(ctx, body) error
PUT/me/player/pause
Skip To Next
client.Me.Player.SkipNext(ctx, body) error
POST/me/player/next
Skip To Previous
client.Me.Player.SkipPrevious(ctx, body) error
POST/me/player/previous
Seek To Position
client.Me.Player.SeekToPosition(ctx, body) error
PUT/me/player/seek
Set Repeat Mode
client.Me.Player.SetRepeatMode(ctx, body) error
PUT/me/player/repeat
Set Playback Volume
client.Me.Player.SetVolume(ctx, body) error
PUT/me/player/volume
Toggle Playback Shuffle
client.Me.Player.ToggleShuffle(ctx, body) error
PUT/me/player/shuffle
Get Recently Played Tracks
client.Me.Player.ListRecentlyPlayed(ctx, query) (*CursorURLPage[MePlayerListRecentlyPlayedResponse], error)
GET/me/player/recently-played
ModelsExpand Collapse
type ContextObject struct{…}
ExternalURLs ExternalURLObjectoptional

External URLs for this context.

Published booloptional

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 stringoptional

The Spotify URL for the object.

Href stringoptional

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

Published booloptional

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 stringoptional

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

Uri stringoptional

The Spotify URI for the context.

type DeviceObject struct{…}
ID stringoptional

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.

IsActive booloptional

If this device is the currently active device.

IsPrivateSession booloptional

If this device is currently in a private session.

IsRestricted booloptional

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

Name stringoptional

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 booloptional

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

SupportsVolume booloptional

If this device can be used to set the volume.

Type stringoptional

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

VolumePercent int64optional

The current volume in percent.

minimum0
maximum100

MePlayerQueue

Get the User's Queue
client.Me.Player.Queue.Get(ctx) (*MePlayerQueueGetResponse, error)
GET/me/player/queue
Add Item to Playback Queue
client.Me.Player.Queue.Add(ctx, body) error
POST/me/player/queue