Artists

API #

Implementation to make API calls with.

Parameters:

access_flow (AuthorizationCodeFlow | ClientCredentialsFlow) –

Access flow to use for api requests.

get_artist #

get_artist(artist_id: str) -> Artist

Get Spotify catalog information for a single artist.

Parameters:

artist_id (str) –

The ID of the artist.

Returns:

Artist –

The requested artist.

get_several_artists #

get_several_artists(artist_ids: list[str]) -> list[Artist]

Get Spotify catalog information for several artists.

Parameters:

artist_ids (list[str]) –

The IDs of the artists.

Returns:

list[Artist] –

The requested artists.

get_artists_albums #

get_artists_albums(artist_id: str, *, include_groups: MissingOr[list[AlbumGroup]] = MISSING, limit: MissingOr[int] = MISSING, offset: MissingOr[int] = MISSING, market: MissingOr[str] = MISSING) -> Paginator[ArtistAlbum]

Get Spotify catalog information about an artist's albums.

Parameters:

artist_id (str) –

The ID of the artist.
include_groups (list[AlbumGroup], default: all album types ) –

Used to filter the type of items returned. If not specified, all album types_ will be returned.
limit (int, default: 20 ) –

The maximum number of items to return. Default: 20. Minimum: 1. Maximum: 50.
offset (int, default: 0 ) –

The index of the first item to return. Default: 0 (the first item).
market (str, default: MISSING ) –

Only get content available in that market. Must be an ISO 3166-1 alpha-2 country code.

Returns:

Paginator[ArtistAlbum] –

A paginator who's items are a list of albums.

get_artists_top_tracks #

get_artists_top_tracks(artist_id: str, *, market: MissingOr[str] = MISSING) -> list[TrackWithSimpleArtist]

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

Parameters:

artist_id (str) –

The ID of the artist.
market (str, default: MISSING ) –

Only get content available in that market. Must be an ISO 3166-1 alpha-2 country code.

Returns:

list[TrackWithSimpleArtist] –

The requested tracks.

get_artists_related_artists #

get_artists_related_artists(artist_id: str) -> list[Artist]

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

Parameters:

artist_id (str) –

The ID of the artist.

Returns:

list[Artist] –

The requested artists.

SimpleArtist #

A simplified artist.

external_urls #

external_urls: ExternalURLs

Known external URLs for the artist.

href #

href: str

A link to the Web API endpoint providing full details of the artist.

id #

id: str

The Spotify ID for the artist.

name #

name: str

The name of the artist.

uri #

uri: str

The Spotify URI for the artist.

Artist #

An artist.

external_urls #

external_urls: ExternalURLs

Known external URLs for the artist.

href #

href: str

A link to the Web API endpoint providing full details of the artist.

id #

id: str

The Spotify ID for the artist.

name #

name: str

The name of the artist.

uri #

uri: str

The Spotify URI for the artist.

followers #

followers: Followers

Information about the followers of the artist.

genres #

genres: list[str]

A list of the genres the artist is associated with. If not yet classified, the list is empty.

images #

images: list[Image]

Images of the artist in various sizes, widest first.

popularity #

popularity: int

The popularity of the artist. The value will be between 0 and 100, with 100 being the most popular. The artist's popularity is calculated from the popularity of all the artist's tracks.