The artist call is used to retrieve artist data.
page (integer): Which page of the resultset to view.
perPage (integer): How many results per page should be returned.
ids (string): Filter artists by a list of numeric ids.
id (integer): Alias for ids.
facets (array): Which facets to apply to the artist catalog call.
returnFacets (string): Which facets to return for possible later filtering.
sortBy (string): What field to sort the resultset by. The sort parameter takes a field name and a direction (ASC or DESC). It is possible to sort on these fields:
- publishDate (the last time this artist published content on Beatport)
Get arbitrary artists:
GET /catalog/3/artists
Get the first page with 5 artists per page:
GET /catalog/3/artists?perPage=5&page=1
Get the first page with 5 artists per page, sorted by publish date (the last time that the artist published content on Beatport) and then artist id, having tracks that are in the “House” genre:
GET /catalog/3/artists?sortBy=publishDate desc,artistId desc&genreId=5&perPage=5&page=1
Get arbitrary artists with filter metadata for all genre names and artist names:
GET /catalog/3/artists?returnFacets=genreName,performerName
Get all artists that have both “Trance” tracks and “Progressive House” tracks.
GET /catalog/3/artists?facets[]=genreName:Trance&facets[]=genreName:Progressive+House