# Wines.bet Sommelier & Terroir Intelligence

> Wines.bet Sommelier & Terroir Intelligence is a paid API for AI agents from api.wines.bet, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns detailed sommelier guidance for a named wine including grape variety sensory profiles, terroir/appellation data, producer heritage, and serving/decanting recommendations.

## Facts

- Endpoint: GET https://api.wines.bet/v1/wine/sommelier
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wines-bet-sommelier-terroir-intelligence-9eb35858
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_acRUSm8ZTJkn4ZTnbrU42

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability wines-bet-sommelier-terroir-intelligence-9eb35858
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wines-bet-sommelier-terroir-intelligence-9eb35858/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.wines.bet](https://www.zero.xyz/host/api.wines.bet/llms.txt)