Playlists
GetUserPlaylists
Get a list of the playlists owned or followed by a Spotify user.
Parameters
| Name | Description | Example |
|---|---|---|
| userId | The user's Spotify user ID. | "1122095781" |
| [limit] | The maximum number of playlists to return. Default: 20. Minimum: 1. Maximum: 50. | 20 |
| [offset] | The index of the first playlist to return. Default: 0 (the first object) | 0 |
Returns a SimplePlaylist wrapped inside a Paging Object
Usage
Paging<SimplePlaylist> userPlaylists = _spotify.GetUserPlaylists("1122095781");
userPlaylists.Items.ForEach(playlist => playlist.Owner.DisplayName) //Who is the owner of the playlist?
GetPlaylist
Get a playlist owned by a Spotify user.
Parameters
| Name | Description | Example |
|---|---|---|
| userId | The user's Spotify user ID. | "1122095781" |
| playlistId | The Spotify ID for the playlist. | "1TtEejT1y4D1WmcOnLfha2" |
| [fields] | Filters for the query: a comma-separated list of the fields to return. If omitted, all fields are returned. | "description,uri" |
| [market] | An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking. | "DE" |
Returns a FullTrack
Usage
FullPlaylist playlist = _spotify.GetPlaylist("1122095781", "1TtEejT1y4D1WmcOnLfha2");
playlist.Tracks.Items.ForEach(track => Console.WriteLine(track.Track.Name));
GetPlaylistTracks
Get full details of the tracks of a playlist owned by a Spotify user.
Parameters
| Name | Description | Example |
|---|---|---|
| userId | The user's Spotify user ID. | "1122095781" |
| playlistId | The Spotify ID for the playlist. | "1TtEejT1y4D1WmcOnLfha2" |
| [fields] | Filters for the query: a comma-separated list of the fields to return. If omitted, all fields are returned. | "description,uri" |
| [limit] | The maximum number of tracks to return. Default: 100. Minimum: 1. Maximum: 100. | 100 |
| [offset] | The index of the first object to return. Default: 0 (i.e., the first object) | 0 |
| [market] | An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking. | DE |
Returns a PlaylistTrack wrapped inside a Paging Object
Usage
Paging<PlaylistTrack> playlist = _spotify.GetPlaylistTracks("1122095781", "1TtEejT1y4D1WmcOnLfha2");
playlist.Items.ForEach(track => Console.WriteLine(track.Track.Name));
CreatePlaylist
Create a playlist for a Spotify user. (The playlist will be empty until you add tracks.)
Parameters
| Name | Description | Example |
|---|---|---|
| userId | The user's Spotify user ID. | "1122095781" |
| playlistName | The name for the new playlist, for example "Your Coolest Playlist". This name does not need to be unique. | "This is my new Playlist" |
| [isPublic] | default true. If true the playlist will be public, if false it will be private. To be able to create private playlists, the user must have granted the playlist-modify-private scope. | true |
Returns a FullPlaylist
Usage
FullPlaylist playlist = _spotify.CreatePlaylist("1122095781", "This is my new Playlist");
if(!playlist.HasError())
Console.WriteLine("Playlist-URI: " + playlist.Uri);
UpdatePlaylist
Change a playlist’s name and public/private state. (The user must, of course, own the playlist.)
Parameters
| Name | Description | Example |
|---|---|---|
| userId | The user's Spotify user ID. | "1122095781" |
| playlistId | The Spotify ID for the playlist. | "1TtEejT1y4D1WmcOnLfha2" |
| [newName] | The new name for the playlist, for example "My New Playlist Title". | "New Playlistname" |
| [newPublic] | If true the playlist will be public, if false it will be private. | EXAMPLE |
Returns a ErrorResponse which just contains a possible error. (response.HasError() and response.Error)
Usage
ErrorResponse response = _spotify.UpdatePlaylist("1122095781", "1TtEejT1y4D1WmcOnLfha2", "New Name", true);
if(!response.HasError())
Console.WriteLine("success");
ReplacePlaylistTracks
Replace all the tracks in a playlist, overwriting its existing tracks. This powerful request can be useful for replacing tracks, re-ordering existing tracks, or clearing the playlist.
Parameters
| Name | Description | Example |
|---|---|---|
| userId | The user's Spotify user ID. | "1122095781" |
| playlistId | The Spotify ID for the playlist. | "1TtEejT1y4D1WmcOnLfha2" |
| uris | A list of Spotify track URIs to set. A maximum of 100 tracks can be set in one request. | new List<string> { "1ri6UZpjPLmTCswIXZ6Uq1" } |
Returns a ErrorResponse which just contains a possible error. (response.HasError() and response.Error)
Usage
ErrorResponse response = _spotify.ReplacePlaylistTracks("1122095781", "1TtEejT1y4D1WmcOnLfha2", new List<string> { "1ri6UZpjPLmTCswIXZ6Uq1" });
if(!response.HasError())
Console.WriteLine("success");
RemovePlaylistTracks
Remove one or more tracks from a user’s playlist.
Parameters
| Name | Description | Example |
|---|---|---|
| userId | The user's Spotify user ID. | "1122095781" |
| playlistId | The Spotify ID for the playlist. | "1TtEejT1y4D1WmcOnLfha2" |
| uris | array of objects containing Spotify URI strings (and their position in the playlist). A maximum of 100 objects can be sent at once. | (example below) |
Returns a ErrorResponse which just contains a possible error. (response.HasError() and response.Error)
Usage
//Remove multiple tracks
ErrorResponse playlist = _spotify.RemovePlaylistTracks("1122095781", "1TtEejT1y4D1WmcOnLfha2", new List<DeleteTrackUri>()
{
new DeleteTrackUri("1ri6UZpjPLmTCswIXZ6Uq1"),
new DeleteTrackUri("47xtGU3vht7mXLHqnbaau5")
});
//Remove multiple tracks at their specified positions
ErrorResponse playlist = _spotify.RemovePlaylistTracks("1122095781", "1TtEejT1y4D1WmcOnLfha2", new List<DeleteTrackUri>()
{
new DeleteTrackUri("1ri6UZpjPLmTCswIXZ6Uq1", 2),
new DeleteTrackUri("47xtGU3vht7mXLHqnbaau5", 0, 50)
});
RemovePlaylistTrack
Remove one or more tracks from a user’s playlist.
Parameters
| Name | Description | Example |
|---|---|---|
| userId | The user's Spotify user ID. | "1122095781" |
| playlistId | The Spotify ID for the playlist. | "1TtEejT1y4D1WmcOnLfha2" |
| uri | Spotify URI | new DeleteTrackUri("1ri6UZpjPLmTCswIXZ6Uq1") |
Returns a ErrorResponse which just contains a possible error. (response.HasError() and response.Error)
Usage
//Remove all tracks with the specified URI
ErrorResponse response = _spotify.RemovePlaylistTrack("1122095781", "1TtEejT1y4D1WmcOnLfha2", new DeleteTrackUri("1ri6UZpjPLmTCswIXZ6Uq1"));
//Remove all tracks with the specified URI and the specified positions
ErrorResponse response = _spotify.RemovePlaylistTrack("1122095781", "1TtEejT1y4D1WmcOnLfha2", new DeleteTrackUri("1ri6UZpjPLmTCswIXZ6Uq1", 0, 10, 20));
AddPlaylistTracks
Add one or more tracks to a user’s playlist.
Parameters
| Name | Description | Example |
|---|---|---|
| userId | The user's Spotify user ID. | "1122095781" |
| playlistId | The Spotify ID for the playlist. | "1TtEejT1y4D1WmcOnLfha2" |
| uris | A list of Spotify track URIs to add | new List<string> { "1ri6UZpjPLmTCswIXZ6Uq1" } |
| [position] | The position to insert the tracks, a zero-based index | 10 |
Returns a ErrorResponse which just contains a possible error. (response.HasError() and response.Error)
Usage
ErrorResponse response = _spotify.AddPlaylistTracks("1122095781", "1TtEejT1y4D1WmcOnLfha2", new List<string> { "1ri6UZpjPLmTCswIXZ6Uq1" });
if(!response.HasError())
Console.WriteLine("Success");
AddPlaylistTrack
Add one or more tracks to a user’s playlist.
Parameters
| Name | Description | Example |
|---|---|---|
| userId | The user's Spotify user ID. | "1122095781" |
| playlistId | The Spotify ID for the playlist. | "1TtEejT1y4D1WmcOnLfha2" |
| uri | A Spotify Track URI | "1ri6UZpjPLmTCswIXZ6Uq1" |
| position | The position to insert the tracks, a zero-based index | 10 |
Returns a ErrorResponse which just contains a possible error. (response.HasError() and response.Error)
Usage
ErrorResponse response = _spotify.AddPlaylistTrack("1122095781", "1TtEejT1y4D1WmcOnLfha2", "1ri6UZpjPLmTCswIXZ6Uq1");
if(!response.HasError())
Console.WriteLine("Success");
ReorderPlaylist
Reorder a track or a group of tracks in a playlist. More Info: Reorder-Playlist
Parameters
| Name | Description | Example |
|---|---|---|
| userId | The user's Spotify user ID. | "1122095781" |
| playlistId | The Spotify ID for the playlist. | "1TtEejT1y4D1WmcOnLfha2" |
| rangeStart | The position of the first track to be reordered. | 2 |
| insertBefore | The position where the tracks should be inserted. | 0 |
| [rangeLength] | The amount of tracks to be reordered. Defaults to 1 if not set. | 2 |
| [snapshotId] | The playlist's snapshot ID against which you want to make the changes. | `` |
Returns a Snapshot-Object which contains the property String SnapshotId
Usage
Snapshot snapshot = _spotify.ReorderPlaylist("1122095781", "1TtEejT1y4D1WmcOnLfha2", 2, 0, 2);
Console.WriteLine("New SnapshotId: " + snapshot.SnapshotId);