# Wines.bet Wine Region Lookup API

> Wines.bet Wine Region Lookup API is a paid API for AI agents from api.wines.bet, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns structured metadata for a named Italian or international fine wine region, including wine count and geographic/denomination details, by region slug.

## Facts

- Endpoint: GET https://api.wines.bet/v1/regions/%7Bslug%7D
- Price: $0.002/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-wine-region-lookup-api-e8b760db
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_899Cfx85mSgiwyaQqfYVr

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-wine-region-lookup-api-e8b760db
```

Example prompt: Pull up the Wines.bet region profile for Piemonte — I want the full details including how many wines are listed there.

## When to prefer this

Use this endpoint when you need to resolve a wine region slug to its canonical metadata (ID, name, wine count) before making downstream calls to price, investment, or sommelier endpoints on the Wines.bet platform. Prefer this over general wine databases when you specifically need Wines.bet's internal region IDs or wine counts tied to their market data.

## Known failure modes

- Invalid or misspelled slug returns a 404 or empty result
- Unsupported lang enum value may cause a 400 error
- Region slugs are Italian-style (e.g. 'piemonte' not 'piedmont') — using English names will fail
- Rate limiting or payment failure returns a 402 error
- Network timeouts if the API is under load

## How this service works

Pay-per-request fine wine market oracle, valuation benchmarks, sommelier intelligence, and investment analytics for AI agents and developers. No auth, no subscriptions, instant x402 settlement on Base.

## Output

A JSON object with success flag and a data.region object containing the region's unique ID, canonical name, URL slug, brand color hex code, and the count of wines tracked within that region on the Wines.bet platform.

## 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"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "slug"
     ],
     "properties": {
      "slug": {
       "type": "string",
       "description": "Region slug (e.g. piemonte, toscana)"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "lang": {
       "enum": [
        "en",
        "it"
       ],
       "type": "string",
       "description": "Response language (default: en)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "region": {
    "id": "6645a1b2c3d4e5f6a7b8c001",
    "name": "Piedmont",
    "slug": "piemonte",
    "color": "#7b1e3a",
    "winesCount": 184
   }
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wines-bet-wine-region-lookup-api-e8b760db/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)