🍷 WineVoyager API
The structured database of Italian wine denominations
Il database strutturato delle denominazioni vinicole italiane
WineVoyager is a clean, structured, machine-readable database of Italian controlled-origin wine denominations. Every piece of information comes directly from the official production regulations (disciplinari) published by MASAF — the Italian Ministry of Agriculture, Food Sovereignty and Forests.
Where the official sources are dense PDF documents scattered across government archives, WineVoyager turns them into a single, consistent, queryable format that both people and software can actually use.
The value isn't just the data — it's the structure. Each denomination has been read, interpreted, and encoded into a rigorously validated schema, so that "what grapes are allowed in Taurasi" becomes a one-line question instead of an afternoon of reading legal documents.
Right now the database covers all 79 Italian DOCG denominations — the highest tier of Italian wine classification. DOC denominations are coming soon, expanding coverage to the full landscape of Italian appellations.
For each denomination you'll find:
The API is free to use for basic data. No signup, no key required.
List all denominations:
curl https://api.winevoyager.tours/v1/denominations
Get a single denomination:
curl https://api.winevoyager.tours/v1/denominations/taurasi-docg
Filter by region:
curl "https://api.winevoyager.tours/v1/denominations?region=Campania"
Filter by colour:
curl "https://api.winevoyager.tours/v1/denominations?color=red"
{
"id": "taurasi-docg",
"name": "Taurasi",
"classification": "DOCG",
"regions": ["Campania"],
"provinces": ["Avellino"],
"recognition_year": 1993,
"colors": ["red"]
}
The full response — including wine types and grape compositions — is available with a Standard access key.
| Free | Standard | |
|---|---|---|
| Denomination basics | ✅ | ✅ |
| Regions & provinces | ✅ | ✅ |
| Colours & recognition year | ✅ | ✅ |
| Wine types | — | ✅ |
| Grape varieties & percentages | — | ✅ |
| Production methods | — | ✅ |
| Price | Free | Contact us |
To request a Standard access key, just get in touch.
Full interactive API documentation is available at:
Every denomination is a hand-authored file, validated against a strict JSON Schema before publication. A malformed or incomplete record never reaches production — the build process refuses it. This is what guarantees that the data you consume is consistent, predictable, and safe to build on.
The denomination data is derived from public MASAF sources and released under CC-BY-NC-SA 4.0. Attribution required: "Source: WineVoyager API".
WineVoyager è un database pulito, strutturato e leggibile dalle macchine delle denominazioni vinicole italiane a origine controllata. Ogni informazione proviene direttamente dai disciplinari di produzione ufficiali pubblicati dal MASAF — il Ministero dell'Agricoltura, della Sovranità Alimentare e delle Foreste.
Dove le fonti ufficiali sono densi documenti PDF sparsi negli archivi ministeriali, WineVoyager li trasforma in un unico formato coerente e interrogabile, realmente utilizzabile sia dalle persone che dai software.
Il valore non è solo il dato — è la struttura. Ogni denominazione è stata letta, interpretata e codificata in uno schema rigorosamente validato, così che "quali vitigni sono ammessi nel Taurasi" diventa una domanda da una riga invece di un pomeriggio passato a leggere documenti legali.
Al momento il database copre tutte le 79 denominazioni DOCG italiane — il livello più alto della classificazione vinicola italiana. Le denominazioni DOC arriveranno presto, estendendo la copertura all'intero panorama delle denominazioni italiane.
Per ogni denominazione troverai:
L'API è gratuita per i dati di base. Nessuna registrazione, nessuna chiave richiesta.
Elenca tutte le denominazioni:
curl https://api.winevoyager.tours/v1/denominations
Ottieni una singola denominazione:
curl https://api.winevoyager.tours/v1/denominations/taurasi-docg
Filtra per regione:
curl "https://api.winevoyager.tours/v1/denominations?region=Campania"
Filtra per colore:
curl "https://api.winevoyager.tours/v1/denominations?color=red"
{
"id": "taurasi-docg",
"name": "Taurasi",
"classification": "DOCG",
"regions": ["Campania"],
"provinces": ["Avellino"],
"recognition_year": 1993,
"colors": ["red"]
}
La risposta completa — comprese le tipologie di vino e la composizione dei vitigni — è disponibile con una chiave di accesso Standard.
| Free | Standard | |
|---|---|---|
| Dati anagrafici denominazione | ✅ | ✅ |
| Regioni e province | ✅ | ✅ |
| Colori e anno di riconoscimento | ✅ | ✅ |
| Tipologie di vino | — | ✅ |
| Vitigni e percentuali | — | ✅ |
| Metodi di produzione | — | ✅ |
| Prezzo | Gratis | Contattaci |
Per richiedere una chiave di accesso Standard, scrivici.
La documentazione API interattiva completa è disponibile su:
Ogni denominazione è un file redatto a mano, validato contro un rigoroso JSON Schema prima della pubblicazione. Un record malformato o incompleto non raggiunge mai la produzione — il processo di build lo rifiuta. È questo che garantisce che i dati che consumi siano coerenti, prevedibili e sicuri su cui costruire.
I dati delle denominazioni sono derivati da fonti pubbliche MASAF e rilasciati con licenza CC-BY-NC-SA 4.0. Attribuzione richiesta: "Fonte: WineVoyager API".
Made with ❤️ and 🍷 in Italy