# Vivino API: List recommended wines

> Lists top-rated wines of a chosen type within a budget, from bottles offered in the United States, optionally limited to one grape and country of origin. Prices are in USD.

Unofficial. Not affiliated with or endorsed by Vivino.

- Page: https://fous.com/methods/vivino.com/list-recommended-wines
- Method: `vivino.com/list_recommended_wines`, version 1
- Website: vivino.com
- Returns: wine name, winery, vintage, region, country, average rating, number of ratings, price, bottle photo, Vivino link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `grape` | string | no |  | Grape variety, for example Pinot Noir. Omit for any grape. |
| `country` | string | no |  | Country of origin, for example Italy. Omit for any country. |
| `max_price` | number | no | `30` | Highest USD bottle price, for example 50. Omit for no practical price limit. |
| `wine_type` | string | yes | `"white"` | Wine type, for example red. One of "red", "white", "sparkling", "rose", "dessert", "fortified". |
| `min_rating` | number | no | `3.5` | Minimum average rating out of five, for example 4.0. Default 3.5. |
| `max_results` | integer | no | `30` | Maximum wines to return, for example 20 (up to 50). Default 20. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "max_price": 30,
  "wine_type": "white",
  "min_rating": 3.5,
  "max_results": 30
}
```

Its output:

```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
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"vivino.com/list_recommended_wines","input":{"max_price":30,"wine_type":"white","min_rating":3.5,"max_results":30}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find me some highly rated Malbecs from Argentina under $25 a bottle that I can buy in the US.
- What are the best-rated sparkling wines on Vivino for under $40, rated at least 4.0?
- I need a good dry rosé for a summer party, nothing over $20, any country is fine.
- Show me the top 10 Italian red wines made from Nebbiolo, priced up to $75, with ratings of 4.2 or higher.
- Looking for well-reviewed dessert wines available in the United States under $50 — pull the top picks from vivino.com with photos and links.

## Input schema

```json
{
  "type": "object",
  "required": [
    "wine_type"
  ],
  "properties": {
    "grape": {
      "type": "string",
      "description": "Grape variety, for example Pinot Noir. Omit for any grape."
    },
    "country": {
      "type": "string",
      "description": "Country of origin, for example Italy. Omit for any country."
    },
    "max_price": {
      "type": "number",
      "minimum": 0,
      "description": "Highest USD bottle price, for example 50. Omit for no practical price limit."
    },
    "wine_type": {
      "enum": [
        "red",
        "white",
        "sparkling",
        "rose",
        "dessert",
        "fortified"
      ],
      "type": "string",
      "description": "Wine type, for example red."
    },
    "min_rating": {
      "type": "number",
      "default": 3.5,
      "maximum": 5,
      "minimum": 1,
      "description": "Minimum average rating out of five, for example 4.0."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum wines to return, for example 20 (up to 50).",
      "x-fous-developer": true
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "wines"
  ],
  "properties": {
    "wines": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "wine_name",
          "winery",
          "vintage",
          "region",
          "country",
          "average_rating",
          "number_of_ratings",
          "price",
          "currency",
          "bottle_photo_link",
          "vivino_link"
        ],
        "properties": {
          "price": {
            "type": "number",
            "description": "Offered bottle price."
          },
          "region": {
            "type": [
              "string",
              "null"
            ],
            "description": "Wine region."
          },
          "winery": {
            "type": [
              "string",
              "null"
            ],
            "description": "Winery name."
          },
          "country": {
            "type": [
              "string",
              "null"
            ],
            "description": "Country of origin."
          },
          "vintage": {
            "type": [
              "string",
              "null"
            ],
            "description": "Vintage year or N.V. if available."
          },
          "currency": {
            "type": "string",
            "description": "Price currency code."
          },
          "wine_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name of the wine."
          },
          "vivino_link": {
            "type": "string",
            "description": "Wine page URL."
          },
          "average_rating": {
            "type": [
              "number",
              "null"
            ],
            "description": "Average rating out of five."
          },
          "bottle_photo_link": {
            "type": [
              "string",
              "null"
            ],
            "description": "Bottle image URL."
          },
          "number_of_ratings": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Number of ratings."
          }
        },
        "additionalProperties": false
      },
      "description": "Highest-rated matching wines first."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Vivino API: Search wines](https://fous.com/methods/vivino.com/search-wines.md): Finds Vivino wines matching a wine name (optionally with the winery and a vintage year), in Vivino relevance order, with ratings, vintage, origin, bottle photo and the US price when shown.
- [Vinted API: Search listings](https://fous.com/methods/vinted.com/search-listings.md): Searches public Vinted listings in one country with brand, size, condition, price and sorting filters. Returns up to 96 available items with seller usernames when the public profile is available.
- [Tripadvisor API: List top restaurants in a city](https://fous.com/methods/tripadvisor.com/list-top-restaurants.md): Lists Tripadvisor's ranked restaurants in a city from the first results page, optionally filtered by cuisine and price category. Sponsored listings are left out; up to 30 restaurants with rating, review count, cuisines, price range and address.
- [Viator API: Search tours](https://fous.com/methods/viator.com/search-tours.md): Finds tours and experiences in a city on Viator, with optional keywords, date, currency and sorting. Prices are starting prices.
- [Michelin API: Search Michelin Guide restaurants](https://fous.com/methods/guide.michelin.com/search-restaurants.md): Lists Michelin Guide restaurants in a city or region, in Guide order, optionally filtered by distinction and cuisine, with each restaurant's address, description and photo. Results may include the surrounding area as labeled by the Guide.
- [Chewy API: Search products](https://fous.com/methods/chewy.com/search-products.md): Search Chewy products by words, pet type, and sort order. Returns up to 72 products in Chewy's order, including listed and first-order Autoship prices when shown.
- [AliExpress API: Search products](https://fous.com/methods/aliexpress.com/search-products.md): Searches AliExpress listings by product words, shipping destination, price range and sort order. Unpriced promotional cards are omitted; free shipping is marked only when the listing explicitly says so.
- [IKEA API: Search products](https://fous.com/methods/ikea.com/search-products.md): Searches IKEA products in a chosen country and returns current prices, details, photos and reviews in IKEA's result order.
- [All Vivino methods](https://fous.com/methods/vivino.com.md)