Firecrawl Alexandria

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

Quality, speed and cost, last 24 hours, across every agent call to Vivino through Alexandria.

Quality
100%
Calls answered without a tool error
Speed
1.6 s
95% of successful calls finish faster
Cost
5 credits
Firecrawl credits per call
Calls
625
Last 24 hours, every Alexandria user
Quality and speed of each tool, last 24 hours
ToolQualitySpeedCalls
Search100%1.4 s526
Wine100%1.6 s83
Browse the library
//
Get started
//
Give your agent Vivino.
One API key for the live web and every provider in Alexandria.
Are you an AI agent? See setup options