Discogs API endpoint
Returns a Discogs release: artists, labels, formats, tracklist, credits, identifiers, videos, images, and community want/have/rating.
/discogs/release/{id}Path parameters:
id (required) — Discogs release id.Response includes artists[], artists_sort, labels[], companies[], formats[], format_quantity, tracklist[] (each entry may carry its own extra_artists[]), extra_artists[], identifiers[], videos[], images[], community (have, want, rating.count, rating.average), master_id, data_quality, uri, source_url.
| Field | Filled in, of 17 checked | Values in the sample |
|---|---|---|
| uri | 17 | youtube.com |
| title | 17 | “Rick Astley - Never Gonna Give You Up (Official Video) (4K…” and 16 other values |
| description | 14 | median 255 characters |
| duration | 16 | 213 to 560, median 387 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| id (path) | string | Yes | Discogs release id | 249504 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/discogs/release/249504" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"id": 249504,
"title": "Never Gonna Give You Up",
"status": "Accepted",
"year": 1987,
"released": "1987-07-00",
"released_formatted": "Jul 1987",
"country": "UK",
"genres": [
"Electronic",
"Pop"
],
"styles": [
"Euro-Disco"
],
"artists": [
{
"id": 72872,
"name": "Rick Astley"
}
],
"artists_sort": "Rick Astley",
"labels": [
{
"id": 895,
"name": "RCA",
"catno": "PB 41447"
}
],
"formats": [
{
"name": "Vinyl",
"qty": "1",
"descriptions": [
"7\"",
"45 RPM",
"Single",
"Stereo"
]
}
],
"format_quantity": 1,
"tracklist": [
{
"position": "A",
"type": "track",
"title": "Never Gonna Give You Up",
"duration": "3:32"
},
{
"position": "B",
"type": "track",
"title": "Never Gonna Give You Up (Instrumental)",
"duration": "3:30"
}
],
"community": {
"have": 4062,
"want": 580,
"rating": {
"count": 233,
"average": 3.84
}
},
"master_id": 96559,
"data_quality": "Correct",
"uri": "https://www.discogs.com/release/249504-Rick-Astley-Never-Gonna-Give-You-Up",
"source_url": "https://api.discogs.com/releases/249504"
}
}Request schema
No body schema
Response schema
#/definitions/discogs.releaseResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | discogs.ReleaseResponse | No | ||||
| data.artists | array | No | ||||
| data.artists[].anv | string | No | T. Bangalter | |||
| data.artists[].id | integer | No | ||||
| data.artists[].join | string | No | ||||
| data.artists[].name | string | No | ||||
| data.artists[].role | string | No | Vocals | |||
| data.artists[].tracks | string | No | ||||
| data.artists_sort | string | No | Rick Astley | |||
| data.community | discogs.Community | No | ||||
| data.community.have | integer | No | ||||
| data.community.rating | discogs.CommunityRating | No | ||||
| data.community.rating.average | number | No | ||||
| data.community.rating.count | integer | No | ||||
| data.community.want | integer | No | ||||
| data.companies | array | No | ||||
| data.companies[].catno | string | No | ||||
| data.companies[].entity_type | string | No | ||||
| data.companies[].entity_type_name | string | No | Pressed By | |||
| data.companies[].id | integer | No | ||||
| data.companies[].name | string | No | ||||
| data.country | string | No | UK | |||
| data.data_quality | string | No | ||||
| data.extra_artists | array | No | ||||
| data.extra_artists[].anv | string | No | T. Bangalter | |||
| data.extra_artists[].id | integer | No | ||||
| data.extra_artists[].join | string | No | ||||
| data.extra_artists[].name | string | No | ||||
| data.extra_artists[].role | string | No | Vocals | |||
| data.extra_artists[].tracks | string | No | ||||
| data.format_quantity | integer | No | ||||
| data.formats | array | No | ||||
| data.formats[].descriptions | array | No | LP,Album | |||
| data.formats[].name | string | No | Vinyl | |||
| data.formats[].qty | string | No | 2 | |||
| data.formats[].text | string | No | ||||
| data.genres | array | No | Electronic,Pop | |||
| data.id | integer | No | 249504 | |||
| data.identifiers | array | No | ||||
| data.identifiers[].description | string | No | ||||
| data.identifiers[].type | string | No | Barcode | |||
| data.identifiers[].value | string | No | ||||
| data.images | array | No | ||||
| data.images[].height | integer | No | Height of the image in pixels. | |||
| data.images[].type | string | No | primary | Kind of image, for example `primary`. | ||
| data.images[].uri | string | No | URL of the full-size image. | |||
| data.images[].uri150 | string | No | URL of a 150 pixel version of the image. | |||
| data.images[].width | integer | No | Width of the image in pixels. | |||
| data.labels | array | No | ||||
| data.labels[].catno | string | No | ||||
| data.labels[].id | integer | No | ||||
| data.labels[].name | string | No | ||||
| data.master_id | integer | No | ||||
| data.notes | string | No | ||||
| data.released | string | No | 1987-07-00 | |||
| data.released_formatted | string | No | Jul 1987 | |||
| data.source_url | string | No | ||||
| data.status | string | No | Accepted | |||
| data.styles | array | No | Euro-Disco | |||
| data.title | string | No | Never Gonna Give You Up | |||
| data.tracklist | array | No | ||||
| data.tracklist[].duration | string | No | 3:32 | |||
| data.tracklist[].extra_artists | array | No | ||||
| data.tracklist[].extra_artists[].anv | string | No | T. Bangalter | |||
| data.tracklist[].extra_artists[].id | integer | No | ||||
| data.tracklist[].extra_artists[].join | string | No | ||||
| data.tracklist[].extra_artists[].name | string | No | ||||
| data.tracklist[].extra_artists[].role | string | No | Vocals | |||
| data.tracklist[].extra_artists[].tracks | string | No | ||||
| data.tracklist[].position | string | No | A1 | |||
| data.tracklist[].title | string | No | ||||
| data.tracklist[].type | string | No | track | |||
| data.uri | string | No | ||||
| data.videos | array | No | ||||
| data.videos[].description | string | No | ||||
| data.videos[].duration | integer | No | 322 | |||
| data.videos[].title | string | No | ||||
| data.videos[].uri | string | No | ||||
| data.year | integer | No | 1987 | |||
| 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/release/249504" \
-H "x-api-key: $CRAWLORA_API_KEY"