All providers
Sign in
Sign up to use Vivino
Firecrawl Alexandria
Retail

Vivino

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.

Try in Agent
Find a red Italian Pinot Noir rated 4 or higher under 40 dollars that I can buy in the US.

Try Vivino now.

Choose an example or ask your own question.

Vivino
TRY ASKING
1Request
string[]

Countries of origin as ISO 3166-1 alpha-2 codes, for example IT, FR, ES. Separate values with commas.

string[]

Grape names as Vivino lists them, for example `Pinot Noir`, `Nebbiolo`, `Syrah`. Unknown names are rejected. Separate values with commas.

number

Minimum average rating, for example 4 or 4.2.

number

Maximum bottle price in the ship-to market's currency.

number

Minimum bottle price in the ship-to market's currency.

string[]

Any of these wine types. Separate values with commas.

5 credits
Codefollows the fields above
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",
      ],
    },
  },
});
2Response example

This is a sample shape. Press Run to see live data from Vivino.

{
  "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
}

Related providers

Browse the library