---
type: "firecrawl-provider"
description: "Vivino (vivino.com) wine discovery: keyword search over the whole wine catalogue, filtered explore by type, origin, grape, rating and price, wine and vintage details with grapes, style, taste profile and food pairings, community reviews, and the ship-to market's offer price. Defaults to the United States (USD); 13 other Vivino markets are selectable with ship_to."
use_when: "Vivino (vivino.com) wine discovery: keyword search over the whole wine catalogue, filtered explore by type, origin, grape, rating and price, wine and vintage details with grapes, style, taste profile and food pairings, community reviews, and the ship-to market's offer price. Defaults to the United States (USD); 13 other Vivino markets are selectable with ship_to."
categories: "Retail"
capabilities: 4
credits_per_call: 5
---
# Vivino on Firecrawl Alexandria

Vivino (vivino.com) wine discovery: keyword search over the whole wine catalogue, filtered explore by type, origin, grape, rating and price, wine and vintage details with grapes, style, taste profile and food pairings, community reviews, and the ship-to market's offer price. Defaults to the United States (USD); 13 other Vivino markets are selectable with ship_to.

- Categories: Retail
- Category index: [Retail category](https://firecrawl.dev/alexandria/agents/categories/retail)
- Provider key: `vivino-com`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/vivino-com)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/vivino-com/openapi.json)

## Capabilities

- [Explore](https://firecrawl.dev/alexandria/agents/providers/vivino-com/products/explore): Filtered wine discovery like Vivino's explore page: vintages offered in the ship-to market, filtered by wine type, country of origin, grape, minimum rating and price range, sorted by rating, popularity, price or discount. 24 vintages per page with winery, region, rating, ratings count and the offer price, bottle size and merchant link.
- [Reviews](https://firecrawl.dev/alexandria/agents/providers/vivino-com/products/reviews): Community reviews of a wine, optionally of one vintage year: rating, text, language, date, reviewer name and the reviewed vintage, in the site's default order, up to 50 per page.
- [Search](https://firecrawl.dev/alexandria/agents/providers/vivino-com/products/search): Keyword search over Vivino's whole wine catalogue (wine, winery, region or grape words) through the site's own search index: 24 wines per page with winery, region, country, type, average rating across vintages and, when the ship-to market offers the wine, its price and currency. Wines without an offer in the market are still listed with a null price. Default market US (USD).
- [Wine](https://firecrawl.dev/alexandria/agents/providers/vivino-com/products/wine): One wine or vintage by Vivino wine id (optionally with a year), vintage id or wine page URL: winery, region, country, wine type, style, grapes, food pairings, alcohol, description, vintage and wine ratings, drinking window, the community taste profile (acidity, sweetness, tannin, intensity, fizziness and flavour groups), the vintages Vivino lists, and the ship-to market's cheapest offer.

## 1. Choose this provider when

Vivino (vivino.com) wine discovery: keyword search over the whole wine catalogue, filtered explore by type, origin, grape, rating and price, wine and vintage details with grapes, style, taste profile and food pairings, community reviews, and the ship-to market's offer price. Defaults to the United States (USD); 13 other Vivino markets are selectable with ship_to.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "vivino-com",
  "capability": "products/explore",
  "options": {
    "countries": [
      "IT"
    ],
    "grapes": [
      "Pinot Noir"
    ],
    "min_rating": 4,
    "price_max": 40,
    "price_min": 10,
    "wine_types": [
      "red"
    ]
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `countries` (string[]): Countries of origin as ISO 3166-1 alpha-2 codes, for example IT, FR, ES. Example: `[]`
- `grapes` (string[]): Grape names as Vivino lists them, for example `Pinot Noir`, `Nebbiolo`, `Syrah`. Unknown names are rejected. Example: `["Pinot Noir"]`
- `min_rating` (number): Minimum average rating, for example 4 or 4.2. Example: `5`
- `page` (number): 1-based page of 24 vintages. Example: `1`
- `price_max` (number): Maximum bottle price in the ship-to market's currency. Example: `10`
- `price_min` (number): Minimum bottle price in the ship-to market's currency. Example: `10`
- `ship_to` (string): Ship-to market whose offers and prices are shown, as Vivino's market switch supports it. Default US (prices in USD). Currencies: USD for US; EUR for NL, BE, DE, FR, IT, ES and AT; DKK, SEK, CHF, GBP, CAD and AUD for DK, SE, CH, GB, CA and AU. Example: `US`
- `sort` (string): `rating` (highest average first), `popularity` (most ratings), `price_asc`, `price_desc` or `discount` (largest discount first). Example: `rating`
- `wine_types` (string[]): Any of these wine types. Example: `[]`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "vivino-com",
    capability: "products/explore",
    options: {
      countries: [
        "IT",
      ],
      grapes: [
        "Pinot Noir",
      ],
      min_rating: 4,
      price_max: 40,
      price_min: 10,
      wine_types: [
        "red",
      ],
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "vivino-com",
  "capability": "products/explore",
  "options": {
    "countries": [
      "IT"
    ],
    "grapes": [
      "Pinot Noir"
    ],
    "min_rating": 4,
    "price_max": 40,
    "price_min": 10,
    "wine_types": [
      "red"
    ]
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "vivino-com",
    "capability": "products/explore",
    "options": {
      "countries": [
        "IT"
      ],
      "grapes": [
        "Pinot Noir"
      ],
      "min_rating": 4,
      "price_max": 40,
      "price_min": 10,
      "wine_types": [
        "red"
      ]
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'vivino-com/products/explore' \
  --options '{"countries":["IT"],"grapes":["Pinot Noir"],"min_rating":4,"price_max":40,"price_min":10,"wine_types":["red"]}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "vivino-com",
  "capability": "products/explore",
  "options": {
    "countries": [
      "IT"
    ],
    "grapes": [
      "Pinot Noir"
    ],
    "min_rating": 4,
    "price_max": 40,
    "price_min": 10,
    "wine_types": [
      "red"
    ]
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "vivino-com",
  "capability": "products/explore",
  "options": {
    "countries": [
      "IT"
    ],
    "grapes": [
      "Pinot Noir"
    ],
    "min_rating": 4,
    "price_max": 40,
    "price_min": 10,
    "wine_types": [
      "red"
    ]
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "count": 6,
  "currency": "USD",
  "next": {
    "countries": [
      "IT"
    ],
    "grapes": [
      "Pinot Noir"
    ],
    "min_rating": 4,
    "page": 2,
    "price_max": 40,
    "price_min": 10,
    "ship_to": "US",
    "sort": "rating",
    "wine_types": [
      "red"
    ]
  },
  "observed_at_ms": 1792800000000,
  "page": 1,
  "page_size": 24,
  "results": [
    {
      "country": "IT",
      "name": "Àgole Pinot Nero",
      "price": {
        "amount": 35.95,
        "bottle_ml": 750,
        "currency": "USD",
        "discounted_from": null,
        "offer_url": "https://www.capitalfinewine.com/products/corvee-agole-pinot-nero-2019-750ml",
        "vintage_id": 168984891,
        "year": 2019
      },
      "rating": 4.1,
      "ratings_count": 27,
      "region": "Trentino",
      "url": "https://www.vivino.com/w/6883800?year=2019",
      "vintage_id": 168984891,
      "wine_id": 6883800,
      "wine_type": "red",
      "winery": "Corvée",
      "winery_id": 234192,
      "year": 2019
    },
    {
      "country": "IT",
      "name": "Turmhof Blauburgunder",
      "price": {
        "amount": 35.95,
        "bottle_ml": 750,
        "currency": "USD",
        "discounted_from": null,
        "offer_url": "https://www.capitalfinewine.com/products/tiefenbrunner-pinot-nero-2022-750ml",
        "vintage_id": 174339404,
        "year": 2022
      },
      "rating": 4,
      "ratings_count": 238,
      "region": "Südtirol - Alto Adige",
      "url": "https://www.vivino.com/w/15899?year=2022",
      "vintage_id": 174339404,
      "wine_id": 15899,
      "wine_type": "red",
      "winery": "Tiefenbrunner",
      "winery_id": 4274,
      "year": 2022
    },
    {
      "country": "IT",
      "name": "Ta Da!",
      "price": {
        "amount": 30.6,
        "bottle_ml": 750,
        "currency": "USD",
        "discounted_from": null,
        "offer_url": "https://littlewestwine.com/products/iuli-vino-rosso-ta-da-2023",
        "vintage_id": 177434518,
        "year": 2023
      },
      "rating": 4,
      "ratings_count": 207,
      "region": "Piemonte",
      "url": "https://www.vivino.com/w/9683626?year=2023",
      "vintage_id": 177434518,
      "wine_id": 9683626,
      "wine_type": "red",
      "winery": "Iuli",
      "winery_id": 36078,
      "year": 2023
    }
  ],
  "ship_to": "US",
  "sort": "rating",
  "total": 24
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Explore

- Capability: `products/explore`
- Description: Filtered wine discovery like Vivino's explore page: vintages offered in the ship-to market, filtered by wine type, country of origin, grape, minimum rating and price range, sorted by rating, popularity, price or discount. 24 vintages per page with winery, region, rating, ratings count and the offer price, bottle size and merchant link.
- Instructions: The main way to find wine to buy: a red from Italy rated 4+ under 30 dollars, the best value Riesling, the cheapest champagne rated above 4.
- Cost: 5 credits per call
- Capability file: [Explore](https://firecrawl.dev/alexandria/agents/providers/vivino-com/products/explore)

Accepted options:
- `countries` (string[]): Countries of origin as ISO 3166-1 alpha-2 codes, for example IT, FR, ES. Example: `[]`
- `grapes` (string[]): Grape names as Vivino lists them, for example `Pinot Noir`, `Nebbiolo`, `Syrah`. Unknown names are rejected. Example: `["Pinot Noir"]`
- `min_rating` (number): Minimum average rating, for example 4 or 4.2. Example: `5`
- `page` (number): 1-based page of 24 vintages. Example: `1`
- `price_max` (number): Maximum bottle price in the ship-to market's currency. Example: `10`
- `price_min` (number): Minimum bottle price in the ship-to market's currency. Example: `10`
- `ship_to` (string): Ship-to market whose offers and prices are shown, as Vivino's market switch supports it. Default US (prices in USD). Currencies: USD for US; EUR for NL, BE, DE, FR, IT, ES and AT; DKK, SEK, CHF, GBP, CAD and AUD for DK, SE, CH, GB, CA and AU. Example: `US`
- `sort` (string): `rating` (highest average first), `popularity` (most ratings), `price_asc`, `price_desc` or `discount` (largest discount first). Example: `rating`
- `wine_types` (string[]): Any of these wine types. Example: `[]`

Response schema example:
```json
{
  "count": 6,
  "currency": "USD",
  "next": {
    "countries": [
      "IT"
    ],
    "grapes": [
      "Pinot Noir"
    ],
    "min_rating": 4,
    "page": 2,
    "price_max": 40,
    "price_min": 10,
    "ship_to": "US",
    "sort": "rating",
    "wine_types": [
      "red"
    ]
  },
  "observed_at_ms": 1792800000000,
  "page": 1,
  "page_size": 24,
  "results": [
    {
      "country": "IT",
      "name": "Àgole Pinot Nero",
      "price": {
        "amount": 35.95,
        "bottle_ml": 750,
        "currency": "USD",
        "discounted_from": null,
        "offer_url": "https://www.capitalfinewine.com/products/corvee-agole-pinot-nero-2019-750ml",
        "vintage_id": 168984891,
        "year": 2019
      },
      "rating": 4.1,
      "ratings_count": 27,
      "region": "Trentino",
      "url": "https://www.vivino.com/w/6883800?year=2019",
      "vintage_id": 168984891,
      "wine_id": 6883800,
      "wine_type": "red",
      "winery": "Corvée",
      "winery_id": 234192,
      "year": 2019
    },
    {
      "country": "IT",
      "name": "Turmhof Blauburgunder",
      "price": {
        "amount": 35.95,
        "bottle_ml": 750,
        "currency": "USD",
        "discounted_from": null,
        "offer_url": "https://www.capitalfinewine.com/products/tiefenbrunner-pinot-nero-2022-750ml",
        "vintage_id": 174339404,
        "year": 2022
      },
      "rating": 4,
      "ratings_count": 238,
      "region": "Südtirol - Alto Adige",
      "url": "https://www.vivino.com/w/15899?year=2022",
      "vintage_id": 174339404,
      "wine_id": 15899,
      "wine_type": "red",
      "winery": "Tiefenbrunner",
      "winery_id": 4274,
      "year": 2022
    },
    {
      "country": "IT",
      "name": "Ta Da!",
      "price": {
        "amount": 30.6,
        "bottle_ml": 750,
        "currency": "USD",
        "discounted_from": null,
        "offer_url": "https://littlewestwine.com/products/iuli-vino-rosso-ta-da-2023",
        "vintage_id": 177434518,
        "year": 2023
      },
      "rating": 4,
      "ratings_count": 207,
      "region": "Piemonte",
      "url": "https://www.vivino.com/w/9683626?year=2023",
      "vintage_id": 177434518,
      "wine_id": 9683626,
      "wine_type": "red",
      "winery": "Iuli",
      "winery_id": 36078,
      "year": 2023
    }
  ],
  "ship_to": "US",
  "sort": "rating",
  "total": 24
}
```

### Reviews

- Capability: `products/reviews`
- Description: Community reviews of a wine, optionally of one vintage year: rating, text, language, date, reviewer name and the reviewed vintage, in the site's default order, up to 50 per page.
- Instructions: What drinkers say about a wine found with `search`, `explore` or `wine`.
- Cost: 5 credits per call
- Capability file: [Reviews](https://firecrawl.dev/alexandria/agents/providers/vivino-com/products/reviews)

Accepted options:
- `page` (number): page Example: `1`
- `per_page` (number): per_page Example: `10`
- `url` (string): A vivino.com wine page URL; its `?year=` selects the vintage. Example: `?year=`
- `wine_id` (number): wine_id Example: `10`
- `year` (number): Only reviews of this vintage. Example: `1800`

Response schema example:
```json
{
  "count": 10,
  "next": {
    "page": 2,
    "per_page": 10,
    "wine_id": 1127795
  },
  "observed_at_ms": 1792800000000,
  "page": 1,
  "per_page": 10,
  "reviews": [
    {
      "created_at": "2026-06-04T02:29:37.000Z",
      "id": 358035141,
      "language": "en",
      "note": "I gave Rod this bottle as a house warming gift was back in the early 90's. I hope he enjoyed it. Its a 1st growth Bordeaux bombshell.",
      "rating": 4.6,
      "user": "351dc sands",
      "vintage_id": 1510407,
      "year": null
    },
    {
      "created_at": "2021-08-11T02:31:06.000Z",
      "id": 214317811,
      "language": "en",
      "note": "1970 Margaux. An opportunity to taste history. Still had some structure and fruit. Long finish, leathery and concentrated. Brownish tint at the edges of the glass, sherry smell in the glass",
      "rating": 5,
      "user": "Dan Moccia-Field",
      "vintage_id": 1510407,
      "year": null
    },
    {
      "created_at": "2022-08-05T16:31:33.000Z",
      "id": 251169084,
      "language": "en",
      "note": "Vintage 1996 4.6pt\nquick notes\n3hours in decanter\nH intensity with blackcurrant lavender liqourice leather aromas\nDry,M+ acidity,\nM- tannic soft,\nM body,\nM+ flavour intensity, \nM alcohol,\nM+ finish.\nBenjamin Chan",
      "rating": 4.6,
      "user": "Benjamin Chan",
      "vintage_id": 1510407,
      "year": null
    }
  ],
  "wine_id": 1127795,
  "year": null
}
```

### Search

- Capability: `products/search`
- Description: Keyword search over Vivino's whole wine catalogue (wine, winery, region or grape words) through the site's own search index: 24 wines per page with winery, region, country, type, average rating across vintages and, when the ship-to market offers the wine, its price and currency. Wines without an offer in the market are still listed with a null price. Default market US (USD).
- Instructions: Finding a specific wine or producer by name and getting its `wine_id` for `wine` and `reviews`. For browsing what to buy by type, origin, grape, rating or price use `explore`.
- Cost: 5 credits per call
- Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/vivino-com/products/search)

Accepted options:
- `page` (number): 1-based page of 24 wines; the index serves at most 42 pages. Example: `1`
- `query` (string, required): Wine, winery, region or grape words, for example `chateau margaux`, `barolo` or `pinot noir`. Example: `chateau margaux`
- `ship_to` (string): Ship-to market whose offers and prices are shown, as Vivino's market switch supports it. Default US (prices in USD). Currencies: USD for US; EUR for NL, BE, DE, FR, IT, ES and AT; DKK, SEK, CHF, GBP, CAD and AUD for DK, SE, CH, GB, CA and AU. Example: `US`

Response schema example:
```json
{
  "count": 24,
  "currency": "USD",
  "next": {
    "page": 2,
    "query": "chateau margaux",
    "ship_to": "US"
  },
  "observed_at_ms": 1792800000000,
  "page": 1,
  "page_size": 24,
  "pages": 20,
  "query": "chateau margaux",
  "results": [
    {
      "country": "FR",
      "name": "Château Giscours (Grand Cru Classé)",
      "price": {
        "amount": 97.99,
        "bottle_ml": null,
        "currency": "USD",
        "discounted_from": null,
        "offer_url": null,
        "vintage_id": 156145340,
        "year": 2018
      },
      "rating": 4.3,
      "ratings_count": 57794,
      "region": "Margaux",
      "url": "https://www.vivino.com/w/13689",
      "vintage_id": 1852703,
      "wine_id": 13689,
      "wine_type": "red",
      "winery": "Château Giscours",
      "winery_id": 4293,
      "year": null
    },
    {
      "country": "FR",
      "name": "Château Margaux (Premier Grand Cru Classé)",
      "price": {
        "amount": 625,
        "bottle_ml": null,
        "currency": "USD",
        "discounted_from": null,
        "offer_url": null,
        "vintage_id": 4732791,
        "year": 2014
      },
      "rating": 4.6,
      "ratings_count": 57103,
      "region": "Margaux",
      "url": "https://www.vivino.com/w/1127795",
      "vintage_id": 1510407,
      "wine_id": 1127795,
      "wine_type": "red",
      "winery": "Château Margaux",
      "winery_id": 1319,
      "year": null
    },
    {
      "country": "FR",
      "name": "Margaux (Grand Cru Classé)",
      "price": {
        "amount": 69.94,
        "bottle_ml": null,
        "currency": "USD",
        "discounted_from": null,
        "offer_url": null,
        "vintage_id": 167297090,
        "year": 2021
      },
      "rating": 4.2,
      "ratings_count": 30022,
      "region": "Margaux",
      "url": "https://www.vivino.com/w/80045",
      "vintage_id": 1487434,
      "wine_id": 80045,
      "wine_type": "red",
      "winery": "Château Lascombes",
      "winery_id": 11272,
      "year": null
    },
    {
      "country": "FR",
      "name": "Margaux (Grand Cru Classé)",
      "price": {
        "amount": 67.99,
        "bottle_ml": null,
        "currency": "USD",
        "discounted_from": null,
        "offer_url": null,
        "vintage_id": 162936936,
        "year": 2020
      },
      "rating": 4.2,
      "ratings_count": 27525,
      "region": "Margaux",
      "url": "https://www.vivino.com/w/736114",
      "vintage_id": 1536962,
      "wine_id": 736114,
      "wine_type": "red",
      "winery": "Château Prieuré-Lichine",
      "winery_id": 1237,
      "year": null
    },
    {
      "country": "FR",
      "name": "Margaux (Grand Cru Classé)",
      "price": {
        "amount": 55.99,
        "bottle_ml": null,
        "currency": "USD",
        "discounted_from": null,
        "offer_url": null,
        "vintage_id": 150824898,
        "year": 2017
      },
      "rating": 4.2,
      "ratings_count": 28668,
      "region": "Margaux",
      "url": "https://www.vivino.com/w/85917",
      "vintage_id": 1509827,
      "wine_id": 85917,
      "wine_type": "red",
      "winery": "Château du Tertre",
      "winery_id": 1463,
      "year": null
    },
    {
      "country": "FR",
      "name": "Margaux",
      "price": {
        "amount": 35.08,
        "bottle_ml": null,
        "currency": "USD",
        "discounted_from": null,
        "offer_url": null,
        "vintage_id": 170485046,
        "year": 2022
      },
      "rating": 4,
      "ratings_count": 15411,
      "region": "Margaux",
      "url": "https://www.vivino.com/w/1369753",
      "vintage_id": 3524584,
      "wine_id": 1369753,
      "wine_type": "red",
      "winery": "Château d'Arsac",
      "winery_id": 3442,
      "year": null
    },
    {
      "country": "FR",
      "name": "Margaux (Grand Cru Classé)",
      "price": {
        "amount": 103.24,
        "bottle_ml": null,
        "currency": "USD",
        "discounted_from": null,
        "offer_url": null,
        "vintage_id": 160137317,
        "year": 2019
      },
      "rating": 4.2,
      "ratings_count": 30550,
      "region": "Margaux",
      "url": "https://www.vivino.com/w/23769",
      "vintage_id": 1477151,
      "wine_id": 23769,
      "wine_type": "red",
      "winery": "Château Brane-Cantenac",
      "winery_id": 8023,
      "year": null
    },
    {
      "country": "FR",
      "name": "Grand Vin de Château Palmer (Grand Cru Classé)",
      "price": {
        "amount": 231,
        "bottle_ml": null,
        "currency": "USD",
        "discounted_from": null,
        "offer_url": null,
        "vintage_id": 150345939,
        "year": 2017
      },
      "rating": 4.5,
      "ratings_count": 36285,
      "region": "Margaux",
      "url": "https://www.vivino.com/w/9220",
      "vintage_id": 1510827,
      "wine_id": 9220,
      "wine_type": "red",
      "winery": "Chateau Palmer",
      "winery_id": 1376,
      "year": null
    },
    {
      "country": "FR",
      "name": "Margaux (Grand Cru Classé)",
      "price": {
        "amount": 77.090836,
        "bottle_ml": null,
        "currency": "USD",
        "discounted_from": null,
        "offer_url": null,
        "vintage_id": 167216781,
        "year": 2021
      },
      "rating": 4.2,
      "ratings_count": 23087,
      "region": "Margaux",
      "url": "https://www.vivino.com/w/81864",
      "vintage_id": 1568557,
      "wine_id": 81864,
      "wine_type": "red",
      "winery": "Château Cantenac Brown",
      "winery_id": 11458,
      "year": null
    },
    {
      "country": "FR",
      "name": "Margaux",
      "price": {
        "amount": 49.3,
        "bottle_ml": null,
        "currency": "USD",
        "discounted_from": null,
        "offer_url": null,
        "vintage_id": 150923168,
        "year": 2017
      },
      "rating": 4.1,
      "ratings_count": 20635,
      "region": "Margaux",
      "url": "https://www.vivino.com/w/91020",
      "vintage_id": 1581213,
      "wine_id": 91020,
      "wine_type": "red",
      "winery": "Château Labégorce",
      "winery_id": 2889,
      "year": null
    }
  ],
  "ship_to": "US",
  "total": 457,
  "total_exact": false
}
```

### Wine

- Capability: `products/wine`
- Description: One wine or vintage by Vivino wine id (optionally with a year), vintage id or wine page URL: winery, region, country, wine type, style, grapes, food pairings, alcohol, description, vintage and wine ratings, drinking window, the community taste profile (acidity, sweetness, tannin, intensity, fizziness and flavour groups), the vintages Vivino lists, and the ship-to market's cheapest offer.
- Instructions: Details on a wine found with `search` or `explore`, or on a pasted Vivino wine URL.
- Cost: 5 credits per call
- Capability file: [Wine](https://firecrawl.dev/alexandria/agents/providers/vivino-com/products/wine)

Accepted options:
- `ship_to` (string): Ship-to market whose offers and prices are shown, as Vivino's market switch supports it. Default US (prices in USD). Currencies: USD for US; EUR for NL, BE, DE, FR, IT, ES and AT; DKK, SEK, CHF, GBP, CAD and AUD for DK, SE, CH, GB, CA and AU. Example: `US`
- `url` (string): A vivino.com wine page URL such as https://www.vivino.com/en/chateau-margaux-premier-grand-cru-classe/w/1127795?year=2015. Example: `<url>`
- `vintage_id` (number): Vivino vintage id (from `explore` rows). Example: `10`
- `wine_id` (number): Vivino wine id (from `search` or `explore`, or the number after `/w/` in a wine URL). Example: `10`
- `year` (number): Vintage year, with `wine_id` or `url`. Omit for the wine across all vintages. Example: `1800`

Response schema example:
```json
{
  "alcohol": 13,
  "country": {
    "code": "FR",
    "name": "France"
  },
  "currency": "USD",
  "description": null,
  "drinking_window": {
    "end_year": 2035,
    "start_year": 2020
  },
  "foods": [
    "Beef",
    "Lamb",
    "Poultry",
    "Game (deer, venison)"
  ],
  "grapes": [
    "Cabernet Sauvignon",
    "Cabernet Franc",
    "Merlot",
    "Petit Verdot"
  ],
  "name": "Château Margaux Château Margaux (Premier Grand Cru Classé) 2015",
  "observed_at_ms": 1792800000000,
  "price": {
    "amount": 2993,
    "bottle_ml": null,
    "currency": "USD",
    "discounted_from": null,
    "offer_url": null,
    "vintage_id": 14160272,
    "year": 2015
  },
  "rating": 4.6,
  "ratings_count": 325,
  "region": {
    "id": 384,
    "name": "Margaux"
  },
  "ship_to": "US",
  "style": {
    "acidity": "High",
    "body": "Full-bodied",
    "description": "Bordeaux Margaux wines tend to be deep ruby in color, perfumed and floral, particularly with notes of violets and lilacs, and soft, silky tannins.\n\nTypically less powerful than wines from other Bordeaux subregions, Margaux wines tend to be refined and elegant.\n\nMargaux is the furthest south appellation in the Médoc on Bordeaux's Left Bank and boasts many soil types, including limestone, chalk, clay, sand and gravel, meaning style and quality of Margaux can vary dramatically.\n\nThe best Margaux wines come from grapes planted on gravel soils with good drainage.",
    "id": 263,
    "name": "Bordeaux Margaux"
  },
  "taste": {
    "flavors": [
      {
        "group": "earth",
        "keywords": [
          "leather",
          "earthy",
          "smoke",
          "mushroom",
          "forest floor",
          "graphite",
          "truffle",
          "minerals",
          "pencil shavings",
          "game",
          "iron",
          "cocoa",
          "charcoal",
          "tar",
          "pencil lead",
          "stone",
          "balsamic",
          "ash",
          "dried leaves",
          "flint",
          "honey",
          "black truffle",
          "tobacco leaf",
          "cured meat",
          "slate",
          "chalk",
          "exotic spice",
          "saline",
          "smoked meats",
          "ginger",
          "grilled meat",
          "new leather",
          "petroleum",
          "underbrush",
          "rubber",
          "ground coffee",
          "kerosene",
          "oolong tea",
          "pastrami",
          "roasted meat",
          "salt",
          "wax",
          "wet gravel",
          "tobacco",
          "dark chocolate",
          "savory",
          "mocha",
          "almond",
          "marzipan",
          "allspice",
          "hoisin"
        ],
        "mentions": 2358
      },
      {
        "group": "oak",
        "keywords": [
          "tobacco",
          "oak",
          "cedar",
          "vanilla",
          "chocolate",
          "coffee",
          "cigar box",
          "cigar",
          "clove",
          "dark chocolate",
          "caramel",
          "mocha",
          "sweet tobacco",
          "sandalwood",
          "nutmeg",
          "butter",
          "espresso",
          "baking spice",
          "toffee",
          "incense",
          "camphor",
          "cola",
          "milk chocolate",
          "allspice",
          "pastry",
          "leather",
          "smoke",
          "cinnamon",
          "cocoa",
          "charcoal",
          "ash",
          "almond",
          "tobacco leaf",
          "hazelnut",
          "marzipan",
          "rooibos",
          "vanilla bean",
          "brioche"
        ],
        "mentions": 2290
      },
      {
        "group": "black_fruit",
        "keywords": [
          "cassis",
          "blackberry",
          "plum",
          "black fruit",
          "blackcurrant",
          "dark fruit",
          "black cherry",
          "blueberry",
          "jam",
          "black plum",
          "black olive",
          "bramble",
          "mulberry",
          "boysenberry",
          "ripe blackberry",
          "berry jam",
          "blackberry jam",
          "blackcurrant jam",
          "hoisin",
          "olive tapenade",
          "sour plum",
          "prune"
        ],
        "mentions": 1884
      },
      {
        "group": "red_fruit",
        "keywords": [
          "cherry",
          "red fruit",
          "raspberry",
          "red currant",
          "strawberry",
          "red cherry",
          "cranberry",
          "red plum",
          "pomegranate",
          "sour cherry",
          "wild strawberry",
          "bing cherry",
          "cotton candy",
          "maraschino cherry",
          "ripe strawberry",
          "dried strawberry",
          "fresh strawberry",
          "morello cherry",
          "black cherry",
          "jam"
        ],
        "mentions": 607
      },
      {
        "group": "spices",
        "keywords": [
          "pepper",
          "licorice",
          "mint",
          "cinnamon",
          "eucalyptus",
          "savory",
          "dried herbs",
          "anise",
          "menthol",
          "sage",
          "musk",
          "bay leaf",
          "star anise",
          "green herbs",
          "thyme",
          "oregano",
          "white pepper",
          "aniseed",
          "fennel",
          "juniper",
          "coriander",
          "rooibos",
          "vanilla bean",
          "rosemary",
          "bergamot",
          "black licorice",
          "lemon grass",
          "vanilla",
          "clove",
          "nutmeg",
          "ginger"
        ],
        "mentions": 570
      },
      {
        "group": "floral",
        "keywords": [
          "violet",
          "perfume",
          "rose petal",
          "lavender",
          "dried flowers",
          "dried rose",
          "potpourri",
          "acacia",
          "lily",
          "jasmine",
          "lilac",
          "hibiscus",
          "honeysuckle",
          "apple blossom",
          "peony",
          "rose hip",
          "rose water",
          "savory"
        ],
        "mentions": 321
      },
      {
        "group": "dried_fruit",
        "keywords": [
          "prune",
          "raisin",
          "dried fruit",
          "fig",
          "black raisin",
          "dried cranberry",
          "dried apricot",
          "dried blackberry",
          "dried blueberry",
          "jam",
          "dried strawberry"
        ],
        "mentions": 153
      },
      {
        "group": "vegetal",
        "keywords": [
          "grass",
          "hay",
          "bell pepper",
          "green bell pepper",
          "bitter almond",
          "tomato leaf",
          "celery",
          "gooseberry",
          "tomato",
          "asparagus",
          "earl grey tea",
          "straw",
          "sun-dried tomato",
          "savory",
          "dried leaves",
          "almond",
          "tobacco leaf"
        ],
        "mentions": 105
      },
      {
        "group": "non_oak",
        "keywords": [
          "toast",
          "almond",
          "dried fig",
          "nutty",
          "hazelnut",
          "chestnut",
          "marzipan",
          "molasses",
          "walnut",
          "peanut",
          "biscuit",
          "black walnut",
          "brioche",
          "roasted almond",
          "teriyaki",
          "toasted almond",
          "tobacco",
          "cedar",
          "smoke",
          "vanilla",
          "coffee",
          "clove",
          "cinnamon",
          "caramel",
          "fig",
          "mocha",
          "sweet tobacco",
          "nutmeg",
          "espresso",
          "bitter almond",
          "dried leaves",
          "incense",
          "tobacco leaf",
          "cola",
          "allspice"
        ],
        "mentions": 82
      },
      {
        "group": "microbio",
        "keywords": [
          "cream",
          "cheese",
          "banana",
          "oil",
          "sweaty",
          "sweaty saddle",
          "toasted bread",
          "yeast",
          "yogurt",
          "mushroom",
          "truffle",
          "toast",
          "butter",
          "toffee",
          "almond",
          "cured meat"
        ],
        "mentions": 75
      },
      {
        "group": "citrus_fruit",
        "keywords": [
          "orange",
          "citrus",
          "orange peel",
          "tangerine",
          "lime",
          "orange rind",
          "lemon",
          "marmalade",
          "orange zest"
        ],
        "mentions": 51
      },
      {
        "group": "tree_fruit",
        "keywords": [
          "apple",
          "apricot",
          "pear",
          "stone fruit",
          "peach",
          "green apple"
        ],
        "mentions": 25
      },
      {
        "group": "tropical_fruit",
        "keywords": [
          "mango",
          "bubblegum",
          "green pineapple",
          "guava",
          "tropical",
          "banana"
        ],
        "mentions": 8
      }
    ],
    "structure": {
      "acidity": 4.1368055,
      "fizziness": null,
      "intensity": 3.664984,
      "sweetness": 1.6244102,
      "tannin": 3.8054204
    }
  },
  "url": "https://www.vivino.com/w/1127795?year=2015",
  "vintage_id": 14160272,
  "vintages": [
    {
      "vintage_id": 182641129,
      "year": 2025
    },
    {
      "vintage_id": 179625927,
      "year": 2024
    },
    {
      "vintage_id": 173641507,
      "year": 2023
    },
    {
      "vintage_id": 170423040,
      "year": 2022
    },
    {
      "vintage_id": 167204740,
      "year": 2021
    },
    {
      "vintage_id": 162926101,
      "year": 2020
    },
    {
      "vintage_id": 159350751,
      "year": 2019
    },
    {
      "vintage_id": 156129627,
      "year": 2018
    },
    {
      "vintage_id": 150279592,
      "year": 2017
    },
    {
      "vintage_id": 85179083,
      "year": 2016
    },
    {
      "vintage_id": 14160272,
      "year": 2015
    },
    {
      "vintage_id": 4732791,
      "year": 2014
    }
  ],
  "wine_id": 1127795,
  "wine_name": "Château Margaux (Premier Grand Cru Classé)",
  "wine_rating": 4.6,
  "wine_ratings_count": 57124,
  "wine_type": "red",
  "winery": {
    "id": 1319,
    "name": "Château Margaux"
  },
  "year": 2015
}
```
