List songs

Published songs, newest first by default. Supports the same filters as the site's browse page.

Query Parameters

q?string

Keyword search across title and credited artists.

genre?string

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

role?string

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

artist_id?integer

Restrict to songs credited to this artist.

label_id?integer

Restrict to songs released on this label.

sort?string

Sort column.

order?string

Sort direction.

Value in

"asc"
"desc"

limit?integer

Page size.

Range1 <= value <= 80

Default20

offset?integer

Zero-based row offset.

Range0 <= value

Default0

Response Body

`application/json`

curl -X GET "https://example.com/v1/songs"

{  "data": [    {      "id": -9007199254740991,      "title": "string",      "slug": "string",      "released_at": "string",      "artwork_url": "string",      "artwork_source": "Custom",      "youtube_video_id": "string",      "youtube_video_url": "string",      "artists": [        {          "id": -9007199254740991,          "name": "string"        }      ]    }  ],  "meta": {    "total": -9007199254740991,    "limit": -9007199254740991,    "offset": -9007199254740991  }}

Query Parameters

Response Body

200application/json

400application/json

`application/json`

`application/json`