Discogs master release
GET https://api.api.sh/discogs/v1/master
A master release (the album across all its versions): title, artists, year, genres, styles, main and most recent release ids, items for sale and lowest price, tracklist and videos.
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 |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/discogs/v1/master?id=42473" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/discogs/v1/master",
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");
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)
{"id": 42473,"title": "From The Muddy Banks Of The Wishkah","artists": [{"name": "Nirvana","anv": "","join": "","role": "","tracks": "","id": 125246,"resource_url": "https://api.discogs.com/artists/125246","thumbnail_url": "https://i.discogs.com/OpnVfYmSBkHggQtUt8tZ0X4Q1B84EltALtW-5H9U7XU/rs:fit/g:sm/q:90/h:600/w:591/czM6Ly9kaXNjb2dz/LWRhdGFiYXNlLWlt/YWdlcy9BLTE…"}],"year": 1996,"genres": ["Rock"],"styles": ["Grunge"],"main_release": 367273,"most_recent_release": 37677405,"num_for_sale": 797,"lowest_price": 0.85,"tracklist": [{"position": "1","type_": "track","title": "Intro","duration": "0:52"},{"position": "2","type_": "track","title": "School","duration": "2:40"},"… 15 more"],"videos": [{"uri": "https://www.youtube.com/watch?v=ZZq2phHrpqI","title": "Intro (Live At London Astoria, UK, December 3, 1989)","description": "Provided to YouTube by Universal Music Group\n\nIntro (Live At London Astoria, UK, December 3, 1989) · Nirvana\n\nFrom The Muddy Banks Of The Wi…","duration": 53,"embed": true},{"uri": "https://www.youtube.com/watch?v=Ju1guyt3IW0","title": "School (Live In Amsterdam, Netherlands/1991)","description": "Provided to YouTube by Universal Music Group\n\nSchool (Live In Amsterdam, Netherlands/1991) · Nirvana\n\nFrom The Muddy Banks Of The Wishkah\n\n℗…","duration": 161,"embed": true},"… 28 more"],"data_quality": "Correct","url": "https://www.discogs.com/master/42473-Nirvana-From-The-Muddy-Banks-Of-The-Wishkah","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.