Sommelier & terroir intelligence API
Sommelier & terroir intelligence API. Integrates wine vintage, grape varieties (with sensory radar for tannins, acidity, body, aromatic intensity), winery heritage, geographical appellations (DOCG/DOC), and tailored serving and decanting guidance.
10000 (raw units)
price
1
calls / 30d
1
unique payers
2026-09-12
updated
Provider
api.wines.bet · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x350A947254e59291FAB58430E03A86589E0D8bA8",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "10000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"method": "GET",
"queryParams": {
"country": "IT",
"lang": "en",
"name": "Barolo",
"vintage": 2019
},
"type": "http"
},
"output": {
"example": {
"data": {
"grapes": [
{
"color": "red",
"name": "Nebbiolo",
"profile": "High tannin, high acidity, ruby-garnet color with floral and spiced aromatics.",
"sensoryProfile": {
"acidity": 4,
"aromaticIntensity": 4,
"body": 4,
"elegance": 5,
"longevity": 5,
"tannin": 5
},
"slug": "nebbiolo"
}
],
"producer": {
"annualBottles": 250000,
"description": "Historic family-owned Barolo pioneer renowned for single-vineyard crus.",
"founded": 1873,
"hectares": 35,
"location": "Castiglione Falletto (CN)",
"name": "Vietti",
"region": "Piedmont",
"slug": "vietti"
},
"sommelierNotes": {
"characteristicsSummary": "Classic expression of Piedmont, crafted with Nebbiolo. Balanced sensory profile combining varietal typicity and terroir distinction.",
"drinkingWindow": {
"currentMaturity": "in_drinking_window",
"drinkFrom": 2025,
"drinkUntil": 2045
},
"servingAdvice": "Optimal serving temperature: 16-18°C. Serve in a large Bordeaux/Burgundy glass. At optimal drinking peak: uncork 30-45 minutes before serving."
},
"terroir": {
"country": "IT",
"denomination": "Barolo DOCG",
"province": "CN",
"region": "Piedmont"
},
"wine": {
"appellation": "Barolo DOCG",
"category": "red",
"description": "Elegantly structured red with notes of dried rose, tar, and wild berries.",
"id": "6645a1b2c3d4e5f6a7b8c9d1",
"name": "Barolo",
"vintage": 2019
}
},
"success": true
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"properties": {
"country": {
"description": "2-letter ISO country code (e.g. IT, FR)",
"type": "string"
},
"lang": {
"description": "Response language (default: en)",
"enum": [
"en",
"it"
],
"type": "string"
},
"name": {
"description": "Wine name, grape variety, or denomination (e.g. Barolo, Brunello di Montalcino, Amarone)",
"type": "string"
},
"vintage": {
"description": "4-digit harvest vintage year (e.g. 2019)",
"type": "integer"
}
},
"required": [
"name"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
}
}Use it
curl
curl "https://api.wines.bet/v1/wine/sommelier" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://api.wines.bet/v1/wine/sommelier");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://api.wines.bet/v1/wine/sommelier")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/8195.json, and this resource appears in /discovery/resources and /discovery/search.