diff --git a/SpotifyLocalApi/index.html b/SpotifyLocalApi/index.html index 734c61da..a63665b0 100644 --- a/SpotifyLocalApi/index.html +++ b/SpotifyLocalApi/index.html @@ -71,6 +71,10 @@ Authentication +
  • + - Search +
  • +
  • - Albums
  • @@ -79,6 +83,22 @@ - Artists +
  • + - Browse +
  • + +
  • + - Follow +
  • + +
  • + - Library +
  • + +
  • + - Playlists +
  • + @@ -102,7 +122,7 @@ @@ -102,7 +122,7 @@ @@ -107,7 +127,7 @@
  • -
  • @@ -166,13 +186,15 @@ id The Spotify ID for the artist. -EXAMPLE +"1KpCi9BOfviCVhmpI4G2sY" -

    Returns a Public User Model

    +

    Returns a FullArtist

    Usage

    -
    +
    FullArtist artist = _spotify.GetArtist("1KpCi9BOfviCVhmpI4G2sY");
    +Console.WriteLine()
    +

    GetRelatedArtists

    @@ -192,13 +214,15 @@ id The Spotify ID for the artist. -EXAMPLE +"1KpCi9BOfviCVhmpI4G2sY" -

    Returns a Public User Model

    +

    Returns a SeveralArtists object which contains the property List<FullArtist> Artists (FullArtist)

    Usage

    -
    +
    SeveralArtists artists = _spotify.GetRelatedArtists("1KpCi9BOfviCVhmpI4G2sY");
    +Console.WriteLine(artists.Artists[0].Name);
    +

    GetArtistsTopTracks

    @@ -218,18 +242,20 @@ id The Spotify ID for the artist. -EXAMPLE +"1KpCi9BOfviCVhmpI4G2sY" country The country: an ISO 3166-1 alpha-2 country code. -EXAMPLE +"DE" -

    Returns a Public User Model

    +

    Returns a SeveralTracks object which contains the property List<FullTrack> Tracks (FullTrack)

    Usage

    -
    +
    SeveralTracks tracks = _spotify.GetArtistsTopTracks("1KpCi9BOfviCVhmpI4G2sY", "DE");
    +Console.WriteLine(tracks.Tracks.Count); //How many tracks did we get?
    +

    GetArtistsAlbums

    @@ -249,33 +275,35 @@ id The Spotify ID for the artist. -EXAMPLE +"1KpCi9BOfviCVhmpI4G2sY" -type +[type] A list of keywords that will be used to filter the response. If not supplied, all album types will be returned -EXAMPLE +AlbumType.All -limit +[limit] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. -EXAMPLE +20 -offset +[offset] The index of the first album to return. Default: 0 -EXAMPLE +0 -market +[market] An ISO 3166-1 alpha-2 country code. Supply this parameter to limit the response to one particular geographical market -EXAMPLE +"DE" -

    Returns a Public User Model

    +

    Returns a SimpleAlbum wrapped inside a Paging-object

    Usage

    -
    +
    Paging<SimpleAlbum> albums = _spotify.GetArtistsAlbums("1KpCi9BOfviCVhmpI4G2sY", AlbumType.All);
    +albums.Items.ForEach(album => Console.WriteLine(album.Name));
    +

    GetSeveralArtists

    @@ -295,13 +323,15 @@ ids A list of the Spotify IDs for the artists. Maximum: 50 IDs. -EXAMPLE +new List<String>() { "1KpCi9BOfviCVhmpI4G2sY" } -

    Returns a Public User Model

    +

    Returns a SeveralArtists object which contains the property List<FullArtist> Artists (FullArtist)

    Usage

    -
    +
    SeveralArtists artists = _spotify.GetSeveralArtists(new List<String>() {"1KpCi9BOfviCVhmpI4G2sY"});
    +artists.Artists.ForEach(artist => Console.WriteLine(artist.Name));
    +

    diff --git a/SpotifyWebApi/auth/index.html b/SpotifyWebApi/auth/index.html index 266ee87d..05e6d38a 100644 --- a/SpotifyWebApi/auth/index.html +++ b/SpotifyWebApi/auth/index.html @@ -71,6 +71,10 @@ Authentication +
  • + - Search +
  • +
  • - Albums
  • @@ -79,6 +83,22 @@ - Artists +
  • + - Browse +
  • + +
  • + - Follow +
  • + +
  • + - Library +
  • + +
  • + - Playlists +
  • + @@ -107,7 +127,7 @@
  • -
  • @@ -166,7 +186,7 @@ If you want to know more, you can read to the whole auth-process ClientCredentialsAuth (Not Recommended, Server-side code needed, else it's unsecure)

    -

    Note: I would recommend a little PHP Script, which will exchange the Keys using AutorizationCodeAuth. +

    Note: I would recommend a little PHP Script, which will exchange the Keys using AutorizationCodeAuth. When using ImplicitGrantAuth, another user could abuse the "localhost" RedirectUri by creating a "fake"-app which uses your ClientId.

    Overview: Overview

    @@ -175,7 +195,7 @@ When using ImplicitGrantAuth, another user could abuse the "localhost" RedirectU

    This way is recommended and the only auth-process, which does not need a server-side exchange of keys. With this approach, you directly get a Token object after the user authed your application. You won't be able to refresh the token. If you want to use the internal Http server, please add "http://localhost" to your application redirects.

    More info: here

    -
    static ImplicitGrantAuth auth;
    +
    static ImplicitGrantAuth auth;
     static void Main(string[] args)
     {
         //Create the auth object
    @@ -217,7 +237,7 @@ In this exchange you need to provide your Client-Secret and because of that it's
     (But you can e.g exchange to codes via a PHP Script)
    A good thing about this method: You can always refresh your token, without having the user to auth it again

    More info: here

    -
    static AutorizationCodeAuth auth;
    +
    static AutorizationCodeAuth auth;
     static void Main(string[] args)
     {
         //Create the auth object
    @@ -267,7 +287,7 @@ With this approach, you make a POST Request with a base64 encoded string (consis
     If you want to use it securely, you would need to do it all server-side.
    NOTE: You will only be able to query non-user-related information e.g search for a Track.

    More info: here

    -
    static ClientCredentialsAuth auth;
    +
    static ClientCredentialsAuth auth;
     static void Main(string[] args)
     {
         //Create the auth object
    @@ -280,7 +300,7 @@ static void Main(string[] args)
             //How many permissions we need?
             Scope = Scope.USER_READ_PRIVATE,
         };
    -    //With this token object, we now can make calls 
    +    //With this token object, we now can make calls
         Token token = auth.DoAuth();
         var spotify = new SpotifyWebApiClass()
         {
    diff --git a/SpotifyWebApi/browse/index.html b/SpotifyWebApi/browse/index.html
    new file mode 100644
    index 00000000..580e1896
    --- /dev/null
    +++ b/SpotifyWebApi/browse/index.html
    @@ -0,0 +1,398 @@
    +
    +
    +    
    +        
    +        
    +        
    +        
    +        
    +        
    +        
    +
    +	- Browse - SpotifyAPI-NET
    +
    +        
    +        
    +        
    +        
    +        
    +
    +        
    +        
    +    
    +
    +    
    +
    +        
    +
    +        
    + +
    + +

    GetFeaturedPlaylists

    +

    AUTH REQUIRED

    +
    +

    Get a list of Spotify featured playlists (shown, for example, on a Spotify player’s “Browse” tab).

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    [locale]The desired language, consisting of a lowercase ISO 639 language code and an uppercase ISO 3166-1 alpha-2 country code, joined by an underscore."de_DE" //Germany
    [country]A country: an ISO 3166-1 alpha-2 country code."DE"
    [timestamp]A timestamp in ISO 8601 formatDateTime.Now
    [limit]The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.20
    [offset]The index of the first item to return. Default: 00
    +

    Returns a FeaturedPlaylists object, which has 2 properties. String Message and Paging<SimplePlaylist> Playlists

    +

    Usage

    +
    FeaturedPlaylists playlists = _spotify.GetFeaturedPlaylists();
    +Console.WriteLine(playlists.Message);
    +playlists.Playlists.Items.ForEach(playlist => Console.WriteLine(playlist.Name));
    +
    + +
    +

    GetNewAlbumReleases

    +

    AUTH REQUIRED

    +
    +

    Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player’s “Browse” tab).

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    [country]A country: an ISO 3166-1 alpha-2 country code."DE"
    [limit]The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.20
    [offset]The index of the first item to return. Default: 00
    +

    Returns a NewAlbumReleases object, which has the property Paging<SimpleAlbum> Albums.

    +

    Usage

    +
    NewAlbumReleases newAlbums = _spotify.GetNewAlbumReleases();
    +newAlbums.Albums.Items.ForEach(album => Console.WriteLine(album.Name));
    +
    + +
    +

    GetCategories

    +

    AUTH REQUIRED

    +
    +

    Get a list of categories used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    [country]A country: an ISO 3166-1 alpha-2 country code. Provide this parameter if you want to narrow the list of returned categories to those relevant to a particular country"DE"
    [locale]The desired language, consisting of an ISO 639 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore"de_DE"
    [limit]The maximum number of categories to return. Default: 20. Minimum: 1. Maximum: 50.20
    [offset]The index of the first item to return. Default: 0 (the first object).0
    +

    Returns a CategoryList object, which has the property Paging<Category> Categories.

    +

    Usage

    +
    CategoryList categoryList = _spotify.GetCategories();
    +categoryList.Categories.Items.ForEach(category => Console.WriteLine(category.Name));
    +
    + +
    +

    GetCategory

    +

    AUTH REQUIRED

    +
    +

    Get a single category used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    categoryIdThe Spotify category ID for the category."party"
    [country]A country: an ISO 3166-1 alpha-2 country code. Provide this parameter to ensure that the category exists for a particular country."DE"
    [locale]The desired language, consisting of an ISO 639 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore"de_DE"
    +

    Returns a Category

    +

    Usage

    +
    Category cat = _spotify.GetCategory("party");
    +Console.WriteLine(cat.Name);
    +
    + +
    +

    GetCategoryPlaylists

    +

    AUTH REQUIRED

    +
    +

    Get a list of Spotify playlists tagged with a particular category.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    categoryIdThe Spotify category ID for the category."party"
    [country]A country: an ISO 3166-1 alpha-2 country code."DE"
    [limit]The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.20
    [offset]The index of the first item to return. Default: 00
    +

    Returns a CategoryPlaylist object, which has the property Paging<SimplePlaylist> Playlists

    +

    Usage

    +
    CategoryPlaylist playlists = _spotify.GetCategoryPlaylists("party");
    +playlists.Playlists.Items.ForEach(playlist => Console.WriteLine(playlist.Name));
    +
    + +
    +
    + + + + + + + + + + \ No newline at end of file diff --git a/SpotifyWebApi/examples/index.html b/SpotifyWebApi/examples/index.html index d8458e05..e9516c78 100644 --- a/SpotifyWebApi/examples/index.html +++ b/SpotifyWebApi/examples/index.html @@ -71,6 +71,10 @@ Authentication +
  • + - Search +
  • +
  • - Albums
  • @@ -79,6 +83,22 @@ - Artists +
  • + - Browse +
  • + +
  • + - Follow +
  • + +
  • + - Library +
  • + +
  • + - Playlists +
  • + diff --git a/SpotifyWebApi/follow/index.html b/SpotifyWebApi/follow/index.html new file mode 100644 index 00000000..ebc8779e --- /dev/null +++ b/SpotifyWebApi/follow/index.html @@ -0,0 +1,405 @@ + + + + + + + + + + + + - Follow - SpotifyAPI-NET + + + + + + + + + + + + + + + +
    +
    +
    + +

    Follow

    +

    AUTH REQUIRED

    +
    +

    Add the current user as a follower of one or more artists or other Spotify users.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    followTypeThe ID type: either artist or user.FollowType.Artist
    ids or idA list of the artist or the user Spotify IDs or just a Spotify IDnew List<String> { "1KpCi9BOfviCVhmpI4G2sY" } or "1KpCi9BOfviCVhmpI4G2sY"
    +

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

    +

    Usage

    +
    ErrorResponse response = _spotify.Follow(FollowType.Artist, "1KpCi9BOfviCVhmpI4G2sY");
    +//or if it's a User
    +ErrorResponse response = _spotify.Follow(FollowType.User, "1122095781");
    +
    + +
    +

    Unfollow

    +

    AUTH REQUIRED

    +
    +

    Remove the current user as a follower of one or more artists or other Spotify users.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    followTypeThe ID type: either artist or user.FollowType.Artist
    ids or idA list of the artist or the user Spotify IDs or just a Spotify IDnew List<String> { "1KpCi9BOfviCVhmpI4G2sY" } or "1KpCi9BOfviCVhmpI4G2sY"
    +

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

    +

    Usage

    +
    ErrorResponse response = _spotify.Unfollow(FollowType.Artist, "1KpCi9BOfviCVhmpI4G2sY");
    +//or if it's a User
    +ErrorResponse response = _spotify.Unfollow(FollowType.User, "1122095781");
    +
    + +
    +

    IsFollowing

    +

    AUTH REQUIRED

    +
    +

    Check to see if the current user is following one or more artists or other Spotify users.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    followTypeThe ID type: either artist or user.FollowType.Artist
    ids or idA list of the artist or the user Spotify IDs or just a Spotify IDnew List<String> { "1KpCi9BOfviCVhmpI4G2sY" } or "1KpCi9BOfviCVhmpI4G2sY"
    +

    Returns a ListResponse which contains the property List<Boolean> List

    +

    Usage

    +
    //Are you one of my Followers? :P
    +ListResponse<Boolean> response = _spotify.IsFollowing(FollowType.User, "1122095781");
    +Console.WriteLine(response.List[0] ? "Yis!" : "No :(");
    +
    + +
    +

    FollowPlaylist

    +

    AUTH REQUIRED

    +
    +

    Add the current user as a follower of a playlist.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    ownerIdThe Spotify user ID of the person who owns the playlist."maxloermans"
    playlistIdThe Spotify ID of the playlist. Any playlist can be followed, regardless of its public/private status, as long as you know its playlist ID."3SIp2VAsKI03mReF0dFBmI"
    [showPublic]If true the playlist will be included in user's public playlists, if false it will remain private.true
    +

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

    +

    Usage

    +
    ErrorResponse response = _spotify.FollowPlaylist("maxloermans", "3SIp2VAsKI03mReF0dFBmI");
    +if(!response.HasError())
    +    Console.WriteLine("success");
    +
    + +
    +

    UnfollowPlaylist

    +

    AUTH REQUIRED

    +
    +

    Remove the current user as a follower of a playlist.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    ownerIdThe Spotify user ID of the person who owns the playlist."maxloermans"
    playlistIdThe Spotify ID of the playlist that is to be no longer followed."3SIp2VAsKI03mReF0dFBmI"
    +

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

    +

    Usage

    +
    ErrorResponse response = _spotify.UnfollowPlaylist("maxloermans", "3SIp2VAsKI03mReF0dFBmI");
    +if(!response.HasError())
    +    Console.WriteLine("success");
    +
    + +
    +

    IsFollowingPlaylist

    +

    AUTH REQUIRED

    +
    +

    Check to see if one or more Spotify users are following a specified playlist.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    ownerIdThe Spotify user ID of the person who owns the playlist."maxloermans"
    playlistIdThe Spotify ID of the playlist."3SIp2VAsKI03mReF0dFBmI"
    ids or idA list of the artist or the user Spotify IDs or just a Spotify IDnew List<String> { "1KpCi9BOfviCVhmpI4G2sY" } or "1KpCi9BOfviCVhmpI4G2sY"
    +

    Returns a ListResponse which contains the property List<Boolean> List

    +

    Usage

    +
    //Am I following the playlist?
    +ListResponse<Boolean> response = _spotify.IsFollowing("maxloermans", "3SIp2VAsKI03mReF0dFBmI", "1122095781");
    +Console.WriteLine(response.List[0] ? "Yis!" : "No :(");
    +
    + +
    +
    + + + + + + + + + + \ No newline at end of file diff --git a/SpotifyWebApi/gettingstarted/index.html b/SpotifyWebApi/gettingstarted/index.html index 1b3ea72f..63813103 100644 --- a/SpotifyWebApi/gettingstarted/index.html +++ b/SpotifyWebApi/gettingstarted/index.html @@ -71,6 +71,10 @@ Authentication +
  • + - Search +
  • +
  • - Albums
  • @@ -79,6 +83,22 @@ - Artists +
  • + - Browse +
  • + +
  • + - Follow +
  • + +
  • + - Library +
  • + +
  • + - Playlists +
  • + @@ -166,17 +186,17 @@ Full-Method Reference:

    UseAuth

    Wether auth should be used or not. User-stuff can only be fetched with auth.
    NOTE: If you use auth, you need to provide both, TokenType and AccessToken

    -
    _spotify.UseAuth = false;
    +
    _spotify.UseAuth = false;
     

    TokenType

    The token-type. Normally "Bearer" or "Basic".

    -
    _spotify.TokenType = "XXXXXXXXXXXXXXXX";
    +
    _spotify.TokenType = "XXXXXXXXXXXXXXXX";
     

    AccessToken

    The access-token received by your auth-type.

    -
    _spotify.AccessToken = "XXXXXXXXXXXXXXXX";
    +
    _spotify.AccessToken = "XXXXXXXXXXXXXXXX";
     
    diff --git a/SpotifyWebApi/library/index.html b/SpotifyWebApi/library/index.html new file mode 100644 index 00000000..c9c7e35d --- /dev/null +++ b/SpotifyWebApi/library/index.html @@ -0,0 +1,341 @@ + + + + + + + + + + + + - Library - SpotifyAPI-NET + + + + + + + + + + + + + + + +
    + +
    + +

    SaveTracks

    +

    AUTH REQUIRED

    +
    +

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

    +
    +

    Paramters

    + + + + + + + + + + + + + + + +
    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

    +

    AUTH REQUIRED

    +
    +

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

    +
    +

    Paramters

    + + + + + + + + + + + + + + + +
    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

    +

    AUTH REQUIRED

    +
    +

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

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    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 contains 2 properties, DateTime AddedAt and FullTrack Track

    +

    Usage

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

    RemoveSavedTracks

    +

    AUTH REQUIRED

    +
    +

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

    +
    +

    Paramters

    + + + + + + + + + + + + + + + +
    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

    +

    AUTH REQUIRED

    +
    +

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

    +
    +

    Paramters

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

    Returns a ListResponse 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!");
    +
    + +
    +
    + + + + + + + + + + \ No newline at end of file diff --git a/SpotifyWebApi/playlists/index.html b/SpotifyWebApi/playlists/index.html new file mode 100644 index 00000000..49a52ddd --- /dev/null +++ b/SpotifyWebApi/playlists/index.html @@ -0,0 +1,657 @@ + + + + + + + + + + + + - Playlists - SpotifyAPI-NET + + + + + + + + + + + + + + + +
    + +
    + +

    GetUserPlaylists

    +

    AUTH REQUIRED

    +
    +

    Get a list of the playlists owned or followed by a Spotify user.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    userIdThe user's Spotify user ID.EXAMPLE
    limitThe maximum number of playlists to return. Default: 20. Minimum: 1. Maximum: 50.EXAMPLE
    offsetThe index of the first playlist to return. Default: 0 (the first object)EXAMPLE
    +

    Returns a Public User Model

    +

    Usage

    +
    + +
    +

    GetPlaylist

    +

    AUTH REQUIRED

    +
    +

    Get a playlist owned by a Spotify user.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    userIdThe user's Spotify user ID.EXAMPLE
    playlistIdThe Spotify ID for the playlist.EXAMPLE
    fieldsFilters for the query: a comma-separated list of the fields to return. If omitted, all fields are returned.EXAMPLE
    marketAn ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.EXAMPLE
    +

    Returns a Public User Model

    +

    Usage

    +
    + +
    +

    GetPlaylistTracks

    +

    AUTH REQUIRED

    +
    +

    Get full details of the tracks of a playlist owned by a Spotify user.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    userIdThe user's Spotify user ID.EXAMPLE
    playlistIdThe Spotify ID for the playlist.EXAMPLE
    fieldsFilters for the query: a comma-separated list of the fields to return. If omitted, all fields are returned.EXAMPLE
    limitThe maximum number of tracks to return. Default: 100. Minimum: 1. Maximum: 100.EXAMPLE
    offsetThe index of the first object to return. Default: 0 (i.e., the first object)EXAMPLE
    marketAn ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.EXAMPLE
    +

    Returns a Public User Model

    +

    Usage

    +
    + +
    +

    CreatePlaylist

    +

    AUTH REQUIRED

    +
    +

    Create a playlist for a Spotify user. (The playlist will be empty until you add tracks.)

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    userIdThe user's Spotify user ID.EXAMPLE
    playlistNameThe name for the new playlist, for example "Your Coolest Playlist". This name does not need to be unique.EXAMPLE
    isPublicdefault 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.EXAMPLE
    +

    Returns a Public User Model

    +

    Usage

    +
    + +
    +

    UpdatePlaylist

    +

    AUTH REQUIRED

    +
    +

    Change a playlist’s name and public/private state. (The user must, of course, own the playlist.)

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    userIdThe user's Spotify user ID.EXAMPLE
    playlistIdThe Spotify ID for the playlist.EXAMPLE
    newNameThe new name for the playlist, for example "My New Playlist Title".EXAMPLE
    newPublicIf true the playlist will be public, if false it will be private.EXAMPLE
    +

    Returns a Public User Model

    +

    Usage

    +
    + +
    +

    ReplacePlaylistTracks

    +

    AUTH REQUIRED

    +
    +

    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.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    userIdThe user's Spotify user ID.EXAMPLE
    playlistIdThe Spotify ID for the playlist.EXAMPLE
    urisA list of Spotify track URIs to set. A maximum of 100 tracks can be set in one request.EXAMPLE
    +

    Returns a Public User Model

    +

    Usage

    +
    + +
    +

    RemovePlaylistTracks

    +

    AUTH REQUIRED

    +
    +

    Remove one or more tracks from a user’s playlist.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    userIdThe user's Spotify user ID.EXAMPLE
    playlistIdThe Spotify ID for the playlist.EXAMPLE
    urisarray of objects containing Spotify URI strings (and their position in the playlist). A maximum of 100 objects can be sent at once.EXAMPLE
    +

    Returns a Public User Model

    +

    Usage

    +
    + +
    +

    RemovePlaylistTrack

    +

    AUTH REQUIRED

    +
    +

    Remove one or more tracks from a user’s playlist.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    userIdThe user's Spotify user ID.EXAMPLE
    playlistIdThe Spotify ID for the playlist.EXAMPLE
    uriSpotify URIEXAMPLE
    +

    Returns a Public User Model

    +

    Usage

    +
    + +
    +

    AddPlaylistTracks

    +

    AUTH REQUIRED

    +
    +

    Add one or more tracks to a user’s playlist.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    userIdThe user's Spotify user ID.EXAMPLE
    playlistIdThe Spotify ID for the playlist.EXAMPLE
    urisA list of Spotify track URIs to addEXAMPLE
    positionThe position to insert the tracks, a zero-based indexEXAMPLE
    +

    Returns a Public User Model

    +

    Usage

    +
    + +
    +

    AddPlaylistTrack

    +

    AUTH REQUIRED

    +
    +

    Add one or more tracks to a user’s playlist.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    userIdThe user's Spotify user ID.EXAMPLE
    playlistIdThe Spotify ID for the playlist.EXAMPLE
    uriA Spotify Track URIEXAMPLE
    positionThe position to insert the tracks, a zero-based indexEXAMPLE
    +

    Returns a Public User Model

    +

    Usage

    +
    + +
    +

    ReorderPlaylist

    +

    AUTH REQUIRED

    +
    +

    Reorder a track or a group of tracks in a playlist.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    userIdThe user's Spotify user ID.EXAMPLE
    playlistIdThe Spotify ID for the playlist.EXAMPLE
    rangeStartThe position of the first track to be reordered.EXAMPLE
    insertBeforeThe position where the tracks should be inserted.EXAMPLE
    rangeLengthThe amount of tracks to be reordered. Defaults to 1 if not set.EXAMPLE
    snapshotIdThe playlist's snapshot ID against which you want to make the changes.EXAMPLE
    +

    Returns a Public User Model

    +

    Usage

    +
    + +
    +
    + + + + + + + + + + \ No newline at end of file diff --git a/SpotifyWebApi/search/index.html b/SpotifyWebApi/search/index.html new file mode 100644 index 00000000..b4a148e9 --- /dev/null +++ b/SpotifyWebApi/search/index.html @@ -0,0 +1,218 @@ + + + + + + + + + + + + - Search - SpotifyAPI-NET + + + + + + + + + + + + + + + +
    +
    +
    + +

    SearchItems

    +
    +

    Get Spotify catalog information about artists, albums, tracks or playlists that match a keyword string.

    +
    +

    Paramters

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameDescriptionExample
    qThe search query's keywords (and optional field filters and operators), for example q=roadhouse+blues."roadhouse+blues"
    typeA list of item types to search across.SearchType.Album
    [limit]The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.20
    [offset]The index of the first result to return. Default: 00
    [market]An ISO 3166-1 alpha-2 country code or the string from_token."de"
    +

    Returns a SearchItem which contains the properties Paging<SimpleArtist> Artists,Paging<FullTrack> Tracks, Paging<SimpleAlbum> Albums. They are filled based on your search-type.

    +

    Usage

    +
    SearchItem item = _spotify.SearchItems("roadhouse+blues", SearchType.Album);
    +Console.WriteLine(item.Albums.Total); //How many results are there in total? NOTE: item.Tracks = item.Artists = null
    +
    + +
    +
    + + + + + + + + + + \ No newline at end of file diff --git a/index.html b/index.html index f00b6deb..b1b6781e 100644 --- a/index.html +++ b/index.html @@ -71,6 +71,10 @@ Authentication +
  • + - Search +
  • +
  • - Albums
  • @@ -79,6 +83,22 @@ - Artists +
  • + - Browse +
  • + +
  • + - Follow +
  • + +
  • + - Library +
  • + +
  • + - Playlists +
  • + diff --git a/mkdocs/search_index.json b/mkdocs/search_index.json index 7d5fcbd8..b96739e0 100644 --- a/mkdocs/search_index.json +++ b/mkdocs/search_index.json @@ -52,12 +52,12 @@ }, { "location": "/SpotifyWebApi/auth/", - "text": "Auth-Methods\n\n\nBefore you can use the Web API full functional, you need the user to authenticate your Application.\n\nIf you want to know more, you can read to the whole auth-process \nhere\n.\n\n\nBefore you start, you need to create a Application at Spotify: \nYour Applications\n\n\n\n\nAfter you created your Application, you will have following important values: \n\n\n\n\nClient_Id\n This is your client_id, you don't have to hide it\n\n\nClient_Secret\n Never use this in one of your client-side apps!! Keep it secret!\n\n\nRedirect URIs\n Add \"http://localhost\", if you want full support for this API \n\n\n\n\nNow you can start with the User-authentication, Spotify provides 3 ways:\n\n\n\n\n\n\nImplicitGrantAuth\n (\nRecommended\n, no server-side code needed) \n\n\n\n\n\n\nAutorizationCodeAuth\n (Not Recommended, Server-side code needed, else it's unsecure)\n\n\n\n\n\n\nClientCredentialsAuth\n (Not Recommended, Server-side code needed, else it's unsecure) \n\n\n\n\n\n\nNote:\n I would recommend a little PHP Script, which will exchange the Keys using AutorizationCodeAuth. \nWhen using ImplicitGrantAuth, another user could abuse the \"localhost\" RedirectUri by creating a \"fake\"-app which uses your ClientId.\n\n\nOverview:\n\n\n\nAfter implementing one of the provided auth-methods, you can start doing requests with the token you get from one of the auth-methods\n\n\nImplicitGrantAuth\n\n\nThis way is \nrecommended\n and the only auth-process, which does not need a server-side exchange of keys. With this approach, you directly get a Token object after the user authed your application.\nYou won't be able to refresh the token. If you want to use the internal Http server, please add \"http://localhost\" to your application redirects.\n\n\nMore info: \nhere\n\n\nstatic ImplicitGrantAuth auth;\nstatic void Main(string[] args)\n{\n //Create the auth object\n auth = new ImplicitGrantAuth()\n {\n //Your client Id\n ClientId = \nXXXXXXXXXXXXXXXX\n,\n //Set this to localhost if you want to use the built-in HTTP Server\n RedirectUri = \nhttp://localhost\n,\n //How many permissions we need?\n Scope = Scope.USER_READ_PRIVATE,\n };\n //Start the internal http server\n auth.StartHttpServer();\n //When we got our response\n auth.OnResponseReceivedEvent += auth_OnResponseReceivedEvent;\n //Start\n auth.DoAuth();\n}\n\nstatic void auth_OnResponseReceivedEvent(Token token, string state, string error)\n{\n //stop the http server\n auth.StopHttpServer();\n\n var spotify = new SpotifyWebApiClass()\n {\n TokenType = token.TokenType,\n AccessToken = token.AccessToken\n };\n //We can now make calls with the token object\n}\n\n\n\n\nAutorizationCodeAuth\n\n\nThis way is \nnot recommended\n and requires server-side code to run securely.\n\nWith this approach, you first get a code which you need to trade against the access-token.\n\nIn this exchange you need to provide your Client-Secret and because of that it's not recommended.\n\n(But you can e.g exchange to codes via a PHP Script)\n\nA good thing about this method: You can always refresh your token, without having the user to auth it again\n\n\nMore info: \nhere\n\n\nstatic AutorizationCodeAuth auth;\nstatic void Main(string[] args)\n{\n //Create the auth object\n auth = new AutorizationCodeAuth()\n {\n //Your client Id\n ClientId = \nXXXXXXXXXXXXXXX\n,\n //Set this to localhost if you want to use the built-in HTTP Server\n RedirectUri = \nhttp://localhost\n,\n //How many permissions we need?\n Scope = Scope.USER_READ_PRIVATE,\n };\n //This will be called, if the user cancled/accept the auth-request\n auth.OnResponseReceivedEvent += auth_OnResponseReceivedEvent;\n //a local HTTP Server will be started (Needed for the response)\n auth.StartHttpServer();\n //This will open the spotify auth-page. The user can decline/accept the request\n auth.DoAuth();\n\n Thread.Sleep(60000);\n auth.StopHttpServer();\n Console.WriteLine(\nToo long, didnt respond, exiting now...\n);\n}\n\nprivate static void auth_OnResponseReceivedEvent(AutorizationCodeAuthResponse response)\n{\n //Stop the HTTP Server, done.\n auth.StopHttpServer();\n\n //NEVER DO THIS! You would need to provide the ClientSecret.\n //You would need to do it e.g via a PHP-Script.\n Token token = auth.ExchangeAuthCode(response.Code, \nXXXXXXXXXXX\n);\n\n var spotify = new SpotifyWebApiClass()\n {\n TokenType = token.TokenType,\n AccessToken = token.AccessToken\n };\n\n //With the token object, you can now make API calls\n}\n\n\n\n\nClientCredentialsAuth\n\n\nThis way is \nnot recommended\n and requires server-side code to run securely.\n\nWith this approach, you make a POST Request with a base64 encoded string (consists of ClientId + ClientSecret). You will directly get the token (Without a local HTTP Server), but it will expire and can't be refreshed.\n\nIf you want to use it securely, you would need to do it all server-side.\n\n\nNOTE:\n You will only be able to query non-user-related information e.g search for a Track.\n\n\nMore info: \nhere\n\n\nstatic ClientCredentialsAuth auth;\nstatic void Main(string[] args)\n{\n //Create the auth object\n auth = new ClientCredentialsAuth()\n {\n //Your client Id\n ClientId = \nXXXXXXXXXXXXXXX\n,\n //Your client secret UNSECURE!!\n ClientSecret = \nXXXXXXXXXXXX\n,\n //How many permissions we need?\n Scope = Scope.USER_READ_PRIVATE,\n };\n //With this token object, we now can make calls \n Token token = auth.DoAuth();\n var spotify = new SpotifyWebApiClass()\n {\n TokenType = token.TokenType,\n AccessToken = token.AccessToken,\n UseAuth = false\n };\n}", + "text": "Auth-Methods\n\n\nBefore you can use the Web API full functional, you need the user to authenticate your Application.\n\nIf you want to know more, you can read to the whole auth-process \nhere\n.\n\n\nBefore you start, you need to create a Application at Spotify: \nYour Applications\n\n\n\n\nAfter you created your Application, you will have following important values: \n\n\n\n\nClient_Id\n This is your client_id, you don't have to hide it\n\n\nClient_Secret\n Never use this in one of your client-side apps!! Keep it secret!\n\n\nRedirect URIs\n Add \"http://localhost\", if you want full support for this API \n\n\n\n\nNow you can start with the User-authentication, Spotify provides 3 ways:\n\n\n\n\n\n\nImplicitGrantAuth\n (\nRecommended\n, no server-side code needed) \n\n\n\n\n\n\nAutorizationCodeAuth\n (Not Recommended, Server-side code needed, else it's unsecure)\n\n\n\n\n\n\nClientCredentialsAuth\n (Not Recommended, Server-side code needed, else it's unsecure) \n\n\n\n\n\n\nNote:\n I would recommend a little PHP Script, which will exchange the Keys using AutorizationCodeAuth.\nWhen using ImplicitGrantAuth, another user could abuse the \"localhost\" RedirectUri by creating a \"fake\"-app which uses your ClientId.\n\n\nOverview:\n\n\n\nAfter implementing one of the provided auth-methods, you can start doing requests with the token you get from one of the auth-methods\n\n\nImplicitGrantAuth\n\n\nThis way is \nrecommended\n and the only auth-process, which does not need a server-side exchange of keys. With this approach, you directly get a Token object after the user authed your application.\nYou won't be able to refresh the token. If you want to use the internal Http server, please add \"http://localhost\" to your application redirects.\n\n\nMore info: \nhere\n\n\nstatic ImplicitGrantAuth auth;\nstatic void Main(string[] args)\n{\n //Create the auth object\n auth = new ImplicitGrantAuth()\n {\n //Your client Id\n ClientId = \nXXXXXXXXXXXXXXXX\n,\n //Set this to localhost if you want to use the built-in HTTP Server\n RedirectUri = \nhttp://localhost\n,\n //How many permissions we need?\n Scope = Scope.USER_READ_PRIVATE,\n };\n //Start the internal http server\n auth.StartHttpServer();\n //When we got our response\n auth.OnResponseReceivedEvent += auth_OnResponseReceivedEvent;\n //Start\n auth.DoAuth();\n}\n\nstatic void auth_OnResponseReceivedEvent(Token token, string state, string error)\n{\n //stop the http server\n auth.StopHttpServer();\n\n var spotify = new SpotifyWebApiClass()\n {\n TokenType = token.TokenType,\n AccessToken = token.AccessToken\n };\n //We can now make calls with the token object\n}\n\n\n\n\nAutorizationCodeAuth\n\n\nThis way is \nnot recommended\n and requires server-side code to run securely.\n\nWith this approach, you first get a code which you need to trade against the access-token.\n\nIn this exchange you need to provide your Client-Secret and because of that it's not recommended.\n\n(But you can e.g exchange to codes via a PHP Script)\n\nA good thing about this method: You can always refresh your token, without having the user to auth it again\n\n\nMore info: \nhere\n\n\nstatic AutorizationCodeAuth auth;\nstatic void Main(string[] args)\n{\n //Create the auth object\n auth = new AutorizationCodeAuth()\n {\n //Your client Id\n ClientId = \nXXXXXXXXXXXXXXX\n,\n //Set this to localhost if you want to use the built-in HTTP Server\n RedirectUri = \nhttp://localhost\n,\n //How many permissions we need?\n Scope = Scope.USER_READ_PRIVATE,\n };\n //This will be called, if the user cancled/accept the auth-request\n auth.OnResponseReceivedEvent += auth_OnResponseReceivedEvent;\n //a local HTTP Server will be started (Needed for the response)\n auth.StartHttpServer();\n //This will open the spotify auth-page. The user can decline/accept the request\n auth.DoAuth();\n\n Thread.Sleep(60000);\n auth.StopHttpServer();\n Console.WriteLine(\nToo long, didnt respond, exiting now...\n);\n}\n\nprivate static void auth_OnResponseReceivedEvent(AutorizationCodeAuthResponse response)\n{\n //Stop the HTTP Server, done.\n auth.StopHttpServer();\n\n //NEVER DO THIS! You would need to provide the ClientSecret.\n //You would need to do it e.g via a PHP-Script.\n Token token = auth.ExchangeAuthCode(response.Code, \nXXXXXXXXXXX\n);\n\n var spotify = new SpotifyWebApiClass()\n {\n TokenType = token.TokenType,\n AccessToken = token.AccessToken\n };\n\n //With the token object, you can now make API calls\n}\n\n\n\n\nClientCredentialsAuth\n\n\nThis way is \nnot recommended\n and requires server-side code to run securely.\n\nWith this approach, you make a POST Request with a base64 encoded string (consists of ClientId + ClientSecret). You will directly get the token (Without a local HTTP Server), but it will expire and can't be refreshed.\n\nIf you want to use it securely, you would need to do it all server-side.\n\n\nNOTE:\n You will only be able to query non-user-related information e.g search for a Track.\n\n\nMore info: \nhere\n\n\nstatic ClientCredentialsAuth auth;\nstatic void Main(string[] args)\n{\n //Create the auth object\n auth = new ClientCredentialsAuth()\n {\n //Your client Id\n ClientId = \nXXXXXXXXXXXXXXX\n,\n //Your client secret UNSECURE!!\n ClientSecret = \nXXXXXXXXXXXX\n,\n //How many permissions we need?\n Scope = Scope.USER_READ_PRIVATE,\n };\n //With this token object, we now can make calls\n Token token = auth.DoAuth();\n var spotify = new SpotifyWebApiClass()\n {\n TokenType = token.TokenType,\n AccessToken = token.AccessToken,\n UseAuth = false\n };\n}", "title": "Authentication" }, { "location": "/SpotifyWebApi/auth/#auth-methods", - "text": "Before you can use the Web API full functional, you need the user to authenticate your Application. \nIf you want to know more, you can read to the whole auth-process here . Before you start, you need to create a Application at Spotify: Your Applications After you created your Application, you will have following important values: Client_Id This is your client_id, you don't have to hide it Client_Secret Never use this in one of your client-side apps!! Keep it secret! Redirect URIs Add \"http://localhost\", if you want full support for this API Now you can start with the User-authentication, Spotify provides 3 ways: ImplicitGrantAuth ( Recommended , no server-side code needed) AutorizationCodeAuth (Not Recommended, Server-side code needed, else it's unsecure) ClientCredentialsAuth (Not Recommended, Server-side code needed, else it's unsecure) Note: I would recommend a little PHP Script, which will exchange the Keys using AutorizationCodeAuth. \nWhen using ImplicitGrantAuth, another user could abuse the \"localhost\" RedirectUri by creating a \"fake\"-app which uses your ClientId. Overview: After implementing one of the provided auth-methods, you can start doing requests with the token you get from one of the auth-methods", + "text": "Before you can use the Web API full functional, you need the user to authenticate your Application. \nIf you want to know more, you can read to the whole auth-process here . Before you start, you need to create a Application at Spotify: Your Applications After you created your Application, you will have following important values: Client_Id This is your client_id, you don't have to hide it Client_Secret Never use this in one of your client-side apps!! Keep it secret! Redirect URIs Add \"http://localhost\", if you want full support for this API Now you can start with the User-authentication, Spotify provides 3 ways: ImplicitGrantAuth ( Recommended , no server-side code needed) AutorizationCodeAuth (Not Recommended, Server-side code needed, else it's unsecure) ClientCredentialsAuth (Not Recommended, Server-side code needed, else it's unsecure) Note: I would recommend a little PHP Script, which will exchange the Keys using AutorizationCodeAuth.\nWhen using ImplicitGrantAuth, another user could abuse the \"localhost\" RedirectUri by creating a \"fake\"-app which uses your ClientId. Overview: After implementing one of the provided auth-methods, you can start doing requests with the token you get from one of the auth-methods", "title": "Auth-Methods" }, { @@ -72,59 +72,224 @@ }, { "location": "/SpotifyWebApi/auth/#clientcredentialsauth", - "text": "This way is not recommended and requires server-side code to run securely. \nWith this approach, you make a POST Request with a base64 encoded string (consists of ClientId + ClientSecret). You will directly get the token (Without a local HTTP Server), but it will expire and can't be refreshed. \nIf you want to use it securely, you would need to do it all server-side. NOTE: You will only be able to query non-user-related information e.g search for a Track. More info: here static ClientCredentialsAuth auth;\nstatic void Main(string[] args)\n{\n //Create the auth object\n auth = new ClientCredentialsAuth()\n {\n //Your client Id\n ClientId = XXXXXXXXXXXXXXX ,\n //Your client secret UNSECURE!!\n ClientSecret = XXXXXXXXXXXX ,\n //How many permissions we need?\n Scope = Scope.USER_READ_PRIVATE,\n };\n //With this token object, we now can make calls \n Token token = auth.DoAuth();\n var spotify = new SpotifyWebApiClass()\n {\n TokenType = token.TokenType,\n AccessToken = token.AccessToken,\n UseAuth = false\n };\n}", + "text": "This way is not recommended and requires server-side code to run securely. \nWith this approach, you make a POST Request with a base64 encoded string (consists of ClientId + ClientSecret). You will directly get the token (Without a local HTTP Server), but it will expire and can't be refreshed. \nIf you want to use it securely, you would need to do it all server-side. NOTE: You will only be able to query non-user-related information e.g search for a Track. More info: here static ClientCredentialsAuth auth;\nstatic void Main(string[] args)\n{\n //Create the auth object\n auth = new ClientCredentialsAuth()\n {\n //Your client Id\n ClientId = XXXXXXXXXXXXXXX ,\n //Your client secret UNSECURE!!\n ClientSecret = XXXXXXXXXXXX ,\n //How many permissions we need?\n Scope = Scope.USER_READ_PRIVATE,\n };\n //With this token object, we now can make calls\n Token token = auth.DoAuth();\n var spotify = new SpotifyWebApiClass()\n {\n TokenType = token.TokenType,\n AccessToken = token.AccessToken,\n UseAuth = false\n };\n}", "title": "ClientCredentialsAuth" }, + { + "location": "/SpotifyWebApi/search/", + "text": "SearchItems\n\n\n\n\nGet Spotify catalog information about artists, albums, tracks or playlists that match a keyword string.\n\n\n\n\nParamters\n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nq\n\n\nThe search query's keywords (and optional field filters and operators), for example q=roadhouse+blues.\n\n\n\"roadhouse+blues\"\n\n\n\n\n\n\ntype\n\n\nA list of item types to search across.\n\n\nSearchType.Album\n\n\n\n\n\n\n[limit]\n\n\nThe maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.\n\n\n20\n\n\n\n\n\n\n[offset]\n\n\nThe index of the first result to return. Default: 0\n\n\n0\n\n\n\n\n\n\n[market]\n\n\nAn ISO 3166-1 alpha-2 country code or the string from_token.\n\n\n\"de\"\n\n\n\n\n\n\n\n\nReturns a \nSearchItem\n which contains the properties \nPaging\nSimpleArtist\n Artists\n,\nPaging\nFullTrack\n Tracks\n, \nPaging\nSimpleAlbum\n Albums\n. They are filled based on your search-type.\n\n\nUsage\n\n\nSearchItem item = _spotify.SearchItems(\nroadhouse+blues\n, SearchType.Album);\nConsole.WriteLine(item.Albums.Total); //How many results are there in total? NOTE: item.Tracks = item.Artists = null", + "title": "- Search" + }, + { + "location": "/SpotifyWebApi/search/#searchitems", + "text": "Get Spotify catalog information about artists, albums, tracks or playlists that match a keyword string. Paramters Name Description Example q The search query's keywords (and optional field filters and operators), for example q=roadhouse+blues. \"roadhouse+blues\" type A list of item types to search across. SearchType.Album [limit] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. 20 [offset] The index of the first result to return. Default: 0 0 [market] An ISO 3166-1 alpha-2 country code or the string from_token. \"de\" Returns a SearchItem which contains the properties Paging SimpleArtist Artists , Paging FullTrack Tracks , Paging SimpleAlbum Albums . They are filled based on your search-type. Usage SearchItem item = _spotify.SearchItems( roadhouse+blues , SearchType.Album);\nConsole.WriteLine(item.Albums.Total); //How many results are there in total? NOTE: item.Tracks = item.Artists = null", + "title": "SearchItems" + }, { "location": "/SpotifyWebApi/albums/", - "text": "GetAlbumTracks\n\n\n\n\nGet Spotify catalog information about an album's tracks. Optional parameters can be used to limit the number of tracks returned.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nid\n\n\nThe Spotify ID for the album.\n\n\nEXAMPLE\n\n\n\n\n\n\nlimit\n\n\nThe maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.\n\n\nEXAMPLE\n\n\n\n\n\n\noffset\n\n\nThe index of the first track to return. Default: 0 (the first object).\n\n\nEXAMPLE\n\n\n\n\n\n\nmarket\n\n\nAn ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage\n \n\n\n\n\n\n\n\nGetAlbum\n\n\n\n\nGet Spotify catalog information for a single album.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nid\n\n\nThe Spotify ID for the album.\n\n\nEXAMPLE\n\n\n\n\n\n\nmarket\n\n\nAn ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage\n \n\n\n\n\n\n\n\nGetSeveralAlbums\n\n\n\n\nGet Spotify catalog information for multiple albums identified by their Spotify IDs.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nids\n\n\nA list of the Spotify IDs for the albums. Maximum: 20 IDs.\n\n\nEXAMPLE\n\n\n\n\n\n\nmarket\n\n\nAn ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage", + "text": "GetAlbumTracks\n\n\n\n\nGet Spotify catalog information about an album's tracks. Optional parameters can be used to limit the number of tracks returned.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nid\n\n\nThe Spotify ID for the album.\n\n\n\"5O7V8l4SeXTymVp3IesT9C\"\n\n\n\n\n\n\n[limit]\n\n\nThe maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.\n\n\n20\n\n\n\n\n\n\n[offset]\n\n\nThe index of the first track to return. Default: 0 (the first object).\n\n\n0\n\n\n\n\n\n\n[market]\n\n\nAn ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.\n\n\n\"DE\"\n\n\n\n\n\n\n\n\nReturns a \nSimpleTrack\n wrapped inside a \nPaging-object\n\n\nUsage\n \n\n\nPaging\nSimpleTrack\n tracks = _spotify.GetAlbumTracks(\n5O7V8l4SeXTymVp3IesT9C\n);\ntracks.Items.ForEach(item =\n Console.WriteLine(item.Name)); //Display all fetched Track-Names (max 20)\nConsole.WriteLine(tracks.Total.ToString()) //Display total album track count\n\n\n\n\n\n\nGetAlbum\n\n\n\n\nGet Spotify catalog information for a single album.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nid\n\n\nThe Spotify ID for the album.\n\n\n5O7V8l4SeXTymVp3IesT9C\n\n\n\n\n\n\n[market]\n\n\nAn ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.\n\n\n\"DE\"\n\n\n\n\n\n\n\n\nReturns a \nFullAlbum\n\n\nUsage\n \n\n\nFullAlbum album = _spotify.GetAlbum(\n5O7V8l4SeXTymVp3IesT9C\n);\nConsole.WriteLine(album.Name + \n| Popularity: \n + album.Popularity); //Display name and Popularity\n\n\n\n\n\n\nGetSeveralAlbums\n\n\n\n\nGet Spotify catalog information for multiple albums identified by their Spotify IDs.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nids\n\n\nA list of the Spotify IDs for the albums. Maximum: 20 IDs.\n\n\nnew List\nString\n() { \"5O7V8l4SeXTymVp3IesT9C\" }\n\n\n\n\n\n\n[market]\n\n\nAn ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.\n\n\n\"DE\"\n\n\n\n\n\n\n\n\nReturns a \nSeveralAlbums\n which Property \"Albums\" contains a list of \nFullAlbum\n\n\nUsage\n \n\n\nSeveralAlbums albums = _spotify.GetSeveralAlbums(new List\nString\n() { \n5O7V8l4SeXTymVp3IesT9C\n });\nConsole.WriteLine(albums.Albums[0].Name);", "title": "- Albums" }, { "location": "/SpotifyWebApi/albums/#getalbumtracks", - "text": "Get Spotify catalog information about an album's tracks. Optional parameters can be used to limit the number of tracks returned. Paramters Name Description Example id The Spotify ID for the album. EXAMPLE limit The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. EXAMPLE offset The index of the first track to return. Default: 0 (the first object). EXAMPLE market An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking. EXAMPLE Returns a Public User Model Usage", + "text": "Get Spotify catalog information about an album's tracks. Optional parameters can be used to limit the number of tracks returned. Paramters Name Description Example id The Spotify ID for the album. \"5O7V8l4SeXTymVp3IesT9C\" [limit] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. 20 [offset] The index of the first track to return. Default: 0 (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 SimpleTrack wrapped inside a Paging-object Usage Paging SimpleTrack tracks = _spotify.GetAlbumTracks( 5O7V8l4SeXTymVp3IesT9C );\ntracks.Items.ForEach(item = Console.WriteLine(item.Name)); //Display all fetched Track-Names (max 20)\nConsole.WriteLine(tracks.Total.ToString()) //Display total album track count", "title": "GetAlbumTracks" }, { "location": "/SpotifyWebApi/albums/#getalbum", - "text": "Get Spotify catalog information for a single album. Paramters Name Description Example id The Spotify ID for the album. EXAMPLE market An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking. EXAMPLE Returns a Public User Model Usage", + "text": "Get Spotify catalog information for a single album. Paramters Name Description Example id The Spotify ID for the album. 5O7V8l4SeXTymVp3IesT9C [market] An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking. \"DE\" Returns a FullAlbum Usage FullAlbum album = _spotify.GetAlbum( 5O7V8l4SeXTymVp3IesT9C );\nConsole.WriteLine(album.Name + | Popularity: + album.Popularity); //Display name and Popularity", "title": "GetAlbum" }, { "location": "/SpotifyWebApi/albums/#getseveralalbums", - "text": "Get Spotify catalog information for multiple albums identified by their Spotify IDs. Paramters Name Description Example ids A list of the Spotify IDs for the albums. Maximum: 20 IDs. EXAMPLE market An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking. EXAMPLE Returns a Public User Model Usage", + "text": "Get Spotify catalog information for multiple albums identified by their Spotify IDs. Paramters Name Description Example ids A list of the Spotify IDs for the albums. Maximum: 20 IDs. new List String () { \"5O7V8l4SeXTymVp3IesT9C\" } [market] An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking. \"DE\" Returns a SeveralAlbums which Property \"Albums\" contains a list of FullAlbum Usage SeveralAlbums albums = _spotify.GetSeveralAlbums(new List String () { 5O7V8l4SeXTymVp3IesT9C });\nConsole.WriteLine(albums.Albums[0].Name);", "title": "GetSeveralAlbums" }, { "location": "/SpotifyWebApi/artists/", - "text": "GetArtist\n\n\n\n\nGet Spotify catalog information for a single artist identified by their unique Spotify ID.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nid\n\n\nThe Spotify ID for the artist.\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage\n \n\n\n\n\n\n\n\nGetRelatedArtists\n\n\n\n\nGet Spotify catalog information about artists similar to a given artist. Similarity is based on analysis of the Spotify community's listening history.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nid\n\n\nThe Spotify ID for the artist.\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage\n \n\n\n\n\n\n\n\nGetArtistsTopTracks\n\n\n\n\nGet Spotify catalog information about an artist's top tracks by country.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nid\n\n\nThe Spotify ID for the artist.\n\n\nEXAMPLE\n\n\n\n\n\n\ncountry\n\n\nThe country: an ISO 3166-1 alpha-2 country code.\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage\n \n\n\n\n\n\n\n\nGetArtistsAlbums\n\n\n\n\nGet Spotify catalog information about an artist's albums. Optional parameters can be specified in the query string to filter and sort the response.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nid\n\n\nThe Spotify ID for the artist.\n\n\nEXAMPLE\n\n\n\n\n\n\ntype\n\n\nA list of keywords that will be used to filter the response. If not supplied, all album types will be returned\n\n\nEXAMPLE\n\n\n\n\n\n\nlimit\n\n\nThe maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.\n\n\nEXAMPLE\n\n\n\n\n\n\noffset\n\n\nThe index of the first album to return. Default: 0\n\n\nEXAMPLE\n\n\n\n\n\n\nmarket\n\n\nAn ISO 3166-1 alpha-2 country code. Supply this parameter to limit the response to one particular geographical market\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage\n \n\n\n\n\n\n\n\nGetSeveralArtists\n\n\n\n\nGet Spotify catalog information for several artists based on their Spotify IDs.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nids\n\n\nA list of the Spotify IDs for the artists. Maximum: 50 IDs.\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage", + "text": "GetArtist\n\n\n\n\nGet Spotify catalog information for a single artist identified by their unique Spotify ID.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nid\n\n\nThe Spotify ID for the artist.\n\n\n\"1KpCi9BOfviCVhmpI4G2sY\"\n\n\n\n\n\n\n\n\nReturns a \nFullArtist\n\n\nUsage\n \n\n\nFullArtist artist = _spotify.GetArtist(\n1KpCi9BOfviCVhmpI4G2sY\n);\nConsole.WriteLine()\n\n\n\n\n\n\nGetRelatedArtists\n\n\n\n\nGet Spotify catalog information about artists similar to a given artist. Similarity is based on analysis of the Spotify community's listening history.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nid\n\n\nThe Spotify ID for the artist.\n\n\n\"1KpCi9BOfviCVhmpI4G2sY\"\n\n\n\n\n\n\n\n\nReturns a \nSeveralArtists\n object which contains the property \nList\nFullArtist\n Artists\n (\nFullArtist\n)\n\n\nUsage\n \n\n\nSeveralArtists artists = _spotify.GetRelatedArtists(\n1KpCi9BOfviCVhmpI4G2sY\n);\nConsole.WriteLine(artists.Artists[0].Name);\n\n\n\n\n\n\nGetArtistsTopTracks\n\n\n\n\nGet Spotify catalog information about an artist's top tracks by country.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nid\n\n\nThe Spotify ID for the artist.\n\n\n\"1KpCi9BOfviCVhmpI4G2sY\"\n\n\n\n\n\n\ncountry\n\n\nThe country: an ISO 3166-1 alpha-2 country code.\n\n\n\"DE\"\n\n\n\n\n\n\n\n\nReturns a \nSeveralTracks\n object which contains the property \nList\nFullTrack\n Tracks\n (\nFullTrack\n)\n\n\nUsage\n \n\n\nSeveralTracks tracks = _spotify.GetArtistsTopTracks(\n1KpCi9BOfviCVhmpI4G2sY\n, \nDE\n);\nConsole.WriteLine(tracks.Tracks.Count); //How many tracks did we get?\n\n\n\n\n\n\nGetArtistsAlbums\n\n\n\n\nGet Spotify catalog information about an artist's albums. Optional parameters can be specified in the query string to filter and sort the response.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nid\n\n\nThe Spotify ID for the artist.\n\n\n\"1KpCi9BOfviCVhmpI4G2sY\"\n\n\n\n\n\n\n[type]\n\n\nA list of keywords that will be used to filter the response. If not supplied, all album types will be returned\n\n\nAlbumType.All\n\n\n\n\n\n\n[limit]\n\n\nThe maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.\n\n\n20\n\n\n\n\n\n\n[offset]\n\n\nThe index of the first album to return. Default: 0\n\n\n0\n\n\n\n\n\n\n[market]\n\n\nAn ISO 3166-1 alpha-2 country code. Supply this parameter to limit the response to one particular geographical market\n\n\n\"DE\"\n\n\n\n\n\n\n\n\nReturns a \nSimpleAlbum\n wrapped inside a \nPaging-object\n\n\nUsage\n \n\n\nPaging\nSimpleAlbum\n albums = _spotify.GetArtistsAlbums(\n1KpCi9BOfviCVhmpI4G2sY\n, AlbumType.All);\nalbums.Items.ForEach(album =\n Console.WriteLine(album.Name));\n\n\n\n\n\n\nGetSeveralArtists\n\n\n\n\nGet Spotify catalog information for several artists based on their Spotify IDs.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nids\n\n\nA list of the Spotify IDs for the artists. Maximum: 50 IDs.\n\n\nnew List\nString\n() { \"1KpCi9BOfviCVhmpI4G2sY\" }\n\n\n\n\n\n\n\n\nReturns a \nSeveralArtists\n object which contains the property \nList\nFullArtist\n Artists\n (\nFullArtist\n)\n\n\nUsage\n \n\n\nSeveralArtists artists = _spotify.GetSeveralArtists(new List\nString\n() {\n1KpCi9BOfviCVhmpI4G2sY\n});\nartists.Artists.ForEach(artist =\n Console.WriteLine(artist.Name));", "title": "- Artists" }, { "location": "/SpotifyWebApi/artists/#getartist", - "text": "Get Spotify catalog information for a single artist identified by their unique Spotify ID. Paramters Name Description Example id The Spotify ID for the artist. EXAMPLE Returns a Public User Model Usage", + "text": "Get Spotify catalog information for a single artist identified by their unique Spotify ID. Paramters Name Description Example id The Spotify ID for the artist. \"1KpCi9BOfviCVhmpI4G2sY\" Returns a FullArtist Usage FullArtist artist = _spotify.GetArtist( 1KpCi9BOfviCVhmpI4G2sY );\nConsole.WriteLine()", "title": "GetArtist" }, { "location": "/SpotifyWebApi/artists/#getrelatedartists", - "text": "Get Spotify catalog information about artists similar to a given artist. Similarity is based on analysis of the Spotify community's listening history. Paramters Name Description Example id The Spotify ID for the artist. EXAMPLE Returns a Public User Model Usage", + "text": "Get Spotify catalog information about artists similar to a given artist. Similarity is based on analysis of the Spotify community's listening history. Paramters Name Description Example id The Spotify ID for the artist. \"1KpCi9BOfviCVhmpI4G2sY\" Returns a SeveralArtists object which contains the property List FullArtist Artists ( FullArtist ) Usage SeveralArtists artists = _spotify.GetRelatedArtists( 1KpCi9BOfviCVhmpI4G2sY );\nConsole.WriteLine(artists.Artists[0].Name);", "title": "GetRelatedArtists" }, { "location": "/SpotifyWebApi/artists/#getartiststoptracks", - "text": "Get Spotify catalog information about an artist's top tracks by country. Paramters Name Description Example id The Spotify ID for the artist. EXAMPLE country The country: an ISO 3166-1 alpha-2 country code. EXAMPLE Returns a Public User Model Usage", + "text": "Get Spotify catalog information about an artist's top tracks by country. Paramters Name Description Example id The Spotify ID for the artist. \"1KpCi9BOfviCVhmpI4G2sY\" country The country: an ISO 3166-1 alpha-2 country code. \"DE\" Returns a SeveralTracks object which contains the property List FullTrack Tracks ( FullTrack ) Usage SeveralTracks tracks = _spotify.GetArtistsTopTracks( 1KpCi9BOfviCVhmpI4G2sY , DE );\nConsole.WriteLine(tracks.Tracks.Count); //How many tracks did we get?", "title": "GetArtistsTopTracks" }, { "location": "/SpotifyWebApi/artists/#getartistsalbums", - "text": "Get Spotify catalog information about an artist's albums. Optional parameters can be specified in the query string to filter and sort the response. Paramters Name Description Example id The Spotify ID for the artist. EXAMPLE type A list of keywords that will be used to filter the response. If not supplied, all album types will be returned EXAMPLE limit The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. EXAMPLE offset The index of the first album to return. Default: 0 EXAMPLE market An ISO 3166-1 alpha-2 country code. Supply this parameter to limit the response to one particular geographical market EXAMPLE Returns a Public User Model Usage", + "text": "Get Spotify catalog information about an artist's albums. Optional parameters can be specified in the query string to filter and sort the response. Paramters Name Description Example id The Spotify ID for the artist. \"1KpCi9BOfviCVhmpI4G2sY\" [type] A list of keywords that will be used to filter the response. If not supplied, all album types will be returned AlbumType.All [limit] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. 20 [offset] The index of the first album to return. Default: 0 0 [market] An ISO 3166-1 alpha-2 country code. Supply this parameter to limit the response to one particular geographical market \"DE\" Returns a SimpleAlbum wrapped inside a Paging-object Usage Paging SimpleAlbum albums = _spotify.GetArtistsAlbums( 1KpCi9BOfviCVhmpI4G2sY , AlbumType.All);\nalbums.Items.ForEach(album = Console.WriteLine(album.Name));", "title": "GetArtistsAlbums" }, { "location": "/SpotifyWebApi/artists/#getseveralartists", - "text": "Get Spotify catalog information for several artists based on their Spotify IDs. Paramters Name Description Example ids A list of the Spotify IDs for the artists. Maximum: 50 IDs. EXAMPLE Returns a Public User Model Usage", + "text": "Get Spotify catalog information for several artists based on their Spotify IDs. Paramters Name Description Example ids A list of the Spotify IDs for the artists. Maximum: 50 IDs. new List String () { \"1KpCi9BOfviCVhmpI4G2sY\" } Returns a SeveralArtists object which contains the property List FullArtist Artists ( FullArtist ) Usage SeveralArtists artists = _spotify.GetSeveralArtists(new List String () { 1KpCi9BOfviCVhmpI4G2sY });\nartists.Artists.ForEach(artist = Console.WriteLine(artist.Name));", "title": "GetSeveralArtists" }, + { + "location": "/SpotifyWebApi/browse/", + "text": "GetFeaturedPlaylists\n\n\nAUTH REQUIRED\n\n\n\n\nGet a list of Spotify featured playlists (shown, for example, on a Spotify player\u2019s \u201cBrowse\u201d tab).\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\n[locale]\n\n\nThe desired language, consisting of a lowercase ISO 639 language code and an uppercase ISO 3166-1 alpha-2 country code, joined by an underscore.\n\n\n\"de_DE\" //Germany\n\n\n\n\n\n\n[country]\n\n\nA country: an ISO 3166-1 alpha-2 country code.\n\n\n\"DE\"\n\n\n\n\n\n\n[timestamp]\n\n\nA timestamp in ISO 8601 format\n\n\nDateTime.Now\n\n\n\n\n\n\n[limit]\n\n\nThe maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.\n\n\n20\n\n\n\n\n\n\n[offset]\n\n\nThe index of the first item to return. Default: 0\n\n\n0\n\n\n\n\n\n\n\n\nReturns a \nFeaturedPlaylists\n object, which has 2 properties. \nString Message\n and \nPaging\nSimplePlaylist\n Playlists\n\n\nUsage\n \n\n\nFeaturedPlaylists playlists = _spotify.GetFeaturedPlaylists();\nConsole.WriteLine(playlists.Message);\nplaylists.Playlists.Items.ForEach(playlist =\n Console.WriteLine(playlist.Name));\n\n\n\n\n\n\nGetNewAlbumReleases\n\n\nAUTH REQUIRED\n\n\n\n\nGet a list of new album releases featured in Spotify (shown, for example, on a Spotify player\u2019s \u201cBrowse\u201d tab).\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\n[country]\n\n\nA country: an ISO 3166-1 alpha-2 country code.\n\n\n\"DE\"\n\n\n\n\n\n\n[limit]\n\n\nThe maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.\n\n\n20\n\n\n\n\n\n\n[offset]\n\n\nThe index of the first item to return. Default: 0\n\n\n0\n\n\n\n\n\n\n\n\nReturns a \nNewAlbumReleases\n object, which has the property \nPaging\nSimpleAlbum\n Albums\n.\n\n\nUsage\n \n\n\nNewAlbumReleases newAlbums = _spotify.GetNewAlbumReleases();\nnewAlbums.Albums.Items.ForEach(album =\n Console.WriteLine(album.Name));\n\n\n\n\n\n\nGetCategories\n\n\nAUTH REQUIRED\n\n\n\n\nGet a list of categories used to tag items in Spotify (on, for example, the Spotify player\u2019s \u201cBrowse\u201d tab).\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\n[country]\n\n\nA country: an ISO 3166-1 alpha-2 country code. Provide this parameter if you want to narrow the list of returned categories to those relevant to a particular country\n\n\n\"DE\"\n\n\n\n\n\n\n[locale]\n\n\nThe desired language, consisting of an ISO 639 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore\n\n\n\"de_DE\"\n\n\n\n\n\n\n[limit]\n\n\nThe maximum number of categories to return. Default: 20. Minimum: 1. Maximum: 50.\n\n\n20\n\n\n\n\n\n\n[offset]\n\n\nThe index of the first item to return. Default: 0 (the first object).\n\n\n0\n\n\n\n\n\n\n\n\nReturns a \nCategoryList\n object, which has the property \nPaging\nCategory\n Categories\n.\n\n\nUsage\n \n\n\nCategoryList categoryList = _spotify.GetCategories();\ncategoryList.Categories.Items.ForEach(category =\n Console.WriteLine(category.Name));\n\n\n\n\n\n\nGetCategory\n\n\nAUTH REQUIRED\n\n\n\n\nGet a single category used to tag items in Spotify (on, for example, the Spotify player\u2019s \u201cBrowse\u201d tab).\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\ncategoryId\n\n\nThe Spotify category ID for the category.\n\n\n\"party\"\n\n\n\n\n\n\n[country]\n\n\nA country: an ISO 3166-1 alpha-2 country code. Provide this parameter to ensure that the category exists for a particular country.\n\n\n\"DE\"\n\n\n\n\n\n\n[locale]\n\n\nThe desired language, consisting of an ISO 639 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore\n\n\n\"de_DE\"\n\n\n\n\n\n\n\n\nReturns a \nCategory\n\n\nUsage\n \n\n\nCategory cat = _spotify.GetCategory(\nparty\n);\nConsole.WriteLine(cat.Name);\n\n\n\n\n\n\nGetCategoryPlaylists\n\n\nAUTH REQUIRED\n\n\n\n\nGet a list of Spotify playlists tagged with a particular category.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\ncategoryId\n\n\nThe Spotify category ID for the category.\n\n\n\"party\"\n\n\n\n\n\n\n[country]\n\n\nA country: an ISO 3166-1 alpha-2 country code.\n\n\n\"DE\"\n\n\n\n\n\n\n[limit]\n\n\nThe maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.\n\n\n20\n\n\n\n\n\n\n[offset]\n\n\nThe index of the first item to return. Default: 0\n\n\n0\n\n\n\n\n\n\n\n\nReturns a \nCategoryPlaylist\n object, which has the property \nPaging\nSimplePlaylist\n Playlists\n\n\nUsage\n \n\n\nCategoryPlaylist playlists = _spotify.GetCategoryPlaylists(\nparty\n);\nplaylists.Playlists.Items.ForEach(playlist =\n Console.WriteLine(playlist.Name));", + "title": "- Browse" + }, + { + "location": "/SpotifyWebApi/browse/#getfeaturedplaylists", + "text": "AUTH REQUIRED Get a list of Spotify featured playlists (shown, for example, on a Spotify player\u2019s \u201cBrowse\u201d tab). Paramters Name Description Example [locale] The desired language, consisting of a lowercase ISO 639 language code and an uppercase ISO 3166-1 alpha-2 country code, joined by an underscore. \"de_DE\" //Germany [country] A country: an ISO 3166-1 alpha-2 country code. \"DE\" [timestamp] A timestamp in ISO 8601 format DateTime.Now [limit] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. 20 [offset] The index of the first item to return. Default: 0 0 Returns a FeaturedPlaylists object, which has 2 properties. String Message and Paging SimplePlaylist Playlists Usage FeaturedPlaylists playlists = _spotify.GetFeaturedPlaylists();\nConsole.WriteLine(playlists.Message);\nplaylists.Playlists.Items.ForEach(playlist = Console.WriteLine(playlist.Name));", + "title": "GetFeaturedPlaylists" + }, + { + "location": "/SpotifyWebApi/browse/#getnewalbumreleases", + "text": "AUTH REQUIRED Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player\u2019s \u201cBrowse\u201d tab). Paramters Name Description Example [country] A country: an ISO 3166-1 alpha-2 country code. \"DE\" [limit] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. 20 [offset] The index of the first item to return. Default: 0 0 Returns a NewAlbumReleases object, which has the property Paging SimpleAlbum Albums . Usage NewAlbumReleases newAlbums = _spotify.GetNewAlbumReleases();\nnewAlbums.Albums.Items.ForEach(album = Console.WriteLine(album.Name));", + "title": "GetNewAlbumReleases" + }, + { + "location": "/SpotifyWebApi/browse/#getcategories", + "text": "AUTH REQUIRED Get a list of categories used to tag items in Spotify (on, for example, the Spotify player\u2019s \u201cBrowse\u201d tab). Paramters Name Description Example [country] A country: an ISO 3166-1 alpha-2 country code. Provide this parameter if you want to narrow the list of returned categories to those relevant to a particular country \"DE\" [locale] The desired language, consisting of an ISO 639 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore \"de_DE\" [limit] The maximum number of categories to return. Default: 20. Minimum: 1. Maximum: 50. 20 [offset] The index of the first item to return. Default: 0 (the first object). 0 Returns a CategoryList object, which has the property Paging Category Categories . Usage CategoryList categoryList = _spotify.GetCategories();\ncategoryList.Categories.Items.ForEach(category = Console.WriteLine(category.Name));", + "title": "GetCategories" + }, + { + "location": "/SpotifyWebApi/browse/#getcategory", + "text": "AUTH REQUIRED Get a single category used to tag items in Spotify (on, for example, the Spotify player\u2019s \u201cBrowse\u201d tab). Paramters Name Description Example categoryId The Spotify category ID for the category. \"party\" [country] A country: an ISO 3166-1 alpha-2 country code. Provide this parameter to ensure that the category exists for a particular country. \"DE\" [locale] The desired language, consisting of an ISO 639 language code and an ISO 3166-1 alpha-2 country code, joined by an underscore \"de_DE\" Returns a Category Usage Category cat = _spotify.GetCategory( party );\nConsole.WriteLine(cat.Name);", + "title": "GetCategory" + }, + { + "location": "/SpotifyWebApi/browse/#getcategoryplaylists", + "text": "AUTH REQUIRED Get a list of Spotify playlists tagged with a particular category. Paramters Name Description Example categoryId The Spotify category ID for the category. \"party\" [country] A country: an ISO 3166-1 alpha-2 country code. \"DE\" [limit] The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50. 20 [offset] The index of the first item to return. Default: 0 0 Returns a CategoryPlaylist object, which has the property Paging SimplePlaylist Playlists Usage CategoryPlaylist playlists = _spotify.GetCategoryPlaylists( party );\nplaylists.Playlists.Items.ForEach(playlist = Console.WriteLine(playlist.Name));", + "title": "GetCategoryPlaylists" + }, + { + "location": "/SpotifyWebApi/follow/", + "text": "Follow\n\n\nAUTH REQUIRED\n\n\n\n\nAdd the current user as a follower of one or more artists or other Spotify users.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nfollowType\n\n\nThe ID type: either artist or user.\n\n\nFollowType.Artist\n\n\n\n\n\n\nids or id\n\n\nA list of the artist or the user Spotify IDs or just a Spotify ID\n\n\nnew List\nString\n { \"1KpCi9BOfviCVhmpI4G2sY\" }\n or \n\"1KpCi9BOfviCVhmpI4G2sY\"\n\n\n\n\n\n\n\n\nReturns a \nErrorResponse\n which just contains a possible error. (\nresponse.HasError()\n and \nresponse.Error\n)\n\n\nUsage\n \n\n\nErrorResponse response = _spotify.Follow(FollowType.Artist, \n1KpCi9BOfviCVhmpI4G2sY\n);\n//or if it's a User\nErrorResponse response = _spotify.Follow(FollowType.User, \n1122095781\n);\n\n\n\n\n\n\nUnfollow\n\n\nAUTH REQUIRED\n\n\n\n\nRemove the current user as a follower of one or more artists or other Spotify users.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nfollowType\n\n\nThe ID type: either artist or user.\n\n\nFollowType.Artist\n\n\n\n\n\n\nids or id\n\n\nA list of the artist or the user Spotify IDs or just a Spotify ID\n\n\nnew List\nString\n { \"1KpCi9BOfviCVhmpI4G2sY\" }\n or \n\"1KpCi9BOfviCVhmpI4G2sY\"\n\n\n\n\n\n\n\n\nReturns a \nErrorResponse\n which just contains a possible error. (\nresponse.HasError()\n and \nresponse.Error\n)\n\n\nUsage\n \n\n\nErrorResponse response = _spotify.Unfollow(FollowType.Artist, \n1KpCi9BOfviCVhmpI4G2sY\n);\n//or if it's a User\nErrorResponse response = _spotify.Unfollow(FollowType.User, \n1122095781\n);\n\n\n\n\n\n\nIsFollowing\n\n\nAUTH REQUIRED\n\n\n\n\nCheck to see if the current user is following one or more artists or other Spotify users.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nfollowType\n\n\nThe ID type: either artist or user.\n\n\nFollowType.Artist\n\n\n\n\n\n\nids or id\n\n\nA list of the artist or the user Spotify IDs or just a Spotify ID\n\n\nnew List\nString\n { \"1KpCi9BOfviCVhmpI4G2sY\" }\n or \n\"1KpCi9BOfviCVhmpI4G2sY\"\n\n\n\n\n\n\n\n\nReturns a \nListResponse\n which contains the property \nList\nBoolean\n List\n\n\nUsage\n \n\n\n//Are you one of my Followers? :P\nListResponse\nBoolean\n response = _spotify.IsFollowing(FollowType.User, \n1122095781\n);\nConsole.WriteLine(response.List[0] ? \nYis!\n : \nNo :(\n);\n\n\n\n\n\n\nFollowPlaylist\n\n\nAUTH REQUIRED\n\n\n\n\nAdd the current user as a follower of a playlist.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nownerId\n\n\nThe Spotify user ID of the person who owns the playlist.\n\n\n\"maxloermans\"\n\n\n\n\n\n\nplaylistId\n\n\nThe Spotify ID of the playlist. Any playlist can be followed, regardless of its public/private status, as long as you know its playlist ID.\n\n\n\"3SIp2VAsKI03mReF0dFBmI\"\n\n\n\n\n\n\n[showPublic]\n\n\nIf true the playlist will be included in user's public playlists, if false it will remain private.\n\n\ntrue\n\n\n\n\n\n\n\n\nReturns a \nErrorResponse\n which just contains a possible error. (\nresponse.HasError()\n and \nresponse.Error\n)\n\n\nUsage\n \n\n\nErrorResponse response = _spotify.FollowPlaylist(\nmaxloermans\n, \n3SIp2VAsKI03mReF0dFBmI\n);\nif(!response.HasError())\n Console.WriteLine(\nsuccess\n);\n\n\n\n\n\n\nUnfollowPlaylist\n\n\nAUTH REQUIRED\n\n\n\n\nRemove the current user as a follower of a playlist.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nownerId\n\n\nThe Spotify user ID of the person who owns the playlist.\n\n\n\"maxloermans\"\n\n\n\n\n\n\nplaylistId\n\n\nThe Spotify ID of the playlist that is to be no longer followed.\n\n\n\"3SIp2VAsKI03mReF0dFBmI\"\n\n\n\n\n\n\n\n\nReturns a \nErrorResponse\n which just contains a possible error. (\nresponse.HasError()\n and \nresponse.Error\n)\n\n\nUsage\n \n\n\nErrorResponse response = _spotify.UnfollowPlaylist(\nmaxloermans\n, \n3SIp2VAsKI03mReF0dFBmI\n);\nif(!response.HasError())\n Console.WriteLine(\nsuccess\n);\n\n\n\n\n\n\nIsFollowingPlaylist\n\n\nAUTH REQUIRED\n\n\n\n\nCheck to see if one or more Spotify users are following a specified playlist.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nownerId\n\n\nThe Spotify user ID of the person who owns the playlist.\n\n\n\"maxloermans\"\n\n\n\n\n\n\nplaylistId\n\n\nThe Spotify ID of the playlist.\n\n\n\"3SIp2VAsKI03mReF0dFBmI\"\n\n\n\n\n\n\nids or id\n\n\nA list of the artist or the user Spotify IDs or just a Spotify ID\n\n\nnew List\nString\n { \"1KpCi9BOfviCVhmpI4G2sY\" }\n or \n\"1KpCi9BOfviCVhmpI4G2sY\"\n\n\n\n\n\n\n\n\nReturns a \nListResponse\n which contains the property \nList\nBoolean\n List\n\n\nUsage\n \n\n\n//Am I following the playlist?\nListResponse\nBoolean\n response = _spotify.IsFollowing(\nmaxloermans\n, \n3SIp2VAsKI03mReF0dFBmI\n, \n1122095781\n);\nConsole.WriteLine(response.List[0] ? \nYis!\n : \nNo :(\n);", + "title": "- Follow" + }, + { + "location": "/SpotifyWebApi/follow/#follow", + "text": "AUTH REQUIRED Add the current user as a follower of one or more artists or other Spotify users. Paramters Name Description Example followType The ID type: either artist or user. FollowType.Artist ids or id A list of the artist or the user Spotify IDs or just a Spotify ID new List String { \"1KpCi9BOfviCVhmpI4G2sY\" } or \"1KpCi9BOfviCVhmpI4G2sY\" Returns a ErrorResponse which just contains a possible error. ( response.HasError() and response.Error ) Usage ErrorResponse response = _spotify.Follow(FollowType.Artist, 1KpCi9BOfviCVhmpI4G2sY );\n//or if it's a User\nErrorResponse response = _spotify.Follow(FollowType.User, 1122095781 );", + "title": "Follow" + }, + { + "location": "/SpotifyWebApi/follow/#unfollow", + "text": "AUTH REQUIRED Remove the current user as a follower of one or more artists or other Spotify users. Paramters Name Description Example followType The ID type: either artist or user. FollowType.Artist ids or id A list of the artist or the user Spotify IDs or just a Spotify ID new List String { \"1KpCi9BOfviCVhmpI4G2sY\" } or \"1KpCi9BOfviCVhmpI4G2sY\" Returns a ErrorResponse which just contains a possible error. ( response.HasError() and response.Error ) Usage ErrorResponse response = _spotify.Unfollow(FollowType.Artist, 1KpCi9BOfviCVhmpI4G2sY );\n//or if it's a User\nErrorResponse response = _spotify.Unfollow(FollowType.User, 1122095781 );", + "title": "Unfollow" + }, + { + "location": "/SpotifyWebApi/follow/#isfollowing", + "text": "AUTH REQUIRED Check to see if the current user is following one or more artists or other Spotify users. Paramters Name Description Example followType The ID type: either artist or user. FollowType.Artist ids or id A list of the artist or the user Spotify IDs or just a Spotify ID new List String { \"1KpCi9BOfviCVhmpI4G2sY\" } or \"1KpCi9BOfviCVhmpI4G2sY\" Returns a ListResponse which contains the property List Boolean List Usage //Are you one of my Followers? :P\nListResponse Boolean response = _spotify.IsFollowing(FollowType.User, 1122095781 );\nConsole.WriteLine(response.List[0] ? Yis! : No :( );", + "title": "IsFollowing" + }, + { + "location": "/SpotifyWebApi/follow/#followplaylist", + "text": "AUTH REQUIRED Add the current user as a follower of a playlist. Paramters Name Description Example ownerId The Spotify user ID of the person who owns the playlist. \"maxloermans\" playlistId The Spotify ID of the playlist. Any playlist can be followed, regardless of its public/private status, as long as you know its playlist ID. \"3SIp2VAsKI03mReF0dFBmI\" [showPublic] If true the playlist will be included in user's public playlists, if false it will remain private. true Returns a ErrorResponse which just contains a possible error. ( response.HasError() and response.Error ) Usage ErrorResponse response = _spotify.FollowPlaylist( maxloermans , 3SIp2VAsKI03mReF0dFBmI );\nif(!response.HasError())\n Console.WriteLine( success );", + "title": "FollowPlaylist" + }, + { + "location": "/SpotifyWebApi/follow/#unfollowplaylist", + "text": "AUTH REQUIRED Remove the current user as a follower of a playlist. Paramters Name Description Example ownerId The Spotify user ID of the person who owns the playlist. \"maxloermans\" playlistId The Spotify ID of the playlist that is to be no longer followed. \"3SIp2VAsKI03mReF0dFBmI\" Returns a ErrorResponse which just contains a possible error. ( response.HasError() and response.Error ) Usage ErrorResponse response = _spotify.UnfollowPlaylist( maxloermans , 3SIp2VAsKI03mReF0dFBmI );\nif(!response.HasError())\n Console.WriteLine( success );", + "title": "UnfollowPlaylist" + }, + { + "location": "/SpotifyWebApi/follow/#isfollowingplaylist", + "text": "AUTH REQUIRED Check to see if one or more Spotify users are following a specified playlist. Paramters Name Description Example ownerId The Spotify user ID of the person who owns the playlist. \"maxloermans\" playlistId The Spotify ID of the playlist. \"3SIp2VAsKI03mReF0dFBmI\" ids or id A list of the artist or the user Spotify IDs or just a Spotify ID new List String { \"1KpCi9BOfviCVhmpI4G2sY\" } or \"1KpCi9BOfviCVhmpI4G2sY\" Returns a ListResponse which contains the property List Boolean List Usage //Am I following the playlist?\nListResponse Boolean response = _spotify.IsFollowing( maxloermans , 3SIp2VAsKI03mReF0dFBmI , 1122095781 );\nConsole.WriteLine(response.List[0] ? Yis! : No :( );", + "title": "IsFollowingPlaylist" + }, + { + "location": "/SpotifyWebApi/library/", + "text": "SaveTracks\n\n\nAUTH REQUIRED\n\n\n\n\nSave one or more tracks to the current user\u2019s \u201cYour Music\u201d library.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nids\n\n\nA list of the Spotify IDs\n\n\nnew List\nString\n { \"3Hvu1pq89D4R0lyPBoujSv\" }\n\n\n\n\n\n\n\n\nReturns a \nErrorResponse\n which just contains a possible error. (\nresponse.HasError()\n and \nresponse.Error\n)\n\n\nUsage\n \n\n\nErrorResponse response = _spotify.SaveTracks(new List\nstring\n { \n3Hvu1pq89D4R0lyPBoujSv\n });\nif(!response.HasError())\n Console.WriteLine(\nsuccess\n);\n\n\n\n\n\n\nSaveTrack\n\n\nAUTH REQUIRED\n\n\n\n\nSave one track to the current user\u2019s \u201cYour Music\u201d library.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nid\n\n\nA Spotify ID\n\n\n\"3Hvu1pq89D4R0lyPBoujSv\"\n\n\n\n\n\n\n\n\nReturns a \nErrorResponse\n which just contains a possible error. (\nresponse.HasError()\n and \nresponse.Error\n)\n\n\nUsage\n \n\n\nErrorResponse response = _spotify.SaveTrack(\n3Hvu1pq89D4R0lyPBoujSv\n);\nif(!response.HasError())\n Console.WriteLine(\nsuccess\n);\n\n\n\n\n\n\nGetSavedTracks\n\n\nAUTH REQUIRED\n\n\n\n\nGet a list of the songs saved in the current Spotify user\u2019s \u201cYour Music\u201d library.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\n[limit]\n\n\nThe maximum number of objects to return. Default: 20. Minimum: 1. Maximum: 50.\n\n\n20\n\n\n\n\n\n\n[offset]\n\n\nThe index of the first object to return. Default: 0 (i.e., the first object)\n\n\n0\n\n\n\n\n\n\n[market]\n\n\nAn ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.\n\n\nDE\n\n\n\n\n\n\n\n\nReturns a \nPaging\n, \nSavedTrack\n contains 2 properties, \nDateTime AddedAt\n and \nFullTrack Track\n\n\nUsage\n \n\n\nPaging\nSavedTrack\n savedTracks = _spotify.GetSavedTracks();\nsavedTracks.Items.ForEach(track =\n Console.WriteLine(track.Track.Name));\n\n\n\n\n\n\nRemoveSavedTracks\n\n\nAUTH REQUIRED\n\n\n\n\nRemove one or more tracks from the current user\u2019s \u201cYour Music\u201d library.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nids\n\n\nA list of the Spotify IDs.\n\n\nnew List\nString\n { \"3Hvu1pq89D4R0lyPBoujSv\" }\n\n\n\n\n\n\n\n\nReturns a \nErrorResponse\n which just contains a possible error. (\nresponse.HasError()\n and \nresponse.Error\n)\n\n\nUsage\n \n\n\nErrorResponse response = _spotify.RemoveSavedTracks(new List\nstring\n { \n3Hvu1pq89D4R0lyPBoujSv\n });\nif(!response.HasError())\n Console.WriteLine(\nsuccess\n);\n\n\n\n\n\n\nCheckSavedTracks\n\n\nAUTH REQUIRED\n\n\n\n\nCheck if one or more tracks is already saved in the current Spotify user\u2019s \u201cYour Music\u201d library.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nids\n\n\nA list of the Spotify IDs.\n\n\nnew List\nString\n { \"3Hvu1pq89D4R0lyPBoujSv\" }\n\n\n\n\n\n\n\n\nReturns a \nListResponse\n which contains a property, \nList\nbool\n List\n\n\nUsage\n \n\n\nListResponse\nbool\n tracksSaved = _spotify.CheckSavedTracks(new List\nString\n { \n3Hvu1pq89D4R0lyPBoujSv\n });\nif(tracksSaved.List[0])\n Console.WriteLine(\nThe track is in your library!\n);", + "title": "- Library" + }, + { + "location": "/SpotifyWebApi/library/#savetracks", + "text": "AUTH REQUIRED Save one or more tracks to the current user\u2019s \u201cYour Music\u201d library. Paramters Name Description Example ids A 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.SaveTracks(new List string { 3Hvu1pq89D4R0lyPBoujSv });\nif(!response.HasError())\n Console.WriteLine( success );", + "title": "SaveTracks" + }, + { + "location": "/SpotifyWebApi/library/#savetrack", + "text": "AUTH REQUIRED Save one track to the current user\u2019s \u201cYour Music\u201d library. Paramters Name Description Example id A Spotify ID \"3Hvu1pq89D4R0lyPBoujSv\" Returns a ErrorResponse which just contains a possible error. ( response.HasError() and response.Error ) Usage ErrorResponse response = _spotify.SaveTrack( 3Hvu1pq89D4R0lyPBoujSv );\nif(!response.HasError())\n Console.WriteLine( success );", + "title": "SaveTrack" + }, + { + "location": "/SpotifyWebApi/library/#getsavedtracks", + "text": "AUTH REQUIRED Get a list of the songs saved in the current Spotify user\u2019s \u201cYour Music\u201d library. Paramters Name Description Example [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 contains 2 properties, DateTime AddedAt and FullTrack Track Usage Paging SavedTrack savedTracks = _spotify.GetSavedTracks();\nsavedTracks.Items.ForEach(track = Console.WriteLine(track.Track.Name));", + "title": "GetSavedTracks" + }, + { + "location": "/SpotifyWebApi/library/#removesavedtracks", + "text": "AUTH REQUIRED Remove one or more tracks from the current user\u2019s \u201cYour Music\u201d library. Paramters Name Description Example ids A 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 });\nif(!response.HasError())\n Console.WriteLine( success );", + "title": "RemoveSavedTracks" + }, + { + "location": "/SpotifyWebApi/library/#checksavedtracks", + "text": "AUTH REQUIRED Check if one or more tracks is already saved in the current Spotify user\u2019s \u201cYour Music\u201d library. Paramters Name Description Example ids A list of the Spotify IDs. new List String { \"3Hvu1pq89D4R0lyPBoujSv\" } Returns a ListResponse which contains a property, List bool List Usage ListResponse bool tracksSaved = _spotify.CheckSavedTracks(new List String { 3Hvu1pq89D4R0lyPBoujSv });\nif(tracksSaved.List[0])\n Console.WriteLine( The track is in your library! );", + "title": "CheckSavedTracks" + }, + { + "location": "/SpotifyWebApi/playlists/", + "text": "GetUserPlaylists\n\n\nAUTH REQUIRED\n\n\n\n\nGet a list of the playlists owned or followed by a Spotify user.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nuserId\n\n\nThe user's Spotify user ID.\n\n\nEXAMPLE\n\n\n\n\n\n\nlimit\n\n\nThe maximum number of playlists to return. Default: 20. Minimum: 1. Maximum: 50.\n\n\nEXAMPLE\n\n\n\n\n\n\noffset\n\n\nThe index of the first playlist to return. Default: 0 (the first object)\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage\n \n\n\n\n\n\n\n\nGetPlaylist\n\n\nAUTH REQUIRED\n\n\n\n\nGet a playlist owned by a Spotify user.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nuserId\n\n\nThe user's Spotify user ID.\n\n\nEXAMPLE\n\n\n\n\n\n\nplaylistId\n\n\nThe Spotify ID for the playlist.\n\n\nEXAMPLE\n\n\n\n\n\n\nfields\n\n\nFilters for the query: a comma-separated list of the fields to return. If omitted, all fields are returned.\n\n\nEXAMPLE\n\n\n\n\n\n\nmarket\n\n\nAn ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage\n \n\n\n\n\n\n\n\nGetPlaylistTracks\n\n\nAUTH REQUIRED\n\n\n\n\nGet full details of the tracks of a playlist owned by a Spotify user.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nuserId\n\n\nThe user's Spotify user ID.\n\n\nEXAMPLE\n\n\n\n\n\n\nplaylistId\n\n\nThe Spotify ID for the playlist.\n\n\nEXAMPLE\n\n\n\n\n\n\nfields\n\n\nFilters for the query: a comma-separated list of the fields to return. If omitted, all fields are returned.\n\n\nEXAMPLE\n\n\n\n\n\n\nlimit\n\n\nThe maximum number of tracks to return. Default: 100. Minimum: 1. Maximum: 100.\n\n\nEXAMPLE\n\n\n\n\n\n\noffset\n\n\nThe index of the first object to return. Default: 0 (i.e., the first object)\n\n\nEXAMPLE\n\n\n\n\n\n\nmarket\n\n\nAn ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking.\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage\n \n\n\n\n\n\n\n\nCreatePlaylist\n\n\nAUTH REQUIRED\n\n\n\n\nCreate a playlist for a Spotify user. (The playlist will be empty until you add tracks.)\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nuserId\n\n\nThe user's Spotify user ID.\n\n\nEXAMPLE\n\n\n\n\n\n\nplaylistName\n\n\nThe name for the new playlist, for example \"Your Coolest Playlist\". This name does not need to be unique.\n\n\nEXAMPLE\n\n\n\n\n\n\nisPublic\n\n\ndefault 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.\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage\n \n\n\n\n\n\n\n\nUpdatePlaylist\n\n\nAUTH REQUIRED\n\n\n\n\nChange a playlist\u2019s name and public/private state. (The user must, of course, own the playlist.)\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nuserId\n\n\nThe user's Spotify user ID.\n\n\nEXAMPLE\n\n\n\n\n\n\nplaylistId\n\n\nThe Spotify ID for the playlist.\n\n\nEXAMPLE\n\n\n\n\n\n\nnewName\n\n\nThe new name for the playlist, for example \"My New Playlist Title\".\n\n\nEXAMPLE\n\n\n\n\n\n\nnewPublic\n\n\nIf true the playlist will be public, if false it will be private.\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage\n \n\n\n\n\n\n\n\nReplacePlaylistTracks\n\n\nAUTH REQUIRED\n\n\n\n\nReplace 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.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nuserId\n\n\nThe user's Spotify user ID.\n\n\nEXAMPLE\n\n\n\n\n\n\nplaylistId\n\n\nThe Spotify ID for the playlist.\n\n\nEXAMPLE\n\n\n\n\n\n\nuris\n\n\nA list of Spotify track URIs to set. A maximum of 100 tracks can be set in one request.\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage\n \n\n\n\n\n\n\n\nRemovePlaylistTracks\n\n\nAUTH REQUIRED\n\n\n\n\nRemove one or more tracks from a user\u2019s playlist.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nuserId\n\n\nThe user's Spotify user ID.\n\n\nEXAMPLE\n\n\n\n\n\n\nplaylistId\n\n\nThe Spotify ID for the playlist.\n\n\nEXAMPLE\n\n\n\n\n\n\nuris\n\n\narray of objects containing Spotify URI strings (and their position in the playlist). A maximum of 100 objects can be sent at once.\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage\n \n\n\n\n\n\n\n\nRemovePlaylistTrack\n\n\nAUTH REQUIRED\n\n\n\n\nRemove one or more tracks from a user\u2019s playlist.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nuserId\n\n\nThe user's Spotify user ID.\n\n\nEXAMPLE\n\n\n\n\n\n\nplaylistId\n\n\nThe Spotify ID for the playlist.\n\n\nEXAMPLE\n\n\n\n\n\n\nuri\n\n\nSpotify URI\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage\n \n\n\n\n\n\n\n\nAddPlaylistTracks\n\n\nAUTH REQUIRED\n\n\n\n\nAdd one or more tracks to a user\u2019s playlist.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nuserId\n\n\nThe user's Spotify user ID.\n\n\nEXAMPLE\n\n\n\n\n\n\nplaylistId\n\n\nThe Spotify ID for the playlist.\n\n\nEXAMPLE\n\n\n\n\n\n\nuris\n\n\nA list of Spotify track URIs to add\n\n\nEXAMPLE\n\n\n\n\n\n\nposition\n\n\nThe position to insert the tracks, a zero-based index\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage\n \n\n\n\n\n\n\n\nAddPlaylistTrack\n\n\nAUTH REQUIRED\n\n\n\n\nAdd one or more tracks to a user\u2019s playlist.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nuserId\n\n\nThe user's Spotify user ID.\n\n\nEXAMPLE\n\n\n\n\n\n\nplaylistId\n\n\nThe Spotify ID for the playlist.\n\n\nEXAMPLE\n\n\n\n\n\n\nuri\n\n\nA Spotify Track URI\n\n\nEXAMPLE\n\n\n\n\n\n\nposition\n\n\nThe position to insert the tracks, a zero-based index\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage\n \n\n\n\n\n\n\n\nReorderPlaylist\n\n\nAUTH REQUIRED\n\n\n\n\nReorder a track or a group of tracks in a playlist.\n\n\n\n\nParamters\n \n\n\n\n\n\n\n\n\nName\n\n\nDescription\n\n\nExample\n\n\n\n\n\n\n\n\n\n\nuserId\n\n\nThe user's Spotify user ID.\n\n\nEXAMPLE\n\n\n\n\n\n\nplaylistId\n\n\nThe Spotify ID for the playlist.\n\n\nEXAMPLE\n\n\n\n\n\n\nrangeStart\n\n\nThe position of the first track to be reordered.\n\n\nEXAMPLE\n\n\n\n\n\n\ninsertBefore\n\n\nThe position where the tracks should be inserted.\n\n\nEXAMPLE\n\n\n\n\n\n\nrangeLength\n\n\nThe amount of tracks to be reordered. Defaults to 1 if not set.\n\n\nEXAMPLE\n\n\n\n\n\n\nsnapshotId\n\n\nThe playlist's snapshot ID against which you want to make the changes.\n\n\nEXAMPLE\n\n\n\n\n\n\n\n\nReturns a \nPublic User Model\n\n\nUsage", + "title": "- Playlists" + }, + { + "location": "/SpotifyWebApi/playlists/#getuserplaylists", + "text": "AUTH REQUIRED Get a list of the playlists owned or followed by a Spotify user. Paramters Name Description Example userId The user's Spotify user ID. EXAMPLE limit The maximum number of playlists to return. Default: 20. Minimum: 1. Maximum: 50. EXAMPLE offset The index of the first playlist to return. Default: 0 (the first object) EXAMPLE Returns a Public User Model Usage", + "title": "GetUserPlaylists" + }, + { + "location": "/SpotifyWebApi/playlists/#getplaylist", + "text": "AUTH REQUIRED Get a playlist owned by a Spotify user. Paramters Name Description Example userId The user's Spotify user ID. EXAMPLE playlistId The Spotify ID for the playlist. EXAMPLE fields Filters for the query: a comma-separated list of the fields to return. If omitted, all fields are returned. EXAMPLE market An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking. EXAMPLE Returns a Public User Model Usage", + "title": "GetPlaylist" + }, + { + "location": "/SpotifyWebApi/playlists/#getplaylisttracks", + "text": "AUTH REQUIRED Get full details of the tracks of a playlist owned by a Spotify user. Paramters Name Description Example userId The user's Spotify user ID. EXAMPLE playlistId The Spotify ID for the playlist. EXAMPLE fields Filters for the query: a comma-separated list of the fields to return. If omitted, all fields are returned. EXAMPLE limit The maximum number of tracks to return. Default: 100. Minimum: 1. Maximum: 100. EXAMPLE offset The index of the first object to return. Default: 0 (i.e., the first object) EXAMPLE market An ISO 3166-1 alpha-2 country code. Provide this parameter if you want to apply Track Relinking. EXAMPLE Returns a Public User Model Usage", + "title": "GetPlaylistTracks" + }, + { + "location": "/SpotifyWebApi/playlists/#createplaylist", + "text": "AUTH REQUIRED Create a playlist for a Spotify user. (The playlist will be empty until you add tracks.) Paramters Name Description Example userId The user's Spotify user ID. EXAMPLE playlistName The name for the new playlist, for example \"Your Coolest Playlist\". This name does not need to be unique. EXAMPLE 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. EXAMPLE Returns a Public User Model Usage", + "title": "CreatePlaylist" + }, + { + "location": "/SpotifyWebApi/playlists/#updateplaylist", + "text": "AUTH REQUIRED Change a playlist\u2019s name and public/private state. (The user must, of course, own the playlist.) Paramters Name Description Example userId The user's Spotify user ID. EXAMPLE playlistId The Spotify ID for the playlist. EXAMPLE newName The new name for the playlist, for example \"My New Playlist Title\". EXAMPLE newPublic If true the playlist will be public, if false it will be private. EXAMPLE Returns a Public User Model Usage", + "title": "UpdatePlaylist" + }, + { + "location": "/SpotifyWebApi/playlists/#replaceplaylisttracks", + "text": "AUTH REQUIRED 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. Paramters Name Description Example userId The user's Spotify user ID. EXAMPLE playlistId The Spotify ID for the playlist. EXAMPLE uris A list of Spotify track URIs to set. A maximum of 100 tracks can be set in one request. EXAMPLE Returns a Public User Model Usage", + "title": "ReplacePlaylistTracks" + }, + { + "location": "/SpotifyWebApi/playlists/#removeplaylisttracks", + "text": "AUTH REQUIRED Remove one or more tracks from a user\u2019s playlist. Paramters Name Description Example userId The user's Spotify user ID. EXAMPLE playlistId The Spotify ID for the playlist. EXAMPLE 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 Returns a Public User Model Usage", + "title": "RemovePlaylistTracks" + }, + { + "location": "/SpotifyWebApi/playlists/#removeplaylisttrack", + "text": "AUTH REQUIRED Remove one or more tracks from a user\u2019s playlist. Paramters Name Description Example userId The user's Spotify user ID. EXAMPLE playlistId The Spotify ID for the playlist. EXAMPLE uri Spotify URI EXAMPLE Returns a Public User Model Usage", + "title": "RemovePlaylistTrack" + }, + { + "location": "/SpotifyWebApi/playlists/#addplaylisttracks", + "text": "AUTH REQUIRED Add one or more tracks to a user\u2019s playlist. Paramters Name Description Example userId The user's Spotify user ID. EXAMPLE playlistId The Spotify ID for the playlist. EXAMPLE uris A list of Spotify track URIs to add EXAMPLE position The position to insert the tracks, a zero-based index EXAMPLE Returns a Public User Model Usage", + "title": "AddPlaylistTracks" + }, + { + "location": "/SpotifyWebApi/playlists/#addplaylisttrack", + "text": "AUTH REQUIRED Add one or more tracks to a user\u2019s playlist. Paramters Name Description Example userId The user's Spotify user ID. EXAMPLE playlistId The Spotify ID for the playlist. EXAMPLE uri A Spotify Track URI EXAMPLE position The position to insert the tracks, a zero-based index EXAMPLE Returns a Public User Model Usage", + "title": "AddPlaylistTrack" + }, + { + "location": "/SpotifyWebApi/playlists/#reorderplaylist", + "text": "AUTH REQUIRED Reorder a track or a group of tracks in a playlist. Paramters Name Description Example userId The user's Spotify user ID. EXAMPLE playlistId The Spotify ID for the playlist. EXAMPLE rangeStart The position of the first track to be reordered. EXAMPLE insertBefore The position where the tracks should be inserted. EXAMPLE rangeLength The amount of tracks to be reordered. Defaults to 1 if not set. EXAMPLE snapshotId The playlist's snapshot ID against which you want to make the changes. EXAMPLE Returns a Public User Model Usage", + "title": "ReorderPlaylist" + }, { "location": "/SpotifyLocalApi/", "text": "WIP", diff --git a/sitemap.xml b/sitemap.xml index ee8138d0..eaa8b03c 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -4,7 +4,7 @@ None/ - 2015-07-09 + 2015-07-23 daily @@ -13,31 +13,61 @@ None/SpotifyWebApi/gettingstarted/ - 2015-07-09 + 2015-07-23 daily None/SpotifyWebApi/examples/ - 2015-07-09 + 2015-07-23 daily None/SpotifyWebApi/auth/ - 2015-07-09 + 2015-07-23 + daily + + + + None/SpotifyWebApi/search/ + 2015-07-23 daily None/SpotifyWebApi/albums/ - 2015-07-09 + 2015-07-23 daily None/SpotifyWebApi/artists/ - 2015-07-09 + 2015-07-23 + daily + + + + None/SpotifyWebApi/browse/ + 2015-07-23 + daily + + + + None/SpotifyWebApi/follow/ + 2015-07-23 + daily + + + + None/SpotifyWebApi/library/ + 2015-07-23 + daily + + + + None/SpotifyWebApi/playlists/ + 2015-07-23 daily @@ -47,7 +77,7 @@ None/SpotifyLocalApi/ - 2015-07-09 + 2015-07-23 daily