Bereichern Sie Ihr Projekt mit der grapeminds Wein-API
Wein-API-Funktionen
Zugriff auf unsere Weindaten
Greifen Sie über unsere umfassende API auf Weine, Regionen, Rebsorten, Produzenten und mehr zu.
Gut dokumentierte Endpunkte
Unsere API-Endpunkte sind ausführlich dokumentiert, um eine einfache Integration und Nutzung zu gewährleisten.
Wachsendes System
grapeminds wird jeden Tag größer und besser - und unsere API auch.
Fixe Kosten
Zugang zu unserer API 14 Tage kostenlos, danach für 99,00 € / Monat - alles andere ist inklusive.*
Haben Sie ein Projekt im Bereich Wein oder planen Sie eines und benötigen Daten und Informationen zu Weinen, Rebsorten, Regionen oder Produzenten?
Die grapeminds Wein-API gibt Ihnen Zugang zu Tausenden von Weinen - schnell und kostengünstig.
API-Dokumentation
Schnellstart
Die grapeminds API ermöglicht es Ihnen, Weindaten in Ihre Anwendungen zu integrieren.
- 1. Registrieren und einen API-Schlüssel erstellen
- 2. Fügen Sie Ihren API-Schlüssel im Authorization-Header ein
- 3. Stellen Sie Anfragen an die API
Basis-URL & Authentifizierung
https://grapeminds.eu/api/public/v1
Alle Anfragen erfordern Authentifizierung:
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://grapeminds.eu/api/public/v1/wines/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 filternregion_id- Nach Regions-ID filtern
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://grapeminds.eu/api/public/v1/wines?color=red&per_page=20"/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"/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": "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
Alle Produzenten mit Paginierung auflisten
Query-Parameter:
search- Nach Name suchen (min. 2 Zeichen)per_page- Einträge pro Seite (Standard: 15, max: 100)
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://grapeminds.eu/api/public/v1/producers?search=Antinori"/producers/{id}
Produzentendetails mit optionalen Weinen abrufen
Query-Parameter:
include_wines- Weine einschließen (boolean, Standard: false)
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://grapeminds.eu/api/public/v1/producers/1771?include_wines=1"/regions
Alle Regionen mit Paginierung auflisten
Query-Parameter:
country- Nach Ländercode filternsearch- Nach Name suchen
Headers:
Accept-Language- Sprache für Regionsnamen
curl -H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept-Language: de" \
"https://grapeminds.eu/api/public/v1/regions?country=FR"/regions/{id}
Regionendetails mit optionalen Weinen abrufen
Query-Parameter:
include_wines- Weine einschließen (boolean)
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://grapeminds.eu/api/public/v1/regions/210?include_wines=1"/region-insights/{regionId}
Detaillierte Einblicke für eine Weinregion abrufen
Query-Parameter:
lang- Sprachcode (de, en, fr, it)
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://grapeminds.eu/api/public/v1/region-insights/210?lang=de"Beispiel-Antwort:
{
"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
Alle Rebsorten auflisten
Query-Parameter:
search- Nach Name suchenper_page- Einträge pro Seite
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://grapeminds.eu/api/public/v1/grapes?search=Sangiovese"/grapes/{id}
Rebsortendetails abrufen
curl -H "Authorization: Bearer YOUR_API_KEY" \
-H "Accept-Language: de" \
"https://grapeminds.eu/api/public/v1/grapes/157"/drinking-periods/{wineId}
Optimales Trinkfenster für einen Wein abrufen
Query-Parameter:
lang- Sprachcode (de, en, fr, it)
curl -H "Authorization: Bearer YOUR_API_KEY" \ "https://grapeminds.eu/api/public/v1/drinking-periods/9146?lang=de"Beispiel-Antwort:
{
"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."
}
💡 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.
*Nur für Enterprise-Kunden verfügbar.
KI-gestützte Weinetikett-Erkennung. Laden Sie ein Foto eines Weinetiketts hoch und erhalten Sie passende Weine aus der grapeminds-Datenbank.
/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"Beispiel-Antwort:
{
"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"
}
}
]
}Kein Etikett erkannt:
{
"message": "no_label_detected",
"detected_labels": [],
"candidates": []
}Etikett erkannt, kein Datenbank-Treffer:
{
"message": "ok",
"detected_labels": [
{
"producer_name": "Unknown Winery",
"wine_name": "Rare Wine",
"vintage": 2020,
"color": "red",
"region_name": "Unknown Region",
"country": "XX"
}
],
"candidates": []
}💡 Tipp: Für beste Ergebnisse stellen Sie sicher, dass das Weinetikett gut sichtbar und beleuchtet ist. Die API nutzt KI, um Produzent, Weinname, Jahrgang und Region vom Etikett zu extrahieren.
Starten Sie mit der grapeminds public Wine API
Registrieren Sie sich für ein Konto, lesen Sie die Dokumentation, erstellen Sie Ihren API-Schlüssel, testen Sie 14 Tage kostenlos und nutzen Sie noch heute die öffentliche grapeminds-Wein-API.