Skip to main content
GET
List songs

Query Parameters

q
string

Keyword search across title and credited artists. Supports yt:"..." for a case-insensitive literal substring match in the cached YouTube title, channel name, and description.

genre
string

Genre slug. Repeat the parameter or comma-separate for several.

role
string

Role slug. Repeat the parameter or comma-separate for several.

gender
enum<string>

Match any primary credited individual artist. Missing gender counts as undisclosed; groups never match. Legacy m/f aliases are accepted.

Available options:
male,
female,
undisclosed
artist_id
integer

Restrict to songs credited to this artist.

label_id
integer

Restrict to songs released on this label.

released_from
string<date>

Inclusive release-date lower bound (yyyy-MM-dd).

released_to
string<date>

Inclusive release-date upper bound (yyyy-MM-dd).

has_artwork
boolean

Restrict to songs with square Spotify/Apple artwork.

sort
string

Sort column.

order
enum<string>

Sort direction.

Available options:
asc,
desc
limit
integer
default:20

Page size.

Required range: 1 <= x <= 80
offset
integer
default:0

Zero-based row offset.

Required range: x >= 0

Response

A page of songs.

data
object[]
required
meta
object
required