Discogs API endpoint
Lists the releases on a Discogs label, identified by the required label `id`. Paged with `page` (default 1) and `per_page` (default 50, max 100). Each entry has its release `id`, title, artist, format, catalogue number (`catno`), status, year and thumbnail, and the response reports the total item count across all pages.
/discogs/label/{id}/releasesReturns a label's paginated release catalog (title, artist, format, catalog number, year). Rate-limited to 25 requests/min per IP.
Path parameters:
id (required) — Discogs label 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, title, artist, format, catno, status, year, thumb. Use id with GET /discogs/release/{id} for full detail (tracklist, credits, and the Discogs page URI).
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| title | 20 | “Rollercoaster” and 15 other values |
| artist | 20 | “Grid*” and 12 other values |
| format | 20 | “CD, Single, Car” and 10 other values |
| catno | 20 | “74321230772” and 15 other values |
| status | 20 | Accepted in all 20 |
| year | 20 | 1,978 to 2,001, median 1,990 |
| thumb | 20 | i.discogs.com |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | Discogs label id | 895 | |
| 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/label/895/releases?page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"label_id": "895",
"page": 1,
"pages": 62128,
"per_page": 3,
"items": 186383,
"releases": [
{
"id": 34785,
"title": "Rollercoaster",
"artist": "Grid*",
"format": "CD, Single, Car",
"catno": "74321230772",
"status": "Accepted",
"year": 1994
}
],
"source_url": "https://api.discogs.com/labels/895/releases?page=1&per_page=3"
}
}Request schema
No body schema
Response schema
#/definitions/discogs.labelReleasesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | discogs.LabelReleasesResponse | No | ||||
| data.items | integer | No | ||||
| data.label_id | string | 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[].catno | string | No | ||||
| data.releases[].format | string | No | ||||
| data.releases[].id | integer | No | ||||
| data.releases[].status | string | No | ||||
| data.releases[].thumb | string | No | ||||
| data.releases[].title | string | No | ||||
| 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/label/895/releases?page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"