Skip to content
API v1 Nu Beschikbaar

Wijnpairing-intelligentie
voor Jouw Platform

Voeg sommelier-niveau wijnpairing toe aan elke app, website of AI-agent. RESTful API, OpenAPI-spec en MCP-server. Gebouwd op 10+ jaar onderzoek door professionele sommeliers.

608
Wijnstijlen in kaart
100K+
Wijnen in database
<200ms
API responstijd
99.9%
Uptime SLA

Hoe Het Werkt

Vier stappen van aanmelding tot je eerste pairing-resultaat.

1

Haal je API key op

Meld je aan op business.sommelierx.com. Je gratis API key is binnen seconden klaar. Geen creditcard nodig.

2

Stuur een gerecht

Stuur een gerechtnaam, ingredienten of een foto naar ons pairing-endpoint. We accepteren JSON, multipart of platte tekst.

3

Ontvang wijnmatches

Ontvang gerangschikte wijnaanbevelingen met matchscores, Wine DNA-profielen, proefnotities en pairing-uitleg.

4

Verras je gebruikers

Toon pairing-resultaten in je app met onze kant-en-klare UI-componenten, of bouw je eigen ervaring met ruwe data.

Gebouwd voor Developers

Alles wat je nodig hebt om wijn-intelligentie in je product te integreren.

🍷

Wijnpairing Engine

Stuur elk gerecht en ontvang gerangschikte wijnaanbevelingen met matchscores van 0-100. Aangedreven door ons eigen Wine DNA-algoritme, gebouwd door professionele sommeliers over 10+ jaar onderzoek.

🧬

Wine DNA Profielen

Toegang tot gedetailleerde smaakprofielen over 6 smaakdimensies voor elke wijnstijl. Visualiseer waarom een pairing werkt met radar charts, staafdiagrammen of je eigen visualisatie.

📷

Fotoherkenning

Stuur een foto van elk gerecht of wijnlabel. Onze AI identificeert het gerecht/de wijn en retourneert automatisch pairingsuggesties. Aangedreven door multimodale visie-modellen.

🔄

Reverse Pairing

Begin met een wijn en vind de perfecte gerechten. Ideaal voor wijnwinkels, restaurants die menu's samenstellen, of apps die gebruikers helpen koken bij een specifieke fles.

🌐

Meertalige Ondersteuning

Alle responses beschikbaar in Engels en Nederlands. Wijnnamen, proefnotities en pairing-uitleg zijn gelokaliseerd. Meer talen gepland voor 2026.

🔌

MCP Server

Verbind SommelierX met elke AI-agent via onze Model Context Protocol server. Claude, GPT en andere AI-assistenten kunnen wijnpairings native opvragen.

📑

OpenAPI 3.1 Spec

Volledige OpenAPI 3.1.0 specificatie beschikbaar. Genereer automatisch client SDKs in elke taal. Interactieve documentatie via Scalar UI.

📈

Gebruiksanalytics

Volg API-gebruik, populaire queries, responstijden en foutpercentages in je developer dashboard. Stel meldingen in voor quota-drempels.

🔒

Enterprise Beveiliging

API key authenticatie, rate limiting, CORS-configuratie en alleen HTTPS. OWASP Top 10 compliant. SOC 2 Type II op onze roadmap.

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

Quick Start

Krijg je eerste wijnpairing in minder dan 5 minuten. Kopieer, plak, draai.

# Get wine pairings 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 pairings 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 pairings 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
Regels tot eerste pairing
REST + MCP
Integratiemethoden
OpenAPI 3.1
Volledige spec beschikbaar
2 min
Tijd tot eerste API call

Eenvoudige, Voorspelbare Prijzen

Begin gratis. Schaal mee met je groei. Geen verrassingen.

Gratis
0
voor altijd
  • 100 API calls / dag
  • Wijnpairing endpoint
  • Basis matchscores
  • JSON responses
  • Community support
Start Gratis
Starter
29
/ maand
  • 1.000 API calls / dag
  • Alle pairing endpoints
  • Fotoherkenning
  • Reverse pairing
  • E-mail support
Aan de Slag
Enterprise
249
/ maand
  • 25.000 API calls / dag
  • Alles uit Pro
  • Aangepaste rate limits
  • 99,9% uptime SLA
  • Dedicated support
  • Aangepaste integraties
Neem Contact Op

Alle plannen bevatten HTTPS, API key auth en rate limiting. Meer calls nodig? Neem contact op.

Vertrouwd door Bouwers

Zie wat developers bouwen met de SommelierX API.

"We hebben de SommelierX API in minder dan een dag geintegreerd in onze restaurant-bestelapp. De Wine DNA profielen voegen een niveau van verfijning toe dat onze klanten geweldig vinden."
Restaurant Tech Startup
Maaltijdbezorgplatform
"De MCP server-integratie zorgt ervoor dat onze AI-sommelier chatbot echt nuttige wijnaanbevelingen geeft in plaats van generieke suggesties. Enorm verschil."
AI Productteam
Conversational AI bedrijf
"Eindelijk een API die wijn begrijpt voorbij 'rood bij vlees, wit bij vis.' De DNA-scoring geeft ons data waar we daadwerkelijk features omheen kunnen bouwen."
E-commerce Developer
Online wijnretail

Veelgestelde Vragen

Wine DNA is ons eigen matching-algoritme, gebouwd over 10+ jaar onderzoek door professionele sommeliers. Het brengt elke wijnstijl in kaart over 6 smaakdimensies (body, zuurgraad, tannine, zoetheid, smaakintensiteit en complexiteit) en berekent matchscores tegen smaakprofielen van gerechten. Het is geen generieke aanbevelingsengine -- het is gebaseerd op echte sommelier-expertise.
Ons algoritme matcht 608 wijnstijlen met gerechten met dezelfde expertise die professionele sommeliers toepassen. De scoringsmatrix is handmatig gebouwd en verfijnd door professionele sommeliers, niet gescraped van reviews of gegenereerd door AI. Matchscores boven 80 duiden op uitstekende pairings die een sommelier vol vertrouwen zou aanbevelen.
De gratis tier geeft je 100 API calls per dag met toegang tot het wijnpairing-endpoint en basis matchscores. Perfect voor prototyping, persoonlijke projecten en het evalueren van de API. Geen creditcard nodig, geen tijdslimiet. Upgrade wanneer je meer calls of geavanceerde features zoals Wine DNA profielen nodig hebt.
Ja. Alle betaalde plannen (Starter, Pro, Enterprise) staan commercieel gebruik toe. Je mag pairing-resultaten, Wine DNA data en proefnotities tonen in je eigen applicatie. Vermelding van SommelierX wordt gewaardeerd maar is niet vereist bij betaalde plannen.
MCP (Model Context Protocol) is een standaard waarmee AI-assistenten zoals Claude externe API's kunnen aanroepen. Onze MCP server laat elke MCP-compatibele AI-agent native wijnpairings opvragen, waardoor het eenvoudig wordt om AI-sommeliers, chatbots en aanbevelingsengines te bouwen zonder aangepaste integratiecode.
We bieden een volledige OpenAPI 3.1.0 specificatie, wat betekent dat je automatisch client SDKs kunt genereren voor elke taal met tools zoals openapi-generator. Officiele JavaScript en Python SDKs staan op onze roadmap. Ondertussen werkt de REST API met elke HTTP client.
Alle responses zijn JSON. Pairing-resultaten bevatten wijnnaam, type, regio, matchscore (0-100), pairing-uitleg, proefnotities en Wine DNA profiel (op Pro+ plannen). Foutresponses volgen een consistent formaat met statuscode, foutmelding en details.
Rate limits zijn per API key en resetten dagelijks om middernacht UTC. Als je je limiet nadert, retourneert de API headers met je resterende quota. Bij overschrijding ontvang je een 429 statuscode. Upgrade je plan of neem contact met ons op voor aangepaste limieten als je meer capaciteit nodig hebt.

Klaar om Wijn-intelligentie Toe te Voegen?

Haal je gratis API key op en begin binnen minuten met bouwen. Geen creditcard. Geen verplichtingen.