35+
Totaal velden in API
Beschikbaar via GET /releases/{id} — meer dan eerder geïnventariseerd.
18
Aanbevolen op te slaan
Nuttig voor Spacejunkie: catalogus, zoeken, conditie, marketplace data.
2
Endpoints nodig
/database/search (zoeken) + /releases/{id} (detail ophalen).
Hoe de API werkt: Je doet altijd 2 calls. Eerst
/database/search?barcode=xxx of ?artist=xxx&release_title=xxx om een lijst van matches te krijgen (inclusief id). Dan /releases/{id} voor het volledige veldenoverzicht hieronder. De search-resultaten bevatten maar ±12 velden; het detail-endpoint bevat alles.
1 — Identiteit & Referenties
Release basis Unieke sleutels om een plaat te identificeren en koppelen| API-veld | Type | Omschrijving | Voorbeeld | Opslaan? |
|---|---|---|---|---|
id |
integer | Uniek Discogs release ID — essentieel als sleutel | 249504 | |
master_id |
integer | ID van de "master release" — groepeert alle versies van hetzelfde album wereldwijd | 96559 | |
master_url |
string | Link naar master release API endpoint | …/masters/96559 | |
uri |
string | Publieke Discogs pagina URL — handig als deeplink naar Discogs.com | discogs.com/release/249504 | |
status |
string | Database status: "Accepted" = goedgekeurd door Discogs community | Accepted |
2 — Artiest, Titel & Jaar
Core metadata Primaire catalogusgegevens die je toont in de shop| API-veld | Type | Omschrijving | Voorbeeld | Opslaan? |
|---|---|---|---|---|
title |
string | Album/release titel | Never Gonna Give You Up | |
artists[].name |
array | Artiestennaam. Meerdere artiesten mogelijk (splits op join-veld) | Rick Astley | |
artists[].id |
integer | Discogs artiest-ID — bruikbaar voor "meer van deze artiest" query | 72872 | |
artists[].anv |
string | Alternate Name Variation — naam zoals op de plaat staat (kan afwijken) | Stock / Aitken / Waterman | |
artists_sort |
string | Gesorteerde artiestennaam (bijv. "Beatles, The") — ideaal voor alfabetische sortering | Astley, Rick | |
year |
integer | Uitgavejaar (kan 0 zijn als onbekend) | 1987 | |
released |
string | Exacte releasedatum — LET OP: kan "1987-07-00" zijn (dag=00), sla op als tekst! | 1987-07-00 | |
released_formatted |
string | Leesbare datum — veilig om te tonen, altijd tekst | Jul 1987 | |
country |
string | Land van uitgave — belangrijk voor verzamelaars | UK |
3 — Label, Catalogusnummer & Formaat
Persingsgegevens| API-veld | Type | Omschrijving | Voorbeeld | Opslaan? |
|---|---|---|---|---|
labels[].name |
array | Labelnaam — neem de eerste uit de array | RCA | |
labels[].catno |
string | Catalogusnummer op het label — cruciaal voor identificatie | PB 41447 | |
labels[].id |
integer | Discogs label-ID | 895 | |
formats[].name |
string | Formaatnaam: "Vinyl", "CD", "Cassette" etc. | Vinyl | |
formats[].qty |
string | Aantal discs — "2" voor dubbel-LP, "1" normaal | 1 | |
formats[].descriptions |
array | Specificaties: ["LP", "Album", "Gatefold", "180g"] — erg waardevol voor shop! | ["7\"","45 RPM","Single"] | |
formats[].text |
string | Vrije tekst bij formaat: "Green Vinyl", "Promo" etc. | Green Vinyl | |
format_quantity |
integer | Totaal aantal discs (sneller dan formats[].qty parsen) | 1 |
4 — Barcodes & Identifiers
Scanbare codes Meerdere typen — filter op type "Barcode"| API-veld | Type | Omschrijving | Voorbeeld | Opslaan? |
|---|---|---|---|---|
identifiers[].type |
string | Type: "Barcode", "Matrix / Runout", "Label Code", "Price Code" etc. | Barcode | |
identifiers[].value |
string | De barcode waarde zelf — filter op type="Barcode" | 5012394144777 | |
identifiers → Matrix/Runout |
string | Gegraveerde matrixcodes op vinyl — voor echtheidsbepaling door verzamelaars | PB 41447 A‡ |
5 — Genres, Stijlen & Notities
Filtering & discovery Essentieel voor shopfilters en zoekfunctie| API-veld | Type | Omschrijving | Voorbeeld | Opslaan? |
|---|---|---|---|---|
genres |
array | Hoofdgenres — gebruik voor shop-filters ("Rock", "Jazz", "Electronic") | ["Electronic","Pop"] | |
styles |
array | Sub-genres — specifieker dan genres, ideaal voor gevorderde filtering | ["Euro-Disco"] | |
notes |
string | Redactionele notities: persingsvariant info, kleur vinyl etc. — goud voor de shop! | UK Release has black label… | |
data_quality |
string | Kwaliteit van data: "Correct", "Needs Vote", "Entirely Incorrect" | Needs Vote |
6 — Afbeeldingen
Visueel Signed URLs — verlopen na verloop van tijd, niet opslaan als permanent!
Belangrijk: Discogs afbeeldings-URLs zijn gesigned en verlopen. Sla de hoge resolutie URL op als tijdelijke staging waarde, maar upload uiteindelijk naar eigen opslag (bijv. Supabase Storage of Cloudflare R2) voor de shop.
| API-veld | Type | Omschrijving | Voorbeeld | Opslaan? |
|---|---|---|---|---|
images[0].uri |
string | Hoge resolutie voorkant (primary image) — tot 600×600px | i.discogs.com/…jpeg | |
images[0].uri150 |
string | Thumbnail 150×150px — voor lijstweergave in shop/Airtable | i.discogs.com/…jpeg | |
images[].type |
string | "primary" (voorkant) of "secondary" (achterkant, labels, binnenhoezen) | primary / secondary | |
thumb |
string | Directe thumbnail URL — zelfde als images[0].uri150 maar makkelijker bereikbaar | i.discogs.com/…jpeg |
7 — Tracklist & Extra Artiesten
Inhoud| API-veld | Type | Omschrijving | Voorbeeld | Opslaan? |
|---|---|---|---|---|
tracklist[].position |
string | Tracknummer: A, B, A1, B2 etc. | A | |
tracklist[].title |
string | Tracktitel — mooi voor de productpagina in de shop | Never Gonna Give You Up | |
tracklist[].duration |
string | Speelduur track | 3:32 | |
extraartists[].name |
string | Producent, engineer, mixer etc. — verrijkt de productpagina | Stock Aitken Waterman | |
extraartists[].role |
string | Rol: "Producer", "Engineer", "Written-By", "Mixed By" | Producer, Written-By |
8 — Marketplace & Community Data
Prijsreferentie Handig voor prijssuggesties en populariteit| API-veld | Type | Omschrijving | Voorbeeld | Opslaan? |
|---|---|---|---|---|
lowest_price |
float | Laagste huidige vraagprijs op Discogs Marketplace — referentie voor pricing! | 0.60 | |
num_for_sale |
integer | Aantal exemplaren momenteel te koop — marktschaarste indicator | 104 | |
community.have |
integer | Hoeveel gebruikers deze plaat in hun collectie hebben | 3999 | |
community.want |
integer | Hoeveel gebruikers deze plaat op hun wantlist hebben — populariteit! | 574 | |
community.rating.average |
float | Gemiddelde community beoordeling (1–5) | 3.82 | |
community.rating.count |
integer | Aantal beoordelingen | 228 | |
estimated_weight |
integer | Geschat gewicht in gram — nuttig voor verzendkosten berekening! | 230 |
9 — Datums & Overige Velden
Housekeeping| API-veld | Type | Omschrijving | Voorbeeld | Opslaan? |
|---|---|---|---|---|
date_added |
datetime | Wanneer de release aan Discogs DB toegevoegd werd | 2004-04-30T08:10:05 | |
date_changed |
datetime | Laatste wijzigingsdatum in Discogs database | 2022-08-03T03:03:28 | |
blocked_from_sale |
boolean | Of de release geblokkeerd is van Discogs Marketplace | false | |
videos[].uri |
array | YouTube links — kan leuk zijn op productpagina (let op relevantie!) | youtube.com/watch?v=… |
✦ Aanbeveling — Minimale & Uitgebreide Veldkeuze
Actieplan
MVP-set (verplicht):
Aanraders extra (fase 2):
Kritieke technische noot:
id, title, artists[].name, year, country, labels[].name, labels[].catno, formats[].name, identifiers→barcode, thumb, images[0].uri
Aanraders extra (fase 2):
genres, styles, notes, formats[].descriptions, released_formatted, artists_sort, lowest_price, estimated_weight, tracklist
Kritieke technische noot:
released kan "1987-07-00" zijn — altijd als tekst opslaan, nooit als Date in Airtable! (Al eerder een probleem geweest.)