Skip to content
Wein & Speisen, berechnet.

Weinberatungs-Intelligenz
für Ihre Plattform

Beschreibe oder fotografiere, was auf dem Teller liegt, oder starte mit der Flasche, die du schon hast. SommelierX vergleicht strukturierte Geschmacksprofile und zeigt, was funktioniert — und warum.

Sie betreiben einen Onlineshop oder ein Restaurant? Dann brauchen Sie nicht die API, sondern das fertige Widget: Widget für Onlineshops ansehen.

Offene Eingabe
Gericht, Zutaten oder Foto
Gerankt
Score pro Ergebnis
Nachvollziehbar
Warum der Match funktioniert
In beide Richtungen
Vom Gericht zum Wein und zurück

So funktioniert es

Vier Schritte von der Anmeldung bis zum ersten Pairing-Ergebnis.

1

API-Schlüssel holen

Registrieren Sie sich auf developers.sommelierx.com, wählen Sie Starter oder Pro – Ihr API-Schlüssel funktioniert sofort. Monatlich kündbar.

2

Gericht senden

Senden Sie einen Gerichtnamen, Zutaten oder ein Foto an unseren Pairing-Endpoint. Wir akzeptieren JSON, Multipart oder reinen Text.

3

Wein-Matches erhalten

Sie erhalten gerankte Weinempfehlungen mit Match-Scores, Wine-DNA-Profilen, Verkostungsnotizen und Erklärungen zur Kombination.

4

Ihre Nutzer begeistern

Zeigen Sie die Ergebnisse mit unseren fertigen UI-Komponenten an oder bauen Sie mit den Rohdaten Ihr eigenes Erlebnis.

Für Entwickler gebaut

Alles, was Sie brauchen, um Weinwissen in Ihr Produkt zu integrieren.

🍷

Weinberatungs-Engine

Senden Sie ein beliebiges Gericht und erhalten Sie gerankte Weinempfehlungen mit Match-Scores von 0 bis 100. Angetrieben von unserem eigenen Wine-DNA-Algorithmus, in 17 Jahren mit Wissenschaftlern und professionellen Sommeliers entwickelt.

🧬

Wine-DNA-Profile

Arbeiten Sie mit allen 19 Weindimensionen und allen 17 Gerichtdimensionen. Zeigen Sie mit Radar- oder Balkendiagrammen oder einer eigenen Darstellung, warum ein Pairing funktioniert.

📷

Fotoerkennung

Senden Sie ein Foto eines Gerichts oder Weinetiketts. Unsere automatische Erkennung identifiziert Gericht oder Wein und liefert direkt passende Vorschläge. Basierend auf multimodalen Bildmodellen.

🔄

Umgekehrtes Pairing

Beginnen Sie mit einem Wein und finden Sie die passenden Gerichte. Ideal für Weinhändler, Restaurants bei der Menüplanung oder Apps, die beim Kochen zu einer bestimmten Flasche helfen.

🌐

Mehrsprachig

Niederländisch und Englisch sind jetzt verfügbar. Die API arbeitet mit Sprachcodes und ist darauf ausgelegt, weitere Sprachen ohne Änderung am Integrationsvertrag hinzuzufügen.

🔌

MCP-Server

Verbinden Sie SommelierX über unseren Model-Context-Protocol-Server mit jedem digitalen Assistenten. Claude, GPT und andere Assistenten können Weinempfehlungen direkt abfragen.

📑

OpenAPI-3.1-Spezifikation

Vollständige OpenAPI-3.1.0-Spezifikation verfügbar. Generieren Sie Client-SDKs automatisch in jeder Sprache. Interaktive Dokumentation über Scalar UI.

📈

Nutzungsanalyse

Verfolgen Sie API-Nutzung, beliebte Anfragen, Antwortzeiten und Fehlerquoten in Ihrem Entwickler-Dashboard. Richten Sie Warnungen für Kontingentgrenzen ein.

🔒

Sicherheit auf Unternehmensniveau

Authentifizierung per API-Schlüssel, Rate Limiting, konfigurierbares CORS und ausschließlich HTTPS, mit dokumentierten Sicherheitsmaßnahmen für Produktivintegrationen.

🖥
REST API
🤖
MCP Server
📄
OpenAPI
🌎
Webhooks
💻
SDKs

Schnellstart

Ihre erste Weinempfehlung in unter 5 Minuten. Kopieren, einfügen, ausführen.

# Get wine advice for a dish
curl "https://api.sommelierx.com/api/v1/pairings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dish": "Pasta Carbonara",
    "locale": "en",
    "limit": 5
  }'

# Response includes ranked wines with DNA profiles:
# {
#   "pairings": [
#     {
#       "wine": "Chardonnay (Burgundy)",
#       "score": 94,
#       "reason": "The creamy texture pairs beautifully...",
#       "dna": { "body": 0.85, "acidity": 0.6, ... }
#     }
#   ]
# }
// Install: npm install sommelierx
import { SommelierX } from 'sommelierx';

const sx = new SommelierX({
  apiKey: process.env.SOMMELIERX_API_KEY
});

// Get wine advice for a dish
const result = await sx.pair({
  dish: 'Grilled Salmon with Lemon',
  locale: 'en',
  limit: 5
});

// Access wine recommendations
result.pairings.forEach(p => {
  console.log(`${p.wine} - Score: ${p.score}`);
  console.log(`  Reason: ${p.reason}`);
  console.log(`  DNA:${JSON.stringify(p.dna)}`);
});

// Reverse pairing: find dishes for a wine
const dishes = await sx.reversePair({
  wine: 'Barolo',
  limit: 10
});
# Install: pip install sommelierx
import sommelierx

client = sommelierx.Client(
    api_key="YOUR_API_KEY"
)

# Get wine advice for a dish
result = client.pair(
    dish="Beef Bourguignon",
    locale="en",
    limit=5
)

# Access wine recommendations
for pairing in result.pairings:
    print(f"{pairing.wine} - Score: {pairing.score}")
    print(f"  Reason: {pairing.reason}")
    print(f"  DNA: {pairing.dna}")

# Photo recognition + pairing
with open("dish.jpg", "rb") as f:
    photo_result = client.pair_from_photo(
        image=f,
        locale="en"
    )
3
Zeilen bis zum ersten Pairing
REST + MCP
Integrationswege
OpenAPI 3.1
Vollständige Spezifikation
2 Min.
Bis zum ersten API-Aufruf

Einfache, planbare Preise

Ab 9 € pro Monat. Monatlich kündbar. Keine Überraschungen.

Starter
€ 9
/ Monat
  • 100 API-Aufrufe / Tag (ca. 3.000 / Monat)
  • Alle Pairing-Endpoints
  • Fotoerkennung
  • Umgekehrtes Pairing
  • Support per E-Mail
Jetzt starten
Enterprise
auf Anfrage
individuelle Preise
  • Ab 25.000 API-Aufrufen / Tag
  • Alles aus Pro
  • Individuelle Rate Limits
  • Individuelles SLA
  • Persönlicher Support
  • Individuelle Integrationen
Vertrieb kontaktieren

Alle Tarife enthalten HTTPS, Authentifizierung per API-Schlüssel und Rate Limiting. Mehr Aufrufe nötig? Kontaktieren Sie uns.

Für echte Produkte gebaut

Drei Wege, wie Teams SommelierX einsetzen.

Zeigen Sie zu jedem Gericht gerankte Weine mit nachvollziehbarem Match-Score.
Restaurant- und Bestellplattformen
Pairing im Moment der Entscheidung
Lassen Sie einen digitalen Assistenten über den MCP-Server spezialisierte Wein-Speisen-Berechnungen ausführen.
Teams, die Assistenten bauen
Strukturierte Werkzeuge statt losem Text
Verknüpfen Sie Gerichte mit dem eigenen Sortiment des Händlers und zeigen Sie nur Weine, die wirklich verfügbar sind.
Weinhandel und E-Commerce
Relevante Produktentdeckung

Häufige Fragen

Wine DNA ist unser eigener Matching-Algorithmus, in 17 Jahren mit Wissenschaftlern und professionellen Sommeliers entwickelt. Er beschreibt jeden Weinstil in 19 Weindimensionen und vergleicht ihn mit 17 Gerichtdimensionen. Es ist keine generische Empfehlungsmaschine – er beruht auf strukturierten Geschmacksdaten und Sommelier-Expertise.
Unser Algorithmus gleicht 609 Weinstile mit Gerichten ab – mit derselben Expertise, die professionelle Sommeliers anwenden. Die Bewertungsmatrix wurde von Fachleuten von Hand aufgebaut und verfeinert, nicht aus Bewertungen zusammengetragen. Match-Scores über 80 stehen für hervorragende Kombinationen.
Nein. Die Dokumentation, die OpenAPI-Spezifikation und die Werkzeugliste des MCP-Servers sind frei zugänglich, aber jeder Aufruf braucht einen Tarif. Starter kostet 9 € pro Monat (100 Aufrufe pro Tag), ist monatlich kündbar und liefert dieselben vollständigen Daten wie Pro; Pro (29 €) enthält 30.000 Aufrufe pro Monat und berechnet darüber 0,02 € pro Aufruf. Sie haben einen Onlineshop? Dann brauchen Sie das Widget, nicht die API.
Ja. Alle kostenpflichtigen Tarife (Starter, Pro, Enterprise) erlauben die kommerzielle Nutzung. Sie dürfen Pairing-Ergebnisse, Wine-DNA-Daten und Verkostungsnotizen in Ihrer eigenen Anwendung anzeigen. Eine Nennung von SommelierX freut uns, ist bei kostenpflichtigen Tarifen aber nicht vorgeschrieben.
MCP (Model Context Protocol) ist ein Standard, mit dem digitale Assistenten wie Claude externe APIs aufrufen können. Über unseren MCP-Server kann jeder MCP-kompatible Assistent Weinempfehlungen direkt abfragen. So bauen Sie digitale Sommeliers, Chatbots und Empfehlungssysteme ohne eigenen Integrationscode.
Wir stellen eine vollständige OpenAPI-3.1.0-Spezifikation bereit, mit der Sie Client-SDKs für jede Sprache automatisch erzeugen können, etwa mit openapi-generator. Offizielle SDKs für JavaScript und Python stehen auf unserer Roadmap. Bis dahin funktioniert die REST-API mit jedem HTTP-Client.
Alle Antworten sind JSON. Pairing-Ergebnisse enthalten Weinidentität, Match-Score und eine Erklärung der Kombination. Wine DNA ist über einen eigenen Endpoint verfügbar; erweiterte Score-Aufschlüsselungen hängen vom API-Tarif ab. Fehler haben eine einheitliche Struktur mit Status, Code, Meldung und Details.
Rate Limits gelten pro API-Schlüssel und werden täglich um Mitternacht UTC zurückgesetzt. Nähern Sie sich dem Limit, liefert die API Header mit Ihrem verbleibenden Kontingent. Überschreiten Sie es, erhalten Sie den Statuscode 429. Wechseln Sie in einen höheren Tarif oder kontaktieren Sie uns für individuelle Limits.

Die Flasche in deinem Regal? Sie wartet auf das richtige Gericht.

Beginne mit deinem Gericht oder deiner Flasche. Du bekommst eine Punktzahl und den Grund.