Vivino

Wine ratings, wine prices and wine recommendations

Vivino helps find wines, ratings, and prices, with up to 25 relevant matches and top-rated wine picks by type and budget from US offers.

List recommended wines

List top-rated wines of a chosen type within a budget, from bottles offered in the United States. Prices are in USD; offers in other currencies are not available.

Your information

Max PriceOptional

Highest USD bottle price, for example 50. Omit for no practical price limit.

Wine Type

Wine type, for example red.

Min RatingOptional

Minimum average rating out of five, for example 4.0.

Max ResultsOptional

Maximum wines to return, for example 20 (up to 50).

More options

GrapeOptional

Grape variety, for example Pinot Noir. Omit for any grape.

CountryOptional

Country of origin, for example Italy. Omit for any country.

1 credit per completed run

The same inputs also work from your code or an AI assistant. See For developers.

Example results

Recommended wines

About the Vivino tool

Vivino, also called the Vivino wine app, finds wines by name and optionally vintage, returning ratings, origin, photos, and prices when shown.

List recommended wines returns top-rated bottles by required wine type, with optional grape, country, budget, and minimum rating filters.

Built from vivino.com. Last checked Sep 29, 2026.

Actions

List recommended wines

1 credit

List top-rated wines of a chosen type within a budget, from bottles offered in the United States. Prices are in USD; offers in other currencies are not available.

What you provide

Field	Type	Required	Description
Grape`grape`	Text	Optional	Grape variety, for example Pinot Noir. Omit for any grape.Example: Pinot Noir
Country`country`	Text	Optional	Country of origin, for example Italy. Omit for any country.Example: Italy
Max Price`max_price`	Number	Optional	Highest USD bottle price, for example 50. Omit for no practical price limit.Example: 30
Wine Type`wine_type`	Text	Required	Wine type, for example red.Example: White
Min Rating`min_rating`	Number	Optional	Minimum average rating out of five, for example 4.0.Example: 3.5
Max Results`max_results`	Number	Optional	Maximum wines to return, for example 20 (up to 50).Example: 30

What you get

Field	Type	Description
Wines`wines`	List	Highest-rated matching wines first.
Price`wines[].price`	Number	Offered bottle price.Example: 22.6
Region`wines[].region`	Text	Wine region.Example: Napa Valley
Winery`wines[].winery`	Text	Winery name.Example: Black Stallion
Country`wines[].country`	Text	Country of origin.Example: United States
Vintage`wines[].vintage`	Text	Vintage year or N.V. if available.Example: 2024
Currency`wines[].currency`	Text	Price currency code.Example: USD
Wine Name`wines[].wine_name`	Text	Name of the wine.Example: Chardonnay
Vivino Link`wines[].vivino_link`	Text	Wine page URL.Example: https://www.vivino.com/en/black-stallion-chardonnay-napa-valley/w/13819478?year…
Average Rating`wines[].average_rating`	Number	Average rating out of five.Example: 4.6
Bottle Photo Link`wines[].bottle_photo_link`	Text	Bottle image URL.Example: https://images.vivino.com/thumbs/HK6-9S8oT8K_c3a9BtOiqA_pb_x600.png
Number of Ratings`wines[].number_of_ratings`	Number	Number of ratings.Example: 28

Example result

For Max Price: 30, Wine Type: White, Min Rating: 3.5, Max Results: 30

JSON

{
  "wines": [
    {
      "price": 22.6,
      "region": "Napa Valley",
      "winery": "Black Stallion",
      "country": "United States",
      "vintage": "2024",
      "currency": "USD",
      "wine_name": "Chardonnay",
      "vivino_link": "https://www.vivino.com/en/black-stallion-chardonnay-napa-valley/w/13819478?year=2024&price_id=42123915",
      "average_rating": 4.6,
      "bottle_photo_link": null,
      "number_of_ratings": 28
    },
    {
      "price": 19.95,
      "region": "Picpoul de Pinet",
      "winery": "Le Jade",
      "country": "France",
      "vintage": "2024",
      "currency": "USD",
      "wine_name": "Picpoul de Pinet",
      "vivino_link": "https://www.vivino.com/en/le-jade-picpoul-de-pinet/w/1827746?year=2024&price_id=43440665",
      "average_rating": 4.5,
      "bottle_photo_link": "https://images.vivino.com/thumbs/HK6-9S8oT8K_c3a9BtOiqA_pb_x600.png",
      "number_of_ratings": 45
    },
    {
      "price": 29.99,
      "region": "Weinviertel",
      "winery": "Ruttenstock",
      "country": "Austria",
      "vintage": "2025",
      "currency": "USD",
      "wine_name": "Ried Reipersberg",
      "vivino_link": "https://www.vivino.com/en/ruttenstock-weinviertel-reipersberg-gruner-veltliner/w/2910395?year=2025&price_id=42426364",
      "average_rating": 4.5,
      "bottle_photo_link": "https://images.vivino.com/thumbs/2KqZsLy7RsK5SNDPog5Nhw_pb_x600.png",
      "number_of_ratings": 26
    }
  ]
}

Search wines

1 credit

Find matching Vivino wines by name, with ratings, vintage, origin, bottle photo, and US price when shown. Prices shown may be individual seller offers. Returns up to 25 results in Vivino relevance order.

What you provide

Field	Type	Required	Description
Wine`wine`	Text	Required	Wine name, optionally including the winery. For example, Caymus Cabernet Sauvignon.Example: Caymus Cabernet Sauvignon
Vintage`vintage`	Number	Optional	Only return this vintage year, for example 2021. Omit for all vintages.Example: 2021
Max Results`max_results`	Number	Optional	Maximum wines to return, for example 10; default 10 and maximum 25.Example: 10

What you get

Field	Type	Description
Wines`wines`	List	Matching wines, most relevant first.
Region`wines[].region`	Text	Wine region.Example: Napa Valley
Winery`wines[].winery`	Text	Winery name.Example: Caymus Vineyards
Country`wines[].country`	Text	Country of origin.Example: United States
Wine Name`wines[].wine_name`	Text	Wine name.Example: Cabernet Sauvignon
Wine Type`wines[].wine_type`	Text	Wine type, such as Red or Sparkling.Example: Red
Vivino Link`wines[].vivino_link`	Text	Wine page on Vivino.Example: https://www.vivino.com/en/caymus-vineyards-cabernet-sauvignon/w/66284?year=2021
Vintage Year`wines[].vintage_year`	Number	Vintage year when known.Example: 2021
Currency Code`wines[].currency_code`	Text	Currency for the displayed price, normally USD.Example: USD
Typical Price`wines[].typical_price`	Number	Price shown for US visitors, when available.Example: 94
Average Rating`wines[].average_rating`	Number	Average Vivino rating out of 5.Example: 4.4
Vivino Wine ID`wines[].vivino_wine_id`	Number	Vivino wine identifier.Example: 66284
Bottle Photo Link`wines[].bottle_photo_link`	Text	Bottle photo link, when available.Example: https://images.vivino.com/thumbs/y8_QSo4LQLOs3xzY-0LvUA_pb_x600.png
Number of Ratings`wines[].number_of_ratings`	Number	Number of Vivino ratings.Example: 3917

Example result

For Wine: Caymus Cabernet Sauvignon, Vintage: 2021, Max Results: 10

JSON

{
  "wines": [
    {
      "region": "Napa Valley",
      "winery": "Caymus Vineyards",
      "country": "United States",
      "wine_name": "Cabernet Sauvignon",
      "wine_type": "Red",
      "vivino_link": "https://www.vivino.com/en/caymus-vineyards-cabernet-sauvignon/w/66284?year=2021",
      "vintage_year": 2021,
      "currency_code": "USD",
      "typical_price": 94,
      "average_rating": 4.4,
      "vivino_wine_id": 66284,
      "bottle_photo_link": "https://images.vivino.com/thumbs/y8_QSo4LQLOs3xzY-0LvUA_pb_x600.png",
      "number_of_ratings": 3917
    }
  ]
}

For developers

Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.

cURL

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@vivino",
  "visibility": "public",
  "operation": "list_recommended_wines",
  "version": 1,
  "input": {
    "max_price": 30,
    "wine_type": "white",
    "min_rating": 3.5,
    "max_results": 30
  },
  "response": {
    "format": "json"
  }
}'

What you can do with it

Compare ratings for wines with similar names.
Find a wine’s origin, winery, and vintage.
Explore top-rated wines within a bottle budget.
Filter recommendations by grape variety or country.
Review available bottle prices and rating counts.

Questions about Vivino

Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

Can I call this Vivino tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

Do I need a Vivino account?

No. You only need a Fous account.

How current is the data?

Fous gets the data from vivino.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.