Package de.sonallux.spotify.api.apis

Class ArtistsApi

java.lang.Object

de.sonallux.spotify.api.apis.ArtistsApi

public class ArtistsApi
extends Object

Artists API

Constructor Summary

Constructors

Constructor	Description
ArtistsApi()

Method Summary

Modifier and Type	Method	Description
GetArtistRequest	getArtist(String id)	Get an Artist
GetArtistsAlbumsRequest	getArtistsAlbums(String id)	Get an Artist's Albums
GetArtistsRelatedArtistsRequest	getArtistsRelatedArtists(String id)	Get an Artist's Related Artists
GetArtistsTopTracksRequest	getArtistsTopTracks(String id, String market)	Get an Artist's Top Tracks
GetMultipleArtistsRequest	getMultipleArtists(String ids)	Get Multiple Artists

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ArtistsApi

public ArtistsApi()

Method Detail

getArtist

public GetArtistRequest getArtist(String id)

Get an Artist

Get Spotify catalog information for a single artist identified by their unique Spotify ID.

Parameters:

id -

The Spotify ID of the artist.

Returns:

a GetArtistRequest object to build and execute the request

getArtistsAlbums

public GetArtistsAlbumsRequest getArtistsAlbums(String id)

Get an Artist's Albums

Get Spotify catalog information about an artist's albums.

Parameters:

id -

The Spotify ID for the artist.

Returns:

a GetArtistsAlbumsRequest object to build and execute the request

getArtistsRelatedArtists

public GetArtistsRelatedArtistsRequest getArtistsRelatedArtists(String id)

Get an Artist's Related Artists

Get Spotify catalog information about artists similar to a given artist. Similarity is based on analysis of the Spotify community's listening history.

Parameters:

id -

The Spotify ID for the artist

Returns:

a GetArtistsRelatedArtistsRequest object to build and execute the request

getArtistsTopTracks

public GetArtistsTopTracksRequest getArtistsTopTracks(String id,
                                                      String market)

Get an Artist's Top Tracks

Get Spotify catalog information about an artist's top tracks by country.

Parameters:

id -

The Spotify ID for the artist

market -

An ISO 3166-1 alpha-2 country code or the string from_token. Synonym for country.

Returns:

a GetArtistsTopTracksRequest object to build and execute the request

getMultipleArtists

public GetMultipleArtistsRequest getMultipleArtists(String ids)

Get Multiple Artists

Get Spotify catalog information for several artists based on their Spotify IDs.

Parameters:

ids -

A comma-separated list of the Spotify IDs for the artists. Maximum: 50 IDs.

Returns:

a GetMultipleArtistsRequest object to build and execute the request