Discogs API endpoint
Returns the releases and masters credited to a Discogs artist, identified by the required `id`. Paged with `page` (default 1) and `per_page` (default 50, max 100). Each entry has its `id`, `type` (`release` or `master`), title, artist, role, format, label, year, thumbnail, and want and collection counts, alongside the total item count and page count.
/discogs/artist/{id}/releasesReturns an artist's paginated release/master credits (role, format, label, year, want/collection counts). Rate-limited to 25 requests/min per IP.
Path parameters:
id (required) — Discogs artist id.Query parameters:
page (optional, default 1).per_page (optional, default 50, max 100).Response includes page, pages, per_page, items (total across all pages), and releases[]. Each release entry has id, type (release or master), main_release_id (set when type is master), title, artist, role, format, label, year, thumb, in_wantlist, in_collection. Use id with GET /discogs/release/{id} or GET /discogs/master/{id} (matching type) for full detail.
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| type | 20 | master (13), release (7) |
| title | 20 | “I Surrender (To The Spirit Of The Night) / Never Gonna Give…” and 18 other values |
| artist | 20 | Rick Astley (13), Samantha Fox / Rick Astley (1), Eurythmics / Rick Astley (1) and 5 more |
| role | 20 | Main in all 20 |
| format | 7 | “7", Jukebox” and 5 other values |
| label | 7 | “Jive, RCA” and 4 other values |
| year | 20 | 1,987 to 1,989, median 1,987 |
| in_wantlist | 20 | 2 to 520, median 51 |
| in_collection | 20 | 2 to 3,258, median 461 |
| main_release_id | 13 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | Discogs artist id | 1289 | |
| page | integer | No | 1-based page number, default 1 | ||
| per_page | integer | No | Results per page, default 50, max 100 | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/discogs/artist/1289/releases?page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"artist_id": "72872",
"page": 1,
"pages": 933,
"per_page": 3,
"items": 2799,
"releases": [
{
"id": 3686862,
"type": "release",
"title": "I Surrender (To The Spirit Of The Night) / Never Gonna Give You Up",
"artist": "Samantha Fox / Rick Astley",
"role": "Main",
"format": "7\", Jukebox",
"label": "Jive, RCA",
"year": 1987,
"in_wantlist": 27,
"in_collection": 48
},
{
"id": 96554,
"type": "master",
"main_release_id": 742394,
"title": "It Would Take A Strong Strong Man",
"artist": "Rick Astley",
"role": "Main",
"year": 1987,
"in_wantlist": 35,
"in_collection": 447
}
],
"source_url": "https://api.discogs.com/artists/72872/releases?page=1&per_page=3"
}
}Request schema
No body schema
Response schema
#/definitions/discogs.artistReleasesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | discogs.ArtistReleasesResponse | No | ||||
| data.artist_id | string | No | ||||
| data.items | integer | No | ||||
| data.page | integer | No | ||||
| data.pages | integer | No | ||||
| data.per_page | integer | No | ||||
| data.releases | array | No | ||||
| data.releases[].artist | string | No | ||||
| data.releases[].format | string | No | ||||
| data.releases[].id | integer | No | ||||
| data.releases[].in_collection | integer | No | ||||
| data.releases[].in_wantlist | integer | No | ||||
| data.releases[].label | string | No | ||||
| data.releases[].main_release_id | integer | No | ||||
| data.releases[].role | string | No | Main | |||
| data.releases[].thumb | string | No | ||||
| data.releases[].title | string | No | ||||
| data.releases[].type | string | No | release | |||
| data.releases[].year | integer | No | ||||
| data.source_url | string | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/discogs/artist/1289/releases?page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"