Pricing

from $3.00 / 1,000 results

Vivino Scraper

Scrape Vivino - the world's largest wine app. Search wines by name, explore by type and country, look up wines by ID, or scrape all wines from a specific winery. Returns ratings, prices, grapes, tasting notes, food pairings, and more.

Pricing

from $3.00 / 1,000 results

Rating

0.0

(0)

Developer

Crawler Gang

Actor stats

Bookmarked

Total users

Monthly active users

5 days ago

Last modified

Categories

Automation

E-commerce

Integrations

You can access the Vivino Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "x-build-id": "P9wvmrgFp29ZAIpwd"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/crawlergang~vivino-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-crawlergang-vivino-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/crawlergang~vivino-scraper/runs": {
      "post": {
        "operationId": "runs-sync-crawlergang-vivino-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/crawlergang~vivino-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-crawlergang-vivino-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "explore",
              "byWineId",
              "winery"
            ],
            "type": "string",
            "description": "What to fetch. `search` runs a free-text query; `explore` browses wines by type, country or price range; `byWineId` fetches specific wines by Vivino vintage ID (from the vintageId field in search results, or from the URL vivino.com/vintages/{id}); `winery` scrapes all wines from a winery.",
            "default": "search"
          },
          "searchQuery": {
            "title": "Search query",
            "type": "string",
            "description": "Free-text wine search query (mode=search). Example: `barolo`, `chateau petrus`, `napa valley cabernet`.",
            "default": "barolo"
          },
          "wineIds": {
            "title": "Vivino Vintage IDs (mode=byWineId)",
            "type": "array",
            "description": "List of Vivino vintage IDs to look up (mode=byWineId). The ID appears in the vintage URL, e.g. https://www.vivino.com/vintages/18745256 → use 18745256. You can get these IDs from the vintageId field in search/explore results.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "wineryId": {
            "title": "Winery ID (mode=winery)",
            "minimum": 1,
            "type": "integer",
            "description": "Vivino winery ID (mode=winery). The ID appears in the winery's Vivino URL path."
          },
          "wineType": {
            "title": "Wine type filter",
            "enum": [
              "",
              "1",
              "2",
              "3",
              "4",
              "7",
              "24"
            ],
            "type": "string",
            "description": "Filter by wine type (applies to search and explore modes).",
            "default": ""
          },
          "country": {
            "title": "Country code filter",
            "enum": [
              "",
              "it",
              "fr",
              "us",
              "es",
              "de",
              "pt",
              "ar",
              "cl",
              "au",
              "nz",
              "za",
              "gr",
              "at",
              "hu",
              "ro",
              "hr",
              "bg",
              "si",
              "rs",
              "mk",
              "al",
              "ge",
              "am",
              "az",
              "md",
              "ua",
              "tr",
              "il",
              "lb",
              "cn",
              "jp",
              "in",
              "br",
              "mx",
              "ca",
              "gb"
            ],
            "type": "string",
            "description": "Filter wines by country of origin using 2-letter ISO country code (e.g. `it` for Italy, `fr` for France, `us` for USA). Case-insensitive.",
            "default": ""
          },
          "minRating": {
            "title": "Minimum rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Filter to wines with rating equal to or above this value (0–5 scale)."
          },
          "maxRating": {
            "title": "Maximum rating",
            "minimum": 0,
            "maximum": 5,
            "type": "number",
            "description": "Filter to wines with rating equal to or below this value (0–5 scale)."
          },
          "minPrice": {
            "title": "Minimum price (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Filter to wines priced at or above this value in USD."
          },
          "maxPrice": {
            "title": "Maximum price (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Filter to wines priced at or below this value in USD.",
            "default": 500
          },
          "orderBy": {
            "title": "Sort order",
            "enum": [
              "ratings_count",
              "ratings_average",
              "price"
            ],
            "type": "string",
            "description": "How to sort explore/search results.",
            "default": "ratings_count"
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "Maximum number of wine records to emit.",
            "default": 50
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Vivino Scraper OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Vivino Scraper from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Vivino Scraper API in Python

Vivino Scraper API in JavaScript

Vivino Scraper API through CLI

Vivino Scraper API

Vivino Scraper

crawlerbros/vivino-scraper

Crawler Bros

Vivino Scraper - Wines, Ratings, Reviews & Prices

scrapesage/vivino-scraper

Discover wines on Vivino by type, country, region, grape, price & rating: ratings, taste profile, flavor notes, food pairings, awards, critic & user reviews, live + median prices, and price/rating monitoring.

Scrape Sage

Vivino Wine Scraper $1.2💰 Ratings, Prices, Reviews & Offers

abotapi/vivino-wine-data-scraper

From $1.2/1K. Scrape Vivino.com for wine ratings, prices, taste profiles, food pairings, grapes, and reviews. Search by wine names or URLs, or discover wines by type, price, rating, country, and grape. Returns 50+ fields, including multi-merchant offers and value scores.

Abot API

Vivino Wine Ratings & Price Scraper

georgy.malanichev/vivino-wine-scraper

Extract wine ratings, prices, vintages, tasting notes, region data, and food pairings from Vivino's public API for wine retail and app development.

Georgy Malanichev

Vivino Product Search Scraper

stealth_mode/vivino-product-search-scraper

Extract wine product details from Vivino.com search results. Collect over 18 data fields per wine including ratings, prices, vintage, region, grapes, tasting notes, and winery info — perfect for wine retailers, researchers, and data analysts.

Stealth mode

Vivino Wine Scraper — Ratings, Reviews & Prices

bovi/vivino-wine-scraper

Scrape Vivino wine data by name: ratings, reviews, taste profile, food pairings, region, grapes, and live merchant price. One rich row per wine. No API key. Pay per result.

Vitalii Bondarev

Vivino Scraper

solidcode/vivino-scraper

[💰 $1.8 / 1K] Extract structured wine data from Vivino: name, winery, vintage, region, grape varieties, ratings, price, taste profile, food pairings, and optional user reviews. Search by keyword or paste wine URLs.

SolidCode

Vivino Scraper - Wine Ratings & Prices

lulzasaur/vivino-scraper

Scrape wine data from Vivino. Get ratings, prices, wineries, regions, grapes, and vintages. Filter by wine type, rating, price range, and country.

lulz bot

Wine Ratings Scraper

velvety_bedbug/wine-ratings-scraper

Scrape wine ratings data including winery, wine name, location, and Vivino ratings. Choose from reds, whites, sparkling, rosé, or dessert wines. Free API, no auth required.

Peters Bugs

Vivino MCP Server - AI Wine Recommendations

mrbridge/vivino-mcp-server

Connect AI assistants to Vivino wine data via MCP. Search wines, explore by rating, price and style, fetch details and recommend bottles for meals, budgets and occasions. Works with Claude Desktop, ChatGPT and any MCP-compatible client.