Endpunkt-Übersicht

Alle verfügbaren API-Endpunkte auf einen Blick. Jeder Endpunkt erfordert Authentifizierung per Bearer Token.

Basis-URL: https://grapeminds.eu/api/public/v1

Wein-Endpoints

GET /wines

Alle Weine mit Paginierung und Filtern auflisten

Query-Parameter:

  • page — Seitennummer (Standard: 1)
  • per_page — Einträge pro Seite (Standard: 15, max: 100)
  • color — Nach Farbe filtern (rot, weiß, rosé)
  • sub_type — Nach Typ filtern (still, schäumend)
  • producer_id — Nach Produzenten-ID filtern
  • region_id — Nach Regions-ID filtern
curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://grapeminds.eu/api/public/v1/wines?color=red&per_page=20"
GET /wines/search

Weine nach Name oder Produzent suchen

Query-Parameter:

  • q — Suchanfrage (min. 3 Zeichen, erforderlich)
  • limit — Max. Ergebnisse (Standard: 20, max: 100)
curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://grapeminds.eu/api/public/v1/wines/search?q=Tignanello"
GET /wines/{id}

Detaillierte Weininformationen abrufen

Headers:

  • Accept-Language — Sprachcode (de, en, fr, it)
curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Accept-Language: de" \
     "https://grapeminds.eu/api/public/v1/wines/9146"

Beispiel-Antwort:

{
  "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
  }
}

Produzenten-Endpoints

GET /producers

Alle Produzenten mit Paginierung auflisten

Query-Parameter:

  • search — Nach Name suchen (min. 2 Zeichen)
  • per_page — Einträge pro Seite (Standard: 15, max: 100)
GET /producers/{id}

Produzentendetails mit optionalen Weinen abrufen

Query-Parameter:

  • include_wines — Weine einschließen (boolean, Standard: false)

Regions-Endpoints

GET /regions

Alle Regionen mit Paginierung auflisten

Query-Parameter:

  • country — Nach Ländercode filtern
  • search — Nach Name suchen
GET /regions/{id}

Regionendetails mit optionalen Weinen abrufen

GET /region-insights/{regionId}

Detaillierte Einblicke für eine Weinregion abrufen

Rebsorten-Endpunkte

GET /grapes

Alle Rebsorten auflisten

GET /grapes/{id}

Rebsortendetails abrufen

Trinkreife-Endpunkt

GET /drinking-periods/{wineId}

Optimales Trinkfenster für einen Wein abrufen

Erklärung des Trinkfensters: Die Werte 'from' und 'to' geben Jahre nach dem Jahrgang an. Für einen 2020er Jahrgang mit from=5 und to=20: optimaler Trinkzeitraum ist 2025-2040.

Fotoanalyse (Enterprise)

*Nur für Enterprise-Kunden verfügbar.

POST /photo/analyze

Analysiere ein Weinetikett-Foto und finde passende Weine

Request Body (JSON):

  • photo * — Base64-kodiertes Bild (mit oder ohne data:image-Präfix)
  • max_results — Max. Kandidaten pro Etikett (Standard: 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"

Entwickler-Tools

Postman Collection

Lade die importfertige Postman Collection mit allen Endpunkten herunter.

KI & LLM-Integration

Maschinenlesbare Dokumentation für KI-Assistenten (wine-api-llms.txt).

Bereit loszulegen?

Testen Sie die grapeminds Wine API 14 Tage kostenlos.

Als API Kunde registrieren