{"uid":"cap_Lp9V7UvOjVfBwPhS2-Qws","slug":"vivino-wine-data-scraper-x402-564f7cb5","name":"Vivino Wine Data Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/vivino?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"wines":{"type":"array","description":"Enter up to 250 wine names, wine URLs containing /w/ and a wine ID, or vintage URLs containing /wines/ and a vintage ID. Add a year to a name or URL to request that vintage."},"maxItems":{"type":"integer","default":100,"maximum":250,"minimum":1,"description":"Stop after this many distinct matched vintages."},"countryCode":{"type":"string","default":"US","description":"Two-letter market country code used for availability and prices."},"currencyCode":{"type":"string","default":"USD","description":"Three-letter currency code requested for available offers."},"includePrices":{"type":"boolean","default":true,"description":"Search for a matching offer for direct vintage URLs. Name lookups include any offer returned by search."},"includeReviews":{"type":"boolean","default":false,"description":"Fetch public review ratings, notes, dates, and display names."},"maxSearchPages":{"type":"integer","default":2,"maximum":5,"minimum":1,"description":"Maximum search pages to inspect per distinct wine name. Increase when a vintage is missing from the first results."},"maxReviewsPerWine":{"type":"integer","default":10,"maximum":100,"minimum":1,"description":"Maximum public reviews returned per matched wine when reviews are enabled."},"includeTasteProfile":{"type":"boolean","default":false,"description":"Fetch structure and flavor notes for each matched wine."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"url":null,"name":null,"region":null,"wineId":null,"winery":null,"vintage":null,"wineType":null,"vintageId":null}],"product":"vivino"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1OCmmsHb3DpdSKa9iX66n","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches structured wine data from Vivino including vintages, pricing, reviews, and taste profiles for up to 250 wines per call, billed per successful call via x402.","exampleAgentPrompt":"Look up Vivino data for these wines — Opus One 2018, Screaming Eagle 2019, and Caymus Cabernet 2020 — and get me their prices in USD for the US market, plus any available taste profiles.","exampleUseCases":[{"title":"Wine list pricing for restaurant menu","prompt":"I have a list of 20 wines for our restaurant menu — can you pull their current Vivino prices in USD for the US market? Here are the names: [Château Margaux 2015, Penfolds Grange 2017, ...]"},{"title":"Vintage research with reviews","prompt":"Can you fetch Vivino data for Domaine de la Romanée-Conti 2016 and Screaming Eagle Cabernet 2018, including up to 20 public reviews each and their taste profiles?"},{"title":"Wine gift selection with availability check","prompt":"I want to buy a nice Barolo as a gift — can you search Vivino for the top Barolo wines available in the US market, show me their prices in USD, and include their taste profiles so I can pick one?"}],"resultDescription":"A JSON object with a count and an array of matched wine items, each containing the wine name, winery, region, wine type, vintage year, wine ID, vintage ID, and optionally price offers, public reviews (ratings, notes, dates, display names), and taste/flavor profiles. Failed or empty scrapes are not charged.","failureModes":["Wine name not found on Vivino — item missing from results","Vintage not found in first search pages — increase maxSearchPages","No price offers available in the requested country/currency — offer fields null","Rate limits or scraping blocks from Vivino — empty or partial results, not charged","Invalid country or currency code — may return no pricing data","Request exceeds 250 wines — rejected at input validation"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable wine data from Vivino — including prices, vintages, reviews, and taste profiles — for one or many wines at once. Prefer this over manual scraping or general web search when you need clean JSON output with wine-specific fields (winery, region, wine type, vintage ID) and want pay-per-successful-call pricing with no charge for failed runs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:23.974Z","isFirstParty":false,"canonicalSlug":"vivino-wine-data-scraper-x402-564f7cb5"}