Gestisci i tuoi vini in più cantine, traccia i movimenti di ogni bottiglia e ricevi un promemoria quando il vino sta per esaurirsi.

Database dei vini

Accedi a 266.363 vini di 44.373 produttori di 2.052 regioni, con descrizione e valutazione.

Gestisci i tuoi fornitori

Collega i tuoi vini ai tuoi commercianti, ottieni un elenco dei vini acquistati e riordina prima che si esauriscano.

Dati basati sull'IA

grapeminds utilizza dati basati sull'IA per fornirti tutte le informazioni di cui hai bisogno sui tuoi vini.

Prezzi

Integrazioni

Accedi Registrati

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 per 101,49 € / mese - tutto il resto è incluso.*

*101,49 € IVA 22% incl., 83,19 € netto

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

GET /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 produttore
region_id - Filtra per ID regione

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://grapeminds.eu/api/public/v1/wines?color=red&per_page=20"

GET /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"

GET /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
  }
}

GET /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"

GET /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"

GET /regions

Elenca tutte le regioni con paginazione

Parametri Query:

country - Filtra per codice paese
search - 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"

GET /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"

GET /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" }
  ]
}

GET /grapes

Elenca tutti i vitigni

Parametri Query:

search - Cerca per nome
per_page - Elementi per pagina

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://grapeminds.eu/api/public/v1/grapes?search=Sangiovese"

GET /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"

GET /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.

Stai pianificando un progetto aziendale?

I progetti più grandi richiedono soluzioni personalizzate, funzionalità avanzate e supporto per la gestione API complessa.
Raccontaci di più sul tuo progetto e sulle tue esigenze, ci piacerebbe conoscere la tua idea.
Contattaci

Inizia con l'API pubblica di grapeminds

Registrati per creare un account, leggi la documentazione, genera la tua chiave API e inizia subito a utilizzare l'API pubblica Grapeminds Wine.

Nome

Password

Conferma la password

Autorizzaci a contattarti via email, puoi annullare l'iscrizione in qualsiasi momento.

Selezionando questa opzione, accetti la nostra informativa sulla privacy, termini di servizio e i nostri Termini e condizioni per l'API pubblica.

Arricchisci il tuo progetto con l'API vinicola di grapeminds

Funzionalità dell'API vinicola

Accedi ai nostri dati sui vini

Endpoint ben documentati

Sistema in crescita

Costi fissi

Documentazione API

Avvio rapido

URL base e autenticazione

Endpoint Vini

Endpoint Produttori

Endpoint Regioni

Endpoint Vitigni

Endpoint Periodo di bevibilità

Stai pianificando un progetto aziendale?

Inizia con l'API pubblica di grapeminds