Skip to main content
Version: 5.1.1

Library

SaveTracks

Save one or more tracks to the current user’s “Your Music” library.

Parameters

NameDescriptionExample
idsA list of the Spotify IDsnew List<String> { "3Hvu1pq89D4R0lyPBoujSv" }

Returns a ErrorResponse which just contains a possible error. (response.HasError() and response.Error)

Usage

ErrorResponse response = _spotify.SaveTracks(new List<string> { "3Hvu1pq89D4R0lyPBoujSv" });
if(!response.HasError())
Console.WriteLine("success");

SaveTrack

Save one track to the current user’s “Your Music” library.

Parameters

NameDescriptionExample
idA Spotify ID"3Hvu1pq89D4R0lyPBoujSv"

Returns a ErrorResponse which just contains a possible error. (response.HasError() and response.Error)

Usage

ErrorResponse response = _spotify.SaveTrack("3Hvu1pq89D4R0lyPBoujSv");
if(!response.HasError())
Console.WriteLine("success");

GetSavedTracks

Get a list of the songs saved in the current Spotify user’s “Your Music” library.

Parameters

NameDescriptionExample
[limit]The maximum number of objects to return. Default: 20. Minimum: 1. Maximum: 50.20
[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 Paging<SavedTrack>**, **SavedTrack contains 2 properties, DateTime AddedAt and FullTrack Track

Usage

Paging<SavedTrack> savedTracks = _spotify.GetSavedTracks();
savedTracks.Items.ForEach(track => Console.WriteLine(track.Track.Name));

RemoveSavedTracks

Remove one or more tracks from the current user’s “Your Music” library.

Parameters

NameDescriptionExample
idsA list of the Spotify IDs.new List<String> { "3Hvu1pq89D4R0lyPBoujSv" }

Returns a ErrorResponse which just contains a possible error. (response.HasError() and response.Error)

Usage

ErrorResponse response = _spotify.RemoveSavedTracks(new List<string> { "3Hvu1pq89D4R0lyPBoujSv" });
if(!response.HasError())
Console.WriteLine("success");

CheckSavedTracks

Check if one or more tracks is already saved in the current Spotify user’s “Your Music” library.

Parameters

NameDescriptionExample
idsA list of the Spotify IDs.new List<String> { "3Hvu1pq89D4R0lyPBoujSv" }

Returns a ListResponse<bool> which contains a property, List<bool> List

Usage

ListResponse<bool> tracksSaved = _spotify.CheckSavedTracks(new List<String> { "3Hvu1pq89D4R0lyPBoujSv" });
if(tracksSaved.List[0])
Console.WriteLine("The track is in your library!");

SaveAlbums

Save one or more albums to the current user’s “Your Music” library.

Parameters

NameDescriptionExample
idsA list of the Spotify IDsnew List<String> { "1cq06d0kTUnFmJHixz1RaF" }

Returns a ErrorResponse which just contains a possible error. (response.HasError() and response.Error)

Usage

ErrorResponse response = _spotify.SaveAlbums(new List<string> { "1cq06d0kTUnFmJHixz1RaF" });
if(!response.HasError())
Console.WriteLine("success");

SaveAlbum

Save one album to the current user’s “Your Music” library.

Parameters

NameDescriptionExample
idA Spotify ID"1cq06d0kTUnFmJHixz1RaF"

Returns a ErrorResponse which just contains a possible error. (response.HasError() and response.Error)

Usage

ErrorResponse response = _spotify.SaveAlbum("1cq06d0kTUnFmJHixz1RaF");
if(!response.HasError())
Console.WriteLine("success");

GetSavedAlbums

Get a list of the albums saved in the current Spotify user’s “Your Music” library.

Parameters

NameDescriptionExample
[limit]The maximum number of objects to return. Default: 20. Minimum: 1. Maximum: 50.20
[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 Paging<SavedAlbum>, SavedAlbum contains 2 properties, DateTime AddedAt and FullAlbum Album

Usage

Paging<SavedAlbum> savedAlbums = _spotify.GetSavedAlbums();
savedAlbums.Items.ForEach(album => Console.WriteLine(album.Album.Name));

RemoveSavedAlbums

Remove one or more albums from the current user’s “Your Music” library.

Parameters

NameDescriptionExample
idsA list of the Spotify IDs.new List<String> { "1cq06d0kTUnFmJHixz1RaF" }

Returns a ErrorResponse which just contains a possible error. (response.HasError() and response.Error)

Usage

ErrorResponse response = _spotify.RemoveSavedAlbums(new List<string> { "1cq06d0kTUnFmJHixz1RaF" });
if(!response.HasError())
Console.WriteLine("success");

CheckSavedAlbums

Check if one or more albums is already saved in the current Spotify user’s “Your Music” library.

Parameters

NameDescriptionExample
idsA list of the Spotify IDs.new List<String> { "1cq06d0kTUnFmJHixz1RaF" }

Returns a ListResponse<bool> which contains a property, List<bool> List

Usage

ListResponse<bool> albumsSaved = _spotify.CheckSavedAlbums(new List<String> { "1cq06d0kTUnFmJHixz1RaF" });
if(albumsSaved.List[0])
Console.WriteLine("The album is in your library!");