Discogs master versions
GET https://api.api.sh/discogs/v1/master/versions
Every version (pressing, reissue, format) of a master release, with format, label, catalog number, country, release date and community have/want counts, plus the filter values and counts the site offers. Filter by format, label, year or country; sort by release date, title, format, label, catalog number or country. Pass next_page back as page; null on the last page.
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 | Master id or a discogs.com/master/<id> link. Example: 42473 |
format | string | e.g. Vinyl, CD. |
label | string | Label. |
released | string | Release year. |
country | string | Country. |
sort | released | title | format | label | catno | country | Sort field. |
order | asc | desc | Sort order. |
limit | integer | Results per page (1-100, default 50). |
page | integer | Page number (1-based). |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/discogs/v1/master/versions?id=42473" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/discogs/v1/master/versions",
params={"id": "42473"},
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/master/versions");
url.searchParams.set("id", "42473");
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)
{"master_id": 42473,"filters": {"applied": {},"available": {"format": {"Album": 174,"CD": 90,"Cassette": 68,"Reissue": 47,"Unofficial Release": 38,"Stereo": 15,"LP": 14,"Vinyl": 14,"Club Edition": 13,"Limited Edition": 12,"Promo": 10,"Repress": 5,"CDr": 3,"All Media": 2,"Numbered": 2,"Remastered": 2,"Advance": 1,"CD-ROM": 1,"Compilation": 1,"DVD": 1,"DVD-Video": 1,"Etched": 1,"File": 1,"MP3": 1,"Misprint": 1,"NTSC": 1,"Partially Unofficial": 1,"Picture Disc": 1,"Single Sided": 1,"Special Edition": 1,"Test Pressing": 1},"label": {"Geffen Records": 98,"Geffen Records, Inc.": 89,"The Reading Festival": 79,"Dgc": 47,"Paramount Theatre, Seattle": 46,"Del Mar Fairgrounds": 44,"Civic Center, Springfield": 42,"London Astoria": 42,"Pier 48": 42,"Seattle Center Arena": 42,"Gateway Mastering": 41,"Great Western Forum": 40,"Teatro Castello, Roma": 40,"Paradiso Amsterdam": 39,"Emi Virgin Songs, Inc.": 35,"The End Of Music": 34,"Uni Distribution Corp.": 27,"Bmg": 15,"Westwood One": 12,"Stereoral": 8,"Bmg Australia Limited": 7,"Fujisankei Communications International Inc.": 7,"Mca Records": 7,"Columbia House": 6,"Mca Music Entertainment": 6,"Universal Music K.K.": 6,"Vpro": 6,"Universal": 5,"Vpro Tv Studio \"De Plantage\"": 5,"Bmg Direct": 4,"Cinram": 4,"Pt. Ris Music Wijaya International": 4,"Um³/Usm Japan": 4,"Universal International Music B.V.": 4,"Universal Music": 4,"Universal Music Llc": 4,"Bmg Ariola De Colombia S.A.": 3,"Dadc": 3,"Global Music": 3,"Mca Victor, Inc.": 3,"…": "129 more fields"},"country": {"US": 31,"Europe": 27,"Russia": 22,"Japan": 12,"Canada": 7,"Argentina": 6,"Indonesia": 5,"India": 4,"Italy": 4,"Mexico": 4,"Poland": 4,"South Korea": 4,"Ukraine": 4,"Unknown": 4,"Australia": 3,"Colombia": 3,"Belarus": 2,"Brazil": 2,"Bulgaria": 2,"China": 2,"Malaysia": 2,"South Africa": 2,"Spain": 2,"Taiwan": 2,"Thailand": 2,"UK": 2,"Algeria": 1,"Chile": 1,"Hungary": 1,"Israel": 1,"Philippines": 1,"Russia & CIS": 1,"Singapore": 1,"Singapore & Malaysia": 1,"Turkey": 1,"UK & US": 1,"Venezuela": 1,"Worldwide": 1},"released": {"1996": 92,"1997": 5,"1999": 3,"2000": 2,"2002": 1,"2003": 5,"2005": 2,"2006": 2,"2007": 2,"2009": 2,"2010": 1,"2011": 2,"2012": 2,"2015": 1,"2016": 3,"2021": 1,"2023": 1}}},"filter_facets": [{"title": "Format","id": "format","values": [{"title": "Album","value": "Album","count": 174},{"title": "CD","value": "CD","count": 90},"… 29 more"],"allows_multiple_values": true},{"title": "Label","id": "label","values": [{"title": "Geffen Records","value": "Geffen+Records","count": 98},{"title": "Geffen Records, Inc.","value": "Geffen+Records%2C+Inc.","count": 89},"… 167 more"],"allows_multiple_values": true},"… 2 more"],"page": 1,"per_page": 50,"total": 176,"total_pages": 4,"next_page": 2,"count": 50,"versions": [{"id": 6816327,"title": "From The Muddy Banks Of The Wishkah","format": "Album","major_formats": ["Cassette"],"label": "DGC","catno": "GEC 25105","country": "Hungary","released": "1996","status": "Accepted","stats": {"community": {"in_wantlist": 92,"in_collection": 14}},"url": "https://www.discogs.com/release/6816327"},{"id": 28375483,"title": "From The Muddy Banks Of The Wishkah","format": "Album, Stereo","major_formats": ["Cassette"],"label": "Geffen Records","catno": "GEFC-25105","country": "Argentina","released": "1996","status": "Accepted","stats": {"community": {"in_wantlist": 26,"in_collection": 3}},"url": "https://www.discogs.com/release/28375483"},"… 48 more"],"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.