Discogs release
GET https://api.api.sh/discogs/v1/release
One release: title, artists, year, release date, country, labels with catalog numbers, formats, genres, styles, master id, the full tracklist with per-track credits, credits, identifiers (barcodes, matrix numbers), companies, notes, community stats (have, want, rating), the average rating and the marketplace's items for sale and lowest price in the chosen currency.
Every response includes credits_used: the credits this call cost.
Part of the Discogs API: 13 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
idrequired | string | Release id or a discogs.com/release/<id> link. Example: 249504 |
currency | USD | GBP | EUR | CAD | AUD | JPY | CHF | MXN | BRL | NZD | SEK | ZAR | Currency of the marketplace prices (default USD). |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/discogs/v1/release?id=249504" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/discogs/v1/release",
params={"id": "249504"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/discogs/v1/release");
url.searchParams.set("id", "249504");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"id": 249504,"title": "Never Gonna Give You Up","artists": [{"id": 72872,"name": "Rick Astley","anv": null,"join": null,"role": null}],"year": 1987,"released": "1987-07-00","country": "UK","status": "Accepted","labels": [{"id": 895,"name": "RCA","catno": "PB 41447"}],"formats": [{"name": "Vinyl","qty": "1","descriptions": ["7\"","45 RPM","… 2 more"]}],"genres": ["Electronic","Pop"],"styles": ["Euro-Disco"],"master_id": 96559,"tracklist": [{"position": "A","type": "track","title": "Never Gonna Give You Up","duration": "3:32","artists": null,"extraartists": null},{"position": "B","type": "track","title": "Never Gonna Give You Up (Instrumental)","duration": "3:30","artists": null,"extraartists": null}],"credits": [{"name": "Me Company","anv": "Me Co","join": "","role": "Design","tracks": "","id": 547352,"resource_url": "https://api.discogs.com/artists/547352"},{"name": "Mark McGuire","anv": "","join": "","role": "Engineer","tracks": "","id": 78275,"resource_url": "https://api.discogs.com/artists/78275"},"… 4 more"],"identifiers": [{"type": "Barcode","value": "5012394144777"},{"type": "Label Code","value": "LC 0316"},"… 11 more"],"companies": [{"name": "BMG Records (UK) Ltd.","catno": "","entity_type": "13","entity_type_name": "Phonographic Copyright (p)","id": 82835,"resource_url": "https://api.discogs.com/labels/82835","thumbnail_url": "https://i.discogs.com/aLAGfAWEPyoZq1-xZ3e1jec6bhXwBFl8f5FDyKid2ss/rs:fit/g:sm/q:90/h:80/w:173/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9MLTgy…"},{"name": "BMG Records (UK) Ltd.","catno": "","entity_type": "14","entity_type_name": "Copyright (c)","id": 82835,"resource_url": "https://api.discogs.com/labels/82835","thumbnail_url": "https://i.discogs.com/aLAGfAWEPyoZq1-xZ3e1jec6bhXwBFl8f5FDyKid2ss/rs:fit/g:sm/q:90/h:80/w:173/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9MLTgy…"},"… 9 more"],"notes": "UK Release has a black label with the text \"Manufactured In England\" printed on it.\n\nSleeve:\n℗ 1987 • BMG Records (UK) Ltd. © 1987 • BMG Rec…","community": {"have": 4166,"want": 596,"rating": {"count": 250,"average": 3.88},"submitter": {"username": "memory","resource_url": "https://api.discogs.com/users/memory"},"contributors": [{"username": "memory","resource_url": "https://api.discogs.com/users/memory"},{"username": "vargind","resource_url": "https://api.discogs.com/users/vargind"},"… 12 more"],"data_quality": "Correct","status": "Accepted"},"rating": {"count": 250,"average": 3.88},"marketplace": {"currency": "USD","num_for_sale": 125,"lowest_price": 0.68,"blocked_from_sale": false},"url": "https://www.discogs.com/release/249504-Rick-Astley-Never-Gonna-Give-You-Up","cached": false,"credits_used": 1}The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.