Arricchisci il tuo progetto con l'API vinicola di grapeminds
Funzionalità dell'API vinicola
Accedi ai nostri dati sui vini
Accedi a vini, regioni, vitigni, produttori e altro ancora attraverso la nostra API completa.
Endpoint ben documentati
I nostri endpoint API sono accuratamente documentati per garantire una facile integrazione e utilizzo.
Sistema in crescita
grapeminds diventa più grande e migliore ogni giorno, così come la nostra API.
Costi fissi
Accedi alla nostra API gratis per 14 giorni, poi per 101,49 € / mese - tutto il resto è incluso.*
Hai o stai pianificando un progetto nel campo del vino e hai bisogno di dati e informazioni su vini, vitigni, regioni o produttori?
L'API vinicola di grapeminds ti dà accesso a migliaia di vini - in modo rapido e conveniente.
Documentazione API
Avvio rapido
L'API grapeminds ti permette di integrare i dati sui vini nelle tue applicazioni.
- 1. Registrati e crea una chiave API
- 2. Includi la tua chiave API nell'header Authorization
- 3. Effettua richieste all'API
URL base e autenticazione
https://grapeminds.eu/api/public/v1
Tutte le richieste richiedono autenticazione:
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://grapeminds.eu/api/public/v1/wines/wines
Elenca tutti i vini con paginazione e filtri
Parametri Query:
page- Numero di pagina (predefinito: 1)per_page- Elementi per pagina (predefinito: 15, max: 100)color- Filtra per colore (rosso, bianco, rosato)sub_type- Filtra per tipo (fermo, spumante)producer_id- Filtra per ID produttoreregion_id- Filtra per ID regione
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://grapeminds.eu/api/public/v1/wines?color=red&per_page=20"/wines/search
Cerca vini per nome o produttore
Parametri Query:
q- Query di ricerca (min 3 caratteri, obbligatorio)limit- Risultati massimi (predefinito: 20, max: 100)
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://grapeminds.eu/api/public/v1/wines/search?q=Tignanello"/wines/{id}
Ottieni informazioni dettagliate sul vino
Headers:
Accept-Language- Codice lingua (de, en, fr, it)
curl -H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept-Language: de" \
"https://grapeminds.eu/api/public/v1/wines/9146"Risposta di esempio:
{
"id": 9146,
"display_name": "Antinori, Tignanello Toscana IGT",
"color": "red",
"type": "wine",
"sub_type": "still",
"producer": { "id": 1771, "name": "Antinori" },
"region": { "id": 210, "name": "Toscana", "country": "it" },
"grapes": [
{ "id": 33141, "name": "Sangiovese" },
{ "id": 33142, "name": "Cabernet Sauvignon" }
],
"description": {
"text": "Tignanello ist ein erstklassiger Supertuscan...",
"text_long": "Tignanello, ein Meisterwerk des Weinguts Antinori...",
"language": "de"
},
"tasting_notes": {
"text": "Tiefrot mit Aromen von dunklen Beeren...",
"language": "de"
},
"pairing": {
"text": "Passt zu Lammkeulen, Rinderschmorbraten...",
"language": "de"
},
"flavor_profile": {
"sweetness": 2, "acidity": 6, "tannins": 7,
"alcohol": 8, "body": 8, "finish": 8
}
}/producers
Elenca tutti i produttori con paginazione
Parametri Query:
search- Cerca per nome (min 2 caratteri)per_page- Elementi per pagina (predefinito: 15, max: 100)
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://grapeminds.eu/api/public/v1/producers?search=Antinori"/producers/{id}
Ottieni dettagli produttore con vini opzionali
Parametri Query:
include_wines- Includi vini (boolean, predefinito: false)
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://grapeminds.eu/api/public/v1/producers/1771?include_wines=1"/regions
Elenca tutte le regioni con paginazione
Parametri Query:
country- Filtra per codice paesesearch- Cerca per nome
Headers:
Accept-Language- Lingua per i nomi delle regioni
curl -H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept-Language: de" \
"https://grapeminds.eu/api/public/v1/regions?country=FR"/regions/{id}
Ottieni dettagli regione con vini opzionali
Parametri Query:
include_wines- Includi vini (boolean)
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://grapeminds.eu/api/public/v1/regions/210?include_wines=1"/region-insights/{regionId}
Ottieni informazioni dettagliate su una regione vinicola
Parametri Query:
lang- Codice lingua (de, en, fr, it)
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://grapeminds.eu/api/public/v1/region-insights/210?lang=de"Risposta di esempio:
{
"region_id": 210,
"lang": "de",
"summary": "Die Toskana ist eine der bekanntesten Weinregionen...",
"climate_and_terroir": "Mediterranes Klima mit heißen Sommern...",
"signature_styles": [
"Chianti (Sangiovese-betont)",
"Brunello di Montalcino",
"Super Tuscans"
],
"key_grapes": [
{ "id": 157, "name": "Sangiovese" },
{ "id": 41, "name": "Cabernet Sauvignon" }
]
}/grapes
Elenca tutti i vitigni
Parametri Query:
search- Cerca per nomeper_page- Elementi per pagina
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://grapeminds.eu/api/public/v1/grapes?search=Sangiovese"/grapes/{id}
Ottieni dettagli del vitigno
curl -H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept-Language: de" \
"https://grapeminds.eu/api/public/v1/grapes/157"/drinking-periods/{wineId}
Ottieni la finestra di bevibilità ottimale per un vino
Parametri Query:
lang- Codice lingua (de, en, fr, it)
curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://grapeminds.eu/api/public/v1/drinking-periods/9146?lang=de"Risposta di esempio:
{
"wine_id": 9146,
"lang": "de",
"from": 5,
"to": 20,
"statement": "Der Tignanello besitzt Struktur für lange Lagerung...",
"young": "Jung zeigt der Tignanello lebendige Aromen...",
"ripe": "Reif präsentiert der Tignanello raffinierte Noten...",
"storage": "Bei 12-15°C dunkel lagern."
}
💡 Comprensione della finestra di consumo:
I valori 'from' e 'to' indicano anni dopo l'annata. Per un'annata 2020 con from=5 e to=20: bevibilità ottimale dal 2025 al 2040.
*Disponibile solo per i clienti Enterprise.
Riconoscimento etichette di vino con IA. Carica una foto di un'etichetta di bottiglia di vino e ricevi i vini corrispondenti dal database grapeminds.
/photo/analyze
Analizza una foto dell'etichetta del vino e trova i vini corrispondenti
Corpo della richiesta (JSON):
photo* - Immagine codificata in Base64 (con o senza prefisso data:image)max_results- Candidati max. per etichetta (predefinito: 10, max: 50)
curl -X POST \
-H "Authorization: Bearer YOUR_ENTERPRISE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"photo": "data:image/jpeg;base64,/9j/4AAQ...", "max_results": 5}' \
"https://grapeminds.eu/api/public/v1/photo/analyze"Risposta di esempio:
{
"message": "ok",
"detected_labels": [
{
"producer_name": "Antinori",
"wine_name": "Tignanello",
"vintage": 2019,
"color": "red",
"region_name": "Toscana",
"country": "IT"
}
],
"candidates": [
{
"id": 9146,
"display_name": "Antinori, Tignanello Toscana IGT",
"color": "red",
"type": "wine",
"sub_type": "still",
"producer": {
"id": 1771,
"name": "Antinori"
},
"region": {
"id": 210,
"name": "Toscana",
"country": "it"
}
}
]
}Nessuna etichetta rilevata:
{
"message": "no_label_detected",
"detected_labels": [],
"candidates": []
}Etichetta rilevata, nessuna corrispondenza nel database:
{
"message": "ok",
"detected_labels": [
{
"producer_name": "Unknown Winery",
"wine_name": "Rare Wine",
"vintage": 2020,
"color": "red",
"region_name": "Unknown Region",
"country": "XX"
}
],
"candidates": []
}💡 Suggerimento: Per ottenere i migliori risultati, assicurarsi che l'etichetta del vino sia chiaramente visibile e ben illuminata. L'API utilizza l'IA per estrarre il nome del produttore, il nome del vino, l'annata e la regione dall'etichetta.
Inizia con l'API pubblica di grapeminds
Registrati per creare un account, leggi la documentazione, genera la tua chiave API, prova gratuitamente per 14 giorni e inizia subito a utilizzare l'API pubblica grapeminds Wine.