Wine pairing intelligence for developers. Sommelier-grade matching across 600+ wine styles.
Three steps to your first wine pairing.
Generate a key from your dashboard. Free tier: 100 calls/day.
Call the pairing endpoint with your key and get wine recommendations.
Get wine pairing recommendations in a single API call.
# Pair wines with a dish described in natural language curl -X POST https://api.sommelierx.com/api/v1/pairing/by-text \ -H "Authorization: Bearer sk_live_..." \ -H "Content-Type: application/json" \ -d '{"text": "grilled salmon with asparagus"}'
The response includes ranked wine type recommendations with match scores, powered by a proprietary Wine DNA matching algorithm with 19 wine dimensions and 17 food dimensions.
Pass your key as a Bearer token in the Authorization header. Recommended for production use.
Pay per request with USDC on Base. No API key needed. Grants PRO-tier access.
| Tier | Daily Limit | API Keys | Score Detail | Price |
|---|---|---|---|---|
| FREE | 100 calls/day | 3 | Match percentage only | €0 |
| STARTER | 1,000 calls/day | 5 | Full pairing results | €29/mo |
| PRO | 5,000 calls/day | 10 | Full score breakdown + Wine DNA | €99/mo |
| ENTERPRISE | 25,000 calls/day | 25 | Full access + SLA | €249/mo |
All paid plans include overage options. Manage your plan →
Every endpoint supports the x402 payment protocol. Include a signed payment header to pay per request and receive PRO-tier access instantly. No registration, no API key management. Prices start at $0.005 per request.
| Endpoint | Method | Description |
|---|---|---|
/pairing/calculate |
POST | Wine pairings from ingredient IDs |
/pairing/by-text |
POST | Natural language pairing |
/pairing/by-meal/{id} |
POST | Pairing for a specific meal |
/pairing/by-wine/{id}/meals |
GET | Reverse pairing: meals for a wine |
/search |
GET | Search meals and ingredients |
/ingredients |
GET | Browse all ingredients |
/meals |
GET | Browse all meals |
/wines/types |
GET | All wine types (MetaWines) |