Exspotify.Artists (Exspotify v0.1.0)

View Source

Provides functions for interacting with the Artists endpoints of the Spotify Web API. See: https://developer.spotify.com/documentation/web-api/reference/artists

Note: The 'related artists' endpoint is deprecated and not included in this module.

Summary

Functions

Get Spotify catalog information for a single artist by their unique Spotify ID. https://developer.spotify.com/documentation/web-api/reference/get-artist

Get Spotify catalog information about an artist's top tracks by market. Returns a list of the artist's top tracks. https://developer.spotify.com/documentation/web-api/reference/get-an-artists-top-tracks

Get Spotify catalog information for several artists based on their Spotify IDs. https://developer.spotify.com/documentation/web-api/reference/get-several-artists

Functions

get_artist(artist_id, token)

@spec get_artist(String.t(), String.t()) ::
  {:ok, Exspotify.Structs.Artist.t()} | {:error, Exspotify.Error.t()}

Get Spotify catalog information for a single artist by their unique Spotify ID. https://developer.spotify.com/documentation/web-api/reference/get-artist

get_artist_albums(artist_id, token, opts \\ [])

@spec get_artist_albums(String.t(), String.t(), keyword()) ::
  {:ok, Exspotify.Structs.Paging.t()} | {:error, Exspotify.Error.t()}

Get Spotify catalog information about an artist's albums (paginated). https://developer.spotify.com/documentation/web-api/reference/get-an-artists-albums

get_artist_top_tracks(artist_id, token, market)

@spec get_artist_top_tracks(String.t(), String.t(), String.t()) ::
  {:ok, [Exspotify.Structs.Track.t()]} | {:error, Exspotify.Error.t()}

Get Spotify catalog information about an artist's top tracks by market. Returns a list of the artist's top tracks. https://developer.spotify.com/documentation/web-api/reference/get-an-artists-top-tracks

get_several_artists(artist_ids, token)

@spec get_several_artists([String.t()], String.t()) ::
  {:ok, [Exspotify.Structs.Artist.t()]} | {:error, Exspotify.Error.t()}

Get Spotify catalog information for several artists based on their Spotify IDs. https://developer.spotify.com/documentation/web-api/reference/get-several-artists