{"uid":"cap_899Cfx85mSgiwyaQqfYVr","slug":"wines-bet-wine-region-lookup-api-e8b760db","name":"Wines.bet Wine Region Lookup API","description":"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.","url":"https://api.wines.bet/v1/regions/%7Bslug%7D","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"},"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"}}}}},"responseSchema":{"type":"json","example":{"data":{"region":{"id":"6645a1b2c3d4e5f6a7b8c001","name":"Piedmont","slug":"piemonte","color":"#7b1e3a","winesCount":184}},"success":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KDyosyJX5ZcphI0LmBpUc","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns structured metadata for a named Italian or international fine wine region, including wine count and geographic/denomination details, by region slug.","exampleAgentPrompt":"Pull up the Wines.bet region profile for Piemonte — I want the full details including how many wines are listed there.","exampleUseCases":[{"title":"Region profile for investment research","prompt":"Get me the Wines.bet region data for Toscana — I want the region ID, wine count, and any geographic details so I can start analyzing investment opportunities there."},{"title":"Building a wine region directory","prompt":"Fetch the region profile for Piemonte from Wines.bet in Italian so I can display the official region name and denomination info on my site."},{"title":"Validating a region slug before querying prices","prompt":"Before I pull price data, can you confirm that 'sicilia' is a valid region slug on Wines.bet and tell me how many wines are tracked there?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:48:07.651Z","isFirstParty":false}