{"uid":"cap_h3qCSOlf_Us9aC0_Mx6NB","slug":"vivino-wine-data-scraper-4e0a504f","name":"Vivino Wine Data Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_RGZBezHZYWzrilZ9qxls3","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 pricing, ratings, tasting notes, and vintage information for up to 250 wines per call","exampleAgentPrompt":"Can you look up Vivino data for these wines — Opus One 2018, Caymus Cabernet Sauvignon 2020, and Screaming Eagle 2019 — and give me their current prices and ratings in USD for the US market?","exampleUseCases":[{"title":"Wine list pricing for restaurant menu","prompt":"I have a list of 20 wines I'm adding to our restaurant menu — can you pull their current Vivino prices and ratings for the US market in USD? Here are the names: Chateau Margaux 2015, Penfolds Grange 2017, Opus One 2019..."},{"title":"Vintage comparison for wine enthusiast","prompt":"Can you get me the Vivino details for three vintages of Ridge Monte Bello — the 2016, 2017, and 2018 — including their taste profiles and any available prices in the UK market in GBP?"},{"title":"Wine retailer inventory enrichment","prompt":"I need structured data for these 50 Vivino wine URLs to enrich my store catalog — can you fetch winery, region, wine type, vintage, and pricing in USD for the US market for all of them, and include the flavor profiles?"}],"resultDescription":"Returns a JSON object with a count of matched wines and an array of items, each containing the wine name, winery, region, wine type, wine ID, vintage year, vintage ID, Vivino URL, and optionally price offers, community review ratings/notes, and taste/flavor profiles depending on the options enabled.","failureModes":["Wine name not found on Vivino returns empty items array with no charge","Invalid or expired Vivino URL returns no match for that entry","Unsupported country or currency code may return no price offers","Exceeding 250 wine inputs returns a validation error","Rate limiting or Vivino site changes may cause partial results"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable wine data from Vivino at scale — especially pricing by market, vintage metadata, community ratings, or flavor profiles — and you want pay-per-call pricing with no charge for failed or empty runs. Prefer this over general web scraping when the target is specifically Vivino wine or vintage pages.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:49.605Z","isFirstParty":false,"canonicalSlug":"vivino-wine-data-scraper-4e0a504f"}