{"uid":"cap_UPhatvZbw_5iobqVS-Blt","slug":"api-wines-bet-winery-producer-directory-dfdc9acf","name":"api.wines.bet Winery & Producer Directory","description":"Searchable Italian winery directory and estate heritage catalog. Search by winery name, region, or terroir with wine counts and winery profiles.","url":"https://api.wines.bet/v1/producers","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","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"}}}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VIOHohxIGQXyXo3VeCsEr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and browse a directory of wineries and wine producers, filterable by name, region, and country.","exampleAgentPrompt":"Can you find me wineries in Tuscany, Italy from the wines.bet producer directory? Show me up to 20 results in English.","exampleUseCases":[{"title":"Discovering Tuscan wine producers","prompt":"Search the wines.bet directory for all wine producers in the Tuscany region of Italy and give me a list of their names."},{"title":"Looking up a specific famous winery","prompt":"Can you find Antinori in the wines.bet winery directory and show me what information is available about them?"},{"title":"Building a regional wine producer catalog","prompt":"Pull me the first 50 wine producers from Piedmont, Italy from the wines.bet directory — I want to build a regional reference list."}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:43:11.580Z","isFirstParty":false}