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. In 17 jaar opgebouwd met wetenschappers en professionele sommeliers.

Open input
Gerecht, ingrediënten of foto
Gerangschikt
Score per resultaat
Uitlegbaar
Waarom de match werkt
Twee kanten
Gerecht naar wijn en terug

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, in 17 jaar opgebouwd met wetenschappers en professionele sommeliers.

🧬

Wine DNA Profielen

Werk met alle 19 wijndimensies en de 17 dimensies van een gerecht. 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

Nederlands en Engels zijn nu beschikbaar. De API gebruikt locale-codes en is ontworpen om nieuwe ondersteunde talen toe te voegen zonder een nieuw integratiecontract.

🔌

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, configureerbare CORS en uitsluitend HTTPS, met gedocumenteerde beveiligingscontroles voor productie-integraties.

🖥
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
  • SLA op maat
  • Dedicated support
  • Aangepaste integraties
Neem Contact Op

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

Gebouwd voor echte producten

Drie manieren waarop teams de SommelierX-intelligentie kunnen inzetten.

Geef bij ieder gerecht direct gerangschikte wijnen met een uitlegbare matchscore.
Restaurant- en bestelplatforms
Pairing op het beslismoment
Laat een AI-agent gespecialiseerde wijn-spijsberekeningen uitvoeren via de MCP-server.
AI-productteams
Gestructureerde tools in plaats van losse tekst
Koppel gerechten aan het eigen assortiment en toon alleen wijnen die werkelijk te koop zijn.
Wijnretail en e-commerce
Relevante productontdekking

Veelgestelde Vragen

Wine DNA is ons eigen matching-algoritme, in 17 jaar opgebouwd met wetenschappers en professionele sommeliers. Het brengt elke wijnstijl in kaart over 19 wijndimensies en vergelijkt die met 17 gerecht-dimensies. Het is geen generieke aanbevelingsengine -- het is gebaseerd op gestructureerde smaakdata en sommelier-expertise.
Ons algoritme matcht 609 wijnstijlen met gerechten met dezelfde expertise die professionele sommeliers toepassen. De scoringsmatrix is handmatig gebouwd en verfijnd door professionals, niet gescraped van reviews. Matchscores boven 80 duiden op uitstekende pairings.
De gratis tier geeft je 100 API-calls per dag met toegang tot de pairing- en Wine DNA-endpoints. Geschikt voor prototypes en evaluatie. Upgrade wanneer je meer calls of productiefuncties zoals geavanceerde score-uitsplitsing, groepspairing en webhooks 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 wijnidentiteit, matchscore en pairing-uitleg. Wine DNA is beschikbaar via het eigen endpoint; geavanceerde score-uitsplitsing hangt af van de API-tier. Fouten gebruiken een consistente status-, code-, bericht- en detailstructuur.
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.