Skip to content
Tonkku edited this page Jul 30, 2022 · 1 revision

Browse artists

GET /artists

Browse and search artists.

Query String Params

Field Type Default Description
limit? integer 100 Amount of artists to return (max 100)
offset? integer 0 Amount of artists to skip
search? string N/A The search terms

Response

Field Type Description
Artists object Object with the results
Artists.Data array of artist objects The results of the query
Artists.Limit integer The limit used
Artists.Offset integer The offset used
Artists.Total integer The total amount of results for the search

Get artist

GET /artist/{Artist.URI}

Gets a specific artist with the uri slug.

Response

An artist object

Get artist photo

GET /artist/{Artist.URI}/photo

Redirects to the original full resolution and quality artist photo.
For resizing and different image formats, see CDX

Get artist releases

GET /artist/{Artist.URI}/releases

Gets releases featuring the artist.

Query String Params

Field Type Default Description
limit? integer 50 Amount of releases to return (max 50)
offset? integer 0 Amount of releases to skip

Response

Field Type Description
Releases object Object with the results
Releases.Data array of release objects The results of the query
Releases.Limit integer The limit used
Releases.Offset integer The offset used
Releases.Total integer The total amount of results for the search

Get latest artists

GET /latest-artists

Browse artists who have released recently.

Query String Params

Field Type Default Description
limit? integer 100 Amount of artists to return (max 100)
offset? integer 0 Amount of artists to skip

Response

Field Type Description
LatestArtists object Object with the results
LatestArtists.Data array of artist objects The results of the query
LatestArtists.Limit integer The limit used
LatestArtists.Offset integer The offset used
LatestArtists.Total integer The total amount of results for the search
Clone this wiki locally