Package de.jsone_studios.wrapper.spotify.services

Interface ArtistsSpotifyService

  • public interface ArtistsSpotifyService

    • Method Detail

      • getArtist

        @GET("artists/{id}")
retrofit2.Call<Artist> getArtist​(@Path("id")
                                 String artistId)
        Get Spotify catalog information for a single artist identified by their unique Spotify ID.
        Parameters:
        artistId - The Spotify ID for the artist.
        Returns:
        Requested artist information
        See Also:
        Get an Artist

      • getArtistAlbums

        @GET("artists/{id}/albums")
retrofit2.Call<Pager<Album>> getArtistAlbums​(@Path("id")
                                             String artistId)
        Get Spotify catalog information about an artist’s albums.
        Parameters:
        artistId - The Spotify ID for the artist.
        Returns:
        An array of simplified album objects wrapped in a paging object.
        See Also:
        Get an Artist's Albums

      • getArtistAlbums

        @GET("artists/{id}/albums")
retrofit2.Call<Pager<Album>> getArtistAlbums​(@Path("id")
                                             String artistId,
                                             @QueryMap
                                             Map<String,​Object> options)
        Get Spotify catalog information about an artist’s albums.
        Parameters:
        artistId - The Spotify ID for the artist.
        options - Optional parameters. For list of supported parameters see endpoint documentation
        Returns:
        An array of simplified album objects wrapped in a paging object.
        See Also:
        Get an Artist's Albums

      • getArtistTopTrack

        @GET("artists/{id}/top-tracks")
retrofit2.Call<Tracks> getArtistTopTrack​(@Path("id")
                                         String artistId,
                                         @Query("country")
                                         String country)
        Get Spotify catalog information about an artist’s top tracks by country.
        Parameters:
        artistId - The Spotify ID for the artist.
        country - The country: an ISO 3166-1 alpha-2 country code.
        Returns:
        An object whose key is "tracks" and whose value is an array of track objects.
        See Also:
        Get an Artist’s Top Tracks

      • getRelatedArtists

        @GET("artists/{id}/related-artists")
retrofit2.Call<Artists> getRelatedArtists​(@Path("id")
                                          String artistId)
        Get Spotify catalog information about artists similar to a given artist.
        Parameters:
        artistId - The Spotify ID for the artist.
        Returns:
        An object whose key is "artists" and whose value is an array of artist objects.
        See Also:
        Get an Artist’s Related Artists

      • getArtists

        @GET("artists")
retrofit2.Call<Artists> getArtists​(@Query("ids")
                                   String artistIds)
        Get Spotify catalog information for several artists based on their Spotify IDs.
        Parameters:
        artistIds - A comma-separated list of the Spotify IDs for the artists. Maximum: 50 IDs.
        Returns:
        An object whose key is "artists" and whose value is an array of artist objects.
        See Also:
        Get Several Artists