# api.wines.bet Winery & Producer Directory

> api.wines.bet Winery & Producer Directory is a paid API for AI agents from api.wines.bet, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Search and browse a directory of wineries and wine producers, filterable by name, region, and country.

## Facts

- Endpoint: GET https://api.wines.bet/v1/producers
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/api-wines-bet-winery-producer-directory-dfdc9acf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UPhatvZbw_5iobqVS-Blt

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 api-wines-bet-winery-producer-directory-dfdc9acf
```

Example prompt: Can you find me wineries in Tuscany, Italy from the wines.bet producer directory? Show me up to 20 results in English.

## When to prefer this

Choose this endpoint when you need to discover, search, or enumerate wineries and wine producers by name, region, or country. Use this as the entry point for finding producer slugs or identifiers before querying price or regional data from sibling endpoints. Prefer this over general web search when structured, machine-readable producer directory data is required.

## Known failure modes

- No results returned if query string doesn't match any producer name or slug
- Invalid country code or region name may return empty results
- Exceeding max limit of 100 per page returns an error
- Unsupported language code outside 'en'/'it' may cause a validation error
- Payment failure (x402) blocks the request before any data is returned

## How this service works

Searchable Italian winery directory and estate heritage catalog. Search by winery name, region, or terroir with wine counts and winery profiles.

## Output

A paginated list of winery and wine producer records matching the query, including producer names, slugs, regions, and country data. Supports filtering by name/slug, region, country code, and language (English or Italian).

## 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",
     "properties": {
      "q": {
       "type": "string",
       "description": "Filter by winery name or slug (e.g. Antinori, San Guido, Vietti, Gaja)"
      },
      "lang": {
       "enum": [
        "en",
        "it"
       ],
       "type": "string",
       "description": "Response language (default: en)"
      },
      "page": {
       "type": "integer",
       "description": "Page number (default 1)"
      },
      "limit": {
       "type": "integer",
       "description": "Items per page (default 20, max 100)"
      },
      "region": {
       "type": "string",
       "description": "Filter by region (e.g. Tuscany, Piedmont, Veneto)"
      },
      "country": {
       "type": "string",
       "description": "Filter by country code (e.g. IT)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "page": 1,
   "total": 1,
   "producers": [
    {
     "id": "6645a1b2c3d4e5f6a7b8c999",
     "name": "Tenuta San Guido",
     "slug": "tenuta-san-guido",
     "region": "Tuscany",
     "location": "Bolgheri, Castagneto Carducci (LI)",
     "winesCount": 3,
     "countryCode": "IT"
    }
   ],
   "totalPages": 1
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/api-wines-bet-winery-producer-directory-dfdc9acf/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)