artist-methods: Artist API Methods

In bkkkk/lastfmr: Work with Last.FM using R

Artist API Methods

Description

These endpoints return information about artists. Identifying artists can be done either using the artist name or a MusicBrainzID. If both artist and mbid are provided, the artist name is used by default.

• raw_artist_search() - Search for an artist by name.

• raw_artist_get_info() - Retrieve information about an artist exactly by name or MBID.

• raw_artist_get_similar() - Search for artists which are similar to a given artist.

• raw_artist_get_tags() - Get the tags applied by an individual user to an artist on Last.fm.

• raw_artist_get_top_albums() and raw_artist_get_top_tracks() - Get the top albums and tracks for an artist on Last.fm respectively.

Usage

raw_artist_search(artist, .start_page = 1, .n_pages = NULL)

raw_artist_get_info(
  artist = NULL,
  mbid = NULL,
  autocorrect = TRUE,
  username = NULL,
  lang = NULL
)

raw_artist_get_similar(artist = NULL, mbid = NULL, autocorrect = TRUE)

raw_artist_get_tags(
  artist = NULL,
  mbid = NULL,
  autocorrect = TRUE,
  username = NULL
)

raw_artist_get_top_albums(
  artist = NULL,
  mbid = NULL,
  autocorrect = TRUE,
  .start_page = 1,
  .n_pages = NULL
)

raw_artist_get_top_tracks(
  artist = NULL,
  mbid = NULL,
  autocorrect = TRUE,
  .start_page = 1,
  .n_pages = NULL
)

Arguments

artist	Artist name as a string.
.start_page	The page to start pulling from, by default starts from the 1st page
.n_pages	The total number of pages to pull. If no value is provided, all pages are retrieved.
mbid	MusicBrainzID as a string, this is optional unless the artist is not provided.
autocorrect	(Optional) Whether to correct the artist/album/track name names provided in the response. Defaults to TRUE if not provided.
username	(Optional) If provided, the playcount of the artist by the user is included in the response
lang	(Optional) The biography language.

Value

• raw_artist_search(), raw_artist_get_top_albums(), and raw_artist_get_top_tracks() return a list of lastfm object.

• raw_artist_get_info(), raw_artist_get_similar(), and raw_artist_get_tags() return a single lastfm object.

Language Setting

Biographies for albums and artists are returned in English by default. To get the biography in other languages, provide a ISO 639-1 country code via the lang argument of supporting functions.

Name Autocorrection

Endpoints that take artist/track/album names try to auto-correct misspelled names in the search query. This behaviour can be overriden by calling the function with argument autocorrect set to FALSE.

bkkkk/lastfmr documentation built on Sept. 4, 2022, 7:03 a.m.