Skip to content
API v1 Now Available

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.

608
Wine styles mapped
100K+
Wines in database
<200ms
API response time
99.9%
Uptime SLA

How It Works

Four steps from sign-up to your first pairing result.

1

Get your API key

Sign up at developers.sommelierx.com. Your free API key is ready in seconds. No credit card required.

2

Send a dish

Pass a dish name, ingredients, or a photo to our pairing endpoint. We accept JSON, multipart, or plain text.

3

Get wine matches

Receive ranked wine recommendations with match scores, Wine DNA profiles, tasting notes, and food pairing explanations.

4

Delight your users

Display pairing results in your app with our ready-made UI components, or build your own experience with raw data.

Built for Developers

Everything you need to integrate wine intelligence into your product.

🍷

Wine Pairing Engine

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.

🧬

Wine DNA Profiles

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.

📷

Photo Recognition

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.

🔄

Reverse Pairing

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.

🌐

Multilingual Support

All responses available in English and Dutch. Wine names, tasting notes, and pairing explanations are localized. More languages planned for 2026.

🔌

MCP Server

Connect SommelierX to any AI agent via our Model Context Protocol server. Claude, GPT, and other AI assistants can query wine pairings natively.

📑

OpenAPI 3.1 Spec

Full OpenAPI 3.1.0 specification available. Generate client SDKs in any language automatically. Interactive documentation via Scalar UI.

📈

Usage Analytics

Track API usage, popular queries, response times, and error rates in your developer dashboard. Set up alerts for quota thresholds.

🔒

Enterprise Security

API key authentication, rate limiting, CORS configuration, and HTTPS-only. OWASP Top 10 compliant. SOC 2 Type II on our roadmap.

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

Quick Start

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"
    )
3
Lines to first pairing
REST + MCP
Integration methods
OpenAPI 3.1
Full spec available
2 min
Time to first API call

Simple, Predictable Pricing

Start free. Scale as you grow. No surprises.

Free
0
forever
  • 100 API calls / day
  • Wine pairing endpoint
  • Basic match scores
  • JSON responses
  • Community support
Start Free
Starter
29
/ month
  • 1,000 API calls / day
  • All pairing endpoints
  • Photo recognition
  • Reverse pairing
  • Email support
Get Started
Enterprise
249
/ month
  • 25,000 API calls / day
  • Everything in Pro
  • Custom rate limits
  • 99.9% uptime SLA
  • Dedicated support
  • Custom integrations
Contact Sales

All plans include HTTPS, API key auth, and rate limiting. Need more calls? Contact us.

Trusted by Builders

See what developers are building with the SommelierX API.

"We integrated the SommelierX API into our restaurant ordering app in under a day. The Wine DNA profiles add a level of sophistication our customers love."
Restaurant Tech Startup
Food delivery platform
"The MCP server integration means our AI sommelier chatbot gives genuinely useful wine recommendations instead of generic suggestions. Game changer."
AI Product Team
Conversational AI company
"Finally an API that understands wine beyond just 'red with meat, white with fish.' The DNA scoring gives us data we can actually build features around."
E-commerce Developer
Online wine retail

Frequently Asked Questions

Wine DNA is our proprietary matching algorithm built over 10+ years of research by professional sommeliers. It maps every wine style across 6 taste dimensions (body, acidity, tannin, sweetness, flavor intensity, and complexity) and calculates match scores against dish flavor profiles. It is not a generic recommendation engine -- it is grounded in real sommelier expertise.
Our algorithm matches 608 wine styles against dishes using the same expertise that professional sommeliers apply. The scoring matrix was hand-built and refined by professional sommeliers, not scraped from reviews or generated by AI. Match scores above 80 indicate excellent pairings that a sommelier would confidently recommend.
The free tier gives you 100 API calls per day with access to the wine pairing endpoint and basic match scores. It is perfect for prototyping, personal projects, and evaluating the API. No credit card required, no time limit. Upgrade when you need more calls or advanced features like Wine DNA profiles.
Yes. All paid plans (Starter, Pro, Enterprise) allow commercial use. You may display pairing results, Wine DNA data, and tasting notes in your own application. Attribution to SommelierX is appreciated but not required on paid plans.
MCP (Model Context Protocol) is a standard that allows AI assistants like Claude to call external APIs. Our MCP server lets any MCP-compatible AI agent query wine pairings natively, making it easy to build AI sommeliers, chatbots, and recommendation engines without custom integration code.
We provide a full OpenAPI 3.1.0 specification, which means you can auto-generate client SDKs for any language using tools like openapi-generator. Official JavaScript and Python SDKs are on our roadmap. In the meantime, the REST API works with any HTTP client.
All responses are JSON. Pairing results include wine name, type, region, match score (0-100), pairing explanation, tasting notes, and Wine DNA profile (on Pro+ plans). Error responses follow a consistent format with status code, error message, and details.
Rate limits are per API key, reset daily at midnight UTC. When you approach your limit, the API returns headers with your remaining quota. If you exceed the limit, you receive a 429 status code. Upgrade your plan or contact us for custom limits if you need more capacity.

Ready to Add Wine Intelligence?

Get your free API key and start building in minutes. No credit card. No commitment.