{"uid":"cap_acRUSm8ZTJkn4ZTnbrU42","slug":"wines-bet-sommelier-terroir-intelligence-9eb35858","name":"Wines.bet Sommelier & Terroir Intelligence","description":"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.","url":"https://api.wines.bet/v1/wine/sommelier","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["name"],"properties":{"lang":{"enum":["en","it"],"type":"string","description":"Response language (default: en)"},"name":{"type":"string","description":"Wine name, grape variety, or denomination (e.g. Barolo, Brunello di Montalcino, Amarone)"},"country":{"type":"string","description":"2-letter ISO country code (e.g. IT, FR)"},"vintage":{"type":"integer","description":"4-digit harvest vintage year (e.g. 2019)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"wine":{"id":"6645a1b2c3d4e5f6a7b8c9d1","name":"Barolo","vintage":2019,"category":"red","appellation":"Barolo DOCG","description":"Elegantly structured red with notes of dried rose, tar, and wild berries."},"grapes":[{"name":"Nebbiolo","slug":"nebbiolo","color":"red","profile":"High tannin, high acidity, ruby-garnet color with floral and spiced aromatics.","sensoryProfile":{"body":4,"tannin":5,"acidity":4,"elegance":5,"longevity":5,"aromaticIntensity":4}}],"terroir":{"region":"Piedmont","country":"IT","province":"CN","denomination":"Barolo DOCG"},"producer":{"name":"Vietti","slug":"vietti","region":"Piedmont","founded":1873,"hectares":35,"location":"Castiglione Falletto (CN)","description":"Historic family-owned Barolo pioneer renowned for single-vineyard crus.","annualBottles":250000},"sommelierNotes":{"servingAdvice":"Optimal serving temperature: 16-18°C. Serve in a large Bordeaux/Burgundy glass. At optimal drinking peak: uncork 30-45 minutes before serving.","drinkingWindow":{"drinkFrom":2025,"drinkUntil":2045,"currentMaturity":"in_drinking_window"},"characteristicsSummary":"Classic expression of Piedmont, crafted with Nebbiolo. Balanced sensory profile combining varietal typicity and terroir distinction."}},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0CgClSmyvx2dlnOVLADTQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns detailed sommelier guidance for a named wine including grape variety sensory profiles, terroir/appellation data, producer heritage, and serving/decanting recommendations.","exampleAgentPrompt":"Can you pull up full sommelier notes for a 2019 Barolo — I want the grape sensory profile with tannin and acidity scores, the serving temperature, how long to decant, and when it'll be at peak drinking?","exampleUseCases":[{"title":"Dinner party wine pairing guidance","prompt":"I'm serving a 2018 Amarone della Valpolicella at dinner tonight — can you get me the sommelier details including ideal serving temperature, decanting time, and a summary of what the wine tastes like so I can explain it to my guests?"},{"title":"Wine collection drinking window check","prompt":"I have a bottle of Brunello di Montalcino vintage 2016 in my cellar — is it ready to drink yet, or should I wait? Pull up the drinking window and current maturity status for me."},{"title":"Grape variety sensory education","prompt":"Tell me about the Nebbiolo grape — what are its tannin, acidity, body, and aromatic intensity scores on a sensory radar, and what are its typical flavor characteristics?"}],"resultDescription":"Returns a JSON object containing wine identity (name, vintage, category, appellation), grape variety details with numeric sensory radar scores for tannin, acidity, body, elegance, longevity, and aromatic intensity, terroir data (region, country, province, DOCG/DOC denomination), producer profile (name, founding year, hectares, location, description), and sommelier notes including optimal serving temperature, glass type, uncorking timing, drinking window (from/until years), current maturity status, and a characteristics summary.","failureModes":["Unknown or misspelled wine name returns no data or error","Vintage year outside available data range returns empty results","Invalid country code causes query failure","Ambiguous wine name (e.g. generic grape variety without denomination) may return unexpected results","Non-Italian wines may have limited terroir or producer data","Network or payment (x402) failure returns HTTP 402 or 5xx"],"whenToPreferThis":"Choose this endpoint when you need rich, structured sommelier intelligence for a specific wine — including grape sensory profiles, terroir/appellation context, producer heritage, and serving/decanting guidance — rather than just a price lookup or market valuation. Ideal for food and wine pairing agents, hospitality apps, wine education tools, or personal cellar management. Prefer sibling endpoints for price data, market trends, or investment analytics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:31:00.220Z","isFirstParty":false}