Indice degli endpoint

Tutti gli endpoint API a colpo d'occhio. Ogni endpoint richiede autenticazione tramite Bearer token.

URL base: https://grapeminds.eu/api/public/v1

Endpoint Vini

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": "...", "language": "de" },
  "tasting_notes": { "text": "...", "language": "de" },
  "pairing": { "text": "...", "language": "de" },
  "flavor_profile": {
    "sweetness": 2, "acidity": 6, "tannins": 7,
    "alcohol": 8, "body": 8, "finish": 8
  }
}

Endpoint Produttori

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)
GET /producers/{id}

Ottieni dettagli produttore con vini opzionali

Parametri Query:

  • include_wines — Includi vini (boolean, predefinito: false)

Endpoint Regioni

GET /regions

Elenca tutte le regioni con paginazione

Parametri Query:

  • country — Filtra per codice paese
  • search — Cerca per nome
GET /regions/{id}

Ottieni dettagli regione con vini opzionali

GET /region-insights/{regionId}

Ottieni informazioni dettagliate su una regione vinicola

Endpoint Vitigni

GET /grapes

Elenca tutti i vitigni

GET /grapes/{id}

Ottieni dettagli del vitigno

Endpoint Periodo di bevibilità

GET /drinking-periods/{wineId}

Ottieni la finestra di bevibilità ottimale per un vino

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.

Analisi foto (Enterprise)

*Disponibile solo per i clienti Enterprise.

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

Strumenti per sviluppatori

Collezione Postman

Scarica la collezione Postman pronta per l'importazione con tutti gli endpoint.

Integrazione IA & LLM

Documentazione leggibile dalle macchine per assistenti IA (wine-api-llms.txt).

Pronti per iniziare?

Provate l'API Vini grapeminds gratuitamente per 14 giorni.

Registrati come cliente API