DiskografDocs
APIArtists

List an artist's songs

Published songs this artist is credited on, in any role. Returns 404 for an unknown artist rather than an empty page, so a mistyped id is distinguishable from an artist with no published credits.

GET
/v1/artists/{artistId}/songs

Path Parameters

artistId*integer

Query Parameters

q?string
genre?string
role?string
sort?string
order?string

Value in

  • "asc"
  • "desc"
limit?integer
Range1 <= value <= 80
Default20
offset?integer
Range0 <= value
Default0

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/artists/0/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  }}

Get an artist

Full profile including biography, links, associated acts, and per-role and per-genre credit counts.

Get namesake hints

For artists whose names collide, a short hint that tells them apart — the editor-supplied disambiguator when one exists, otherwise the artist's most-credited role and best-known song. Only returns rows for ids that actually collide.