# Wines.bet Producer Profile API

> Wines.bet Producer Profile API 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-15).

Retrieve detailed profile data for a specific fine wine producer, including their wines, region, and estate information, by producer ID or slug

## Facts

- Endpoint: GET https://api.wines.bet/v1/producers/%7Bid%7D
- Price: $0.003/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-producer-profile-api-af244ee6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VGQu8fG0T1F0uzcCa3LGV

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-producer-profile-api-af244ee6
```

Example prompt: Pull up the Wines.bet producer profile for Tenuta San Guido — I want to see their wines, region, and estate details in English.

## When to prefer this

Use this endpoint when you need structured profile data for a specific, known wine producer — by their MongoDB ID or slug — rather than searching across producers. It is the authoritative source for producer identity, regional classification, and wine list within the Wines.bet ecosystem. Prefer this over the search/directory endpoint when the producer identifier is already known and you need complete structured metadata for enrichment, display, or downstream analytics.

## Known failure modes

- Invalid or unknown producer ID/slug returns a not-found error
- Malformed MongoDB ID format may return a validation error
- Network or authentication failure returns a payment/access error
- Unsupported language code returns a validation error or defaults to English

## 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 containing the producer's MongoDB ID, canonical name, slug, region, precise geographic location, official website URL, and an array of associated wines (each with wine ID, name, type such as red/white, and vintage year). The response also includes a success boolean flag.

## 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": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Producer MongoDB ID or slug (e.g. tenuta-san-guido)"
      }
     }
    },
    "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": {
   "producer": {
    "id": "6645a1b2c3d4e5f6a7b8c999",
    "name": "Tenuta San Guido",
    "slug": "tenuta-san-guido",
    "wines": [
     {
      "id": "6645a1b2c3d4e5f6a7b8c9d0",
      "name": "Sassicaia",
      "type": "red",
      "vintage": 2021
     }
    ],
    "region": "Tuscany",
    "location": "Bolgheri, Castagneto Carducci (LI)",
    "websiteUrl": "https://www.sassicaia.com"
   }
  },
  "success": true
 }
}
```

## More

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