Wine Pairing Intelligence
for Your Platform
Add sommelier-grade wine pairing to any app, website, or AI agent. RESTful API, OpenAPI spec, and MCP server. Built on 10+ years of research by professional sommeliers.
Add sommelier-grade wine pairing to any app, website, or AI agent. RESTful API, OpenAPI spec, and MCP server. Built on 10+ years of research by professional sommeliers.
Four steps from sign-up to your first pairing result.
Sign up at developers.sommelierx.com. Your free API key is ready in seconds. No credit card required.
Pass a dish name, ingredients, or a photo to our pairing endpoint. We accept JSON, multipart, or plain text.
Receive ranked wine recommendations with match scores, Wine DNA profiles, tasting notes, and food pairing explanations.
Display pairing results in your app with our ready-made UI components, or build your own experience with raw data.
Everything you need to integrate wine intelligence into your product.
Send any dish and receive ranked wine recommendations with match scores from 0-100. Powered by our proprietary Wine DNA algorithm, built by professional sommeliers over 10+ years of research.
Access detailed flavor profiles across 6 taste dimensions for every wine style. Visualize why a pairing works with radar charts, bar charts, or your own custom visualization.
Send a photo of any dish or wine label. Our AI identifies the dish/wine and returns pairing suggestions automatically. Powered by multimodal vision models.
Start with a wine and find the perfect dishes. Ideal for wine retailers, restaurants building menus, or apps helping users cook for a specific bottle.
All responses available in English and Dutch. Wine names, tasting notes, and pairing explanations are localized. More languages planned for 2026.
Connect SommelierX to any AI agent via our Model Context Protocol server. Claude, GPT, and other AI assistants can query wine pairings natively.
Full OpenAPI 3.1.0 specification available. Generate client SDKs in any language automatically. Interactive documentation via Scalar UI.
Track API usage, popular queries, response times, and error rates in your developer dashboard. Set up alerts for quota thresholds.
API key authentication, rate limiting, CORS configuration, and HTTPS-only. OWASP Top 10 compliant. SOC 2 Type II on our roadmap.
Get your first wine pairing in under 5 minutes. Copy, paste, run.
# 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" )
Start free. Scale as you grow. No surprises.
All plans include HTTPS, API key auth, and rate limiting. Need more calls? Contact us.
See what developers are building with the SommelierX API.
Get your free API key and start building in minutes. No credit card. No commitment.