Read an artist's page
get_artistRetrieve an artist's discography from the Bide & Musique catalogue using an artist ID. Get every song with its year, plus the names they recorded under and catalogue notes.
Instructions
Read an artist's page on Bide & Musique: the names they recorded under, what the catalogue notes about them, and every song of theirs the collection holds, each with its year. Takes the 'artist_id' that search_songs, get_song and get_random_song return. An artist page is a way into a discography rather than a biography: half of them state nothing beyond the name, and the median artist has one record here. Fields the page does not state come back null or empty, which is the ordinary state of this catalogue rather than a failed read. The date of birth comes back exactly as written, since the catalogue states a full date, a bare year, or a date with a death beside it. Nationality is free text for the same reason. Rows come in the site's order, by year of release, never by importance. When you show an artist to a user, credit Bide & Musique and link the page.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum songs of the discography to return. | |
| artist_id | Yes | The artist id returned by search_songs, get_song or get_random_song, digits only, for example '290'. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | ||
| name | Yes | ||
| links | Yes | Addresses off the site, with the label the page gave them. | |
| notes | Yes | ||
| source | Yes | ||
| aliases | Yes | Other names this artist recorded under, as the page stacks them. | |
| surname | Yes | ||
| see_also | Yes | ||
| artist_id | Yes | ||
| photo_url | Yes | ||
| birth_date | Yes | Exactly as published, which may be a day, a bare year, a month and a year, or a date with a death beside it. Nothing here is parsed into a date. | |
| first_name | Yes | ||
| discography | Yes | ||
| nationality | Yes | As the catalogue writes it, in its own words: 'suisse', 'franco-espagnole'. | |
| presentation | Yes | ||
| songs_on_page | Yes | Songs the page held, before 'limit'. | |
| discography_count | Yes | Songs returned, after 'limit'. |