Vivino API

Search Vivino wines and pull ratings, prices, taste profiles, reviews and winery profiles as clean JSON.

The API.SH Vivino API turns public Vivino pages into structured JSON. Search wines by name, or use the wine explorer with Vivino's own filters: market country and currency, wine type, minimum rating, price range, grapes, regions, styles and wineries. Then open one wine for its rating, grapes, alcohol, food pairings, taste structure, flavour notes and the price of every vintage, read its user reviews, or look up the winery behind it.

Get a free API key Try it in the playground

5 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Vivino wine search

GET https://api.api.sh/vivino/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Vivino API

Wine price comparison by market

Run the explorer for a country and currency with a price range and minimum rating, and compare best offer prices and ratings across wines and vintages.

/explore /wine

Wine catalog enrichment

Match the bottles in your shop or app to Vivino by name, then add rating, ratings count, region, grapes, taste structure and food pairings to each product page.

/search /wine

Vintage price tracking

Request a wine with vintage prices turned on to get the market price of each vintage, and track how older vintages are priced against new ones.

/wine

Review and sentiment analysis

Pull a wine's reviews, newest first and filtered by vintage or language, to study what drinkers say about it and how ratings move over time.

/reviews

Winery research for importers

Look up a winery's profile, rating, location, website and top wines before you contact it or add its range to your list.

/winery /explore

Vivino data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Vivino API endpoints and prices

Every Vivino endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery2

Vivino wine explorer /vivino/v1/explore	$1 · $2 PAYG 1 credit
Vivino wine search /vivino/v1/search	$1 · $2 PAYG 1 credit

Comments and reviews1

Vivino wine reviews

/vivino/v1/reviews

$1 · $2 PAYG

1 credit

More data2

Vivino wine /vivino/v1/wine	$1 · $2 PAYG 1 credit
Vivino winery /vivino/v1/winery	$1 · $2 PAYG 1 credit

Call the Vivino API

Vivino wine search: GET https://api.api.sh/vivino/v1/search

curl "https://api.api.sh/vivino/v1/search?q=opus+one" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/vivino/v1/search",
    params={"q": "opus one"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/vivino/v1/search");
url.searchParams.set("q", "opus one");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/vivino/v1/search", "q", "opus one")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Vivino" and "Vivino wine search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 483 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Vivino data

Public data only: no Vivino login, cookies or account needed
One key and one response shape for Vivino and 482 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Vivino API

Vivino does not offer a public developer API; its wine data, ratings and reviews are available in the consumer app and website. API.SH returns that public data as JSON with one key, no Vivino account needed.

Skip writing and maintaining your own Vivino scraper from GitHub or Python tutorials, or buying a one-off wine dataset: API.SH gives you live data, one key and a fixed price per call.

Vivino API questions

What Vivino data can I get?+

Wine search by name (/vivino/v1/search), the filtered wine explorer (/vivino/v1/explore), one wine with ratings, grapes, taste structure, food pairings and vintage prices (/vivino/v1/wine), a wine's user reviews (/vivino/v1/reviews) and winery profiles with their top wines (/vivino/v1/winery).

How much does the Vivino API cost?+

Every Vivino endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /vivino/v1/explore at 1 credit each.

Is there an official Vivino API?+

No. Vivino has no public developer API. API.SH reads the public Vivino website and returns wines, ratings, prices and reviews as JSON.

Do I need a Vivino account or login?+

No. API.SH reads public Vivino pages only. No endpoint uses a login, cookies or anyone's account.

Can I use the Vivino API from Python?+

Yes. It is a plain HTTPS API that returns JSON, so any HTTP library works, and there is an official API.SH Python SDK. Pass your key and call a route such as /vivino/v1/search with q set to a wine name.

Can I get wine prices for my country?+

Yes. Search, explore and wine take a market country and currency, and prices are returned where Vivino shows them for that market. Add vintage_prices=1 on /vivino/v1/wine for the price of every vintage.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /vivino/v1/search with q set to a wine name, then pass a result's id to /vivino/v1/wine. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.