Skip to main content
GET
List artists

Query Parameters

q
string

Keyword search across artist names and aliases.

letter
string

First letter of the name, for A-Z browsing.

role
string

Role slug. Repeat or comma-separate to require every selected role.

genre
string

Genre slug. Repeat or comma-separate to accept any selected genre.

status
string

Claim status filter.

band
boolean

True for groups only, false for individuals only.

has_album
boolean

True for artists with public albums, false for artists without them. Uses explicit album artists, or primary track artists when no explicit artists exist.

gender
enum<string>

Restrict to individuals with this gender. Missing gender counts as undisclosed. Groups never match. Legacy m/f aliases are accepted.

Available options:
male,
female,
undisclosed
sort
enum<string>

Sort column. Defaults to album_count when has_album=true, otherwise relevance. relevance ranks search matches first and falls back to total_songs without q. Other columns ignore search relevance.

Available options:
relevance,
name,
total_songs,
album_count
order
enum<string>

Sort direction.

Available options:
asc,
desc
limit
integer
default:20
Required range: 1 <= x <= 80
offset
integer
default:0
Required range: x >= 0

Response

A page of artists.

data
object[]
required
meta
object
required