# Vivino API: Search wines > 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. Unofficial. Not affiliated with or endorsed by Vivino. - Page: https://fous.com/methods/vivino.com/search-wines - Method: `vivino.com/search_wines`, version 1 - Website: vivino.com - Returns: wine name, winery, vintage, type, region, country, average rating, rating count, US price, bottle photo, Vivino link, wine ID - 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 3, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `wine` | string | yes | `"Dom Perignon"` | Wine name, optionally including the winery. For example, Caymus Cabernet Sauvignon. | | `vintage` | integer | no | | Only return this vintage year, for example 2021. Omit for all vintages. | | `max_results` | integer | no | `25` | Maximum wines to return, for example 10; default 10 and maximum 25. Default 10. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "wine": "Dom Perignon", "max_results": 25 } ``` Its output: ```json { "wines": [ { "region": "Champagne", "winery": "Dom Pérignon", "country": "France", "wine_name": "Brut Champagne", "wine_type": "Sparkling", "vivino_link": "https://www.vivino.com/en/dom-perignon-brut-champagne/w/86684?year=2009", "vintage_year": 2009, "currency_code": "USD", "typical_price": 664, "average_rating": 4.6, "vivino_wine_id": 86684, "bottle_photo_link": "https://images.vivino.com/thumbs/s5aXYaQiTu-V_xEYI3KXRg_pb_x600.png", "number_of_ratings": 16976 }, { "region": "Champagne", "winery": "Dom Pérignon", "country": "France", "wine_name": "Brut Champagne", "wine_type": "Sparkling", "vivino_link": "https://www.vivino.com/en/dom-perignon-brut-champagne/w/86684?year=1999", "vintage_year": 1999, "currency_code": "USD", "typical_price": 836, "average_rating": 4.6, "vivino_wine_id": 86684, "bottle_photo_link": "https://images.vivino.com/thumbs/s5aXYaQiTu-V_xEYI3KXRg_pb_x600.png", "number_of_ratings": 3508 }, { "region": "Champagne", "winery": "Dom Pérignon", "country": "France", "wine_name": "Brut Champagne", "wine_type": "Sparkling", "vivino_link": "https://www.vivino.com/en/dom-perignon-brut-champagne/w/86684?year=1993", "vintage_year": 1993, "currency_code": "USD", "typical_price": 606, "average_rating": 4.6, "vivino_wine_id": 86684, "bottle_photo_link": "https://images.vivino.com/thumbs/s5aXYaQiTu-V_xEYI3KXRg_pb_x600.png", "number_of_ratings": 1723 } ] } ``` ## 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/search_wines","input":{"wine":"Dom Perignon","max_results":25}}' ``` 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 - Look up Opus One 2018 on Vivino and tell me its average rating and how many people rated it - What's the US price and region for Cloudy Bay Sauvignon Blanc? Show me the top 5 matches - Find ratings for Château Montelena Chardonnay, 2019 vintage only - I'm holding a bottle of Duckhorn Merlot — pull up up to 15 Vivino listings with ratings, prices and bottle photos - Search for Whispering Angel rosé and give me the winery, country, rating count and link for each result ## Input schema ```json { "type": "object", "required": [ "wine" ], "properties": { "wine": { "type": "string", "minLength": 1, "description": "Wine name, optionally including the winery. For example, Caymus Cabernet Sauvignon." }, "vintage": { "type": "integer", "maximum": 2100, "minimum": 1800, "description": "Only return this vintage year, for example 2021. Omit for all vintages." }, "max_results": { "type": "integer", "default": 10, "maximum": 25, "minimum": 1, "description": "Maximum wines to return, for example 10; default 10 and maximum 25." } } } ``` ## Output schema ```json { "type": "object", "required": [ "wines" ], "properties": { "wines": { "type": "array", "items": { "type": "object", "required": [ "wine_name", "winery", "vintage_year", "wine_type", "region", "country", "average_rating", "number_of_ratings", "typical_price", "currency_code", "bottle_photo_link", "vivino_link", "vivino_wine_id" ], "properties": { "region": { "type": [ "string", "null" ], "description": "Wine region." }, "winery": { "type": [ "string", "null" ], "description": "Winery name." }, "country": { "type": [ "string", "null" ], "description": "Country of origin." }, "wine_name": { "type": "string", "description": "Wine name." }, "wine_type": { "type": [ "string", "null" ], "description": "Wine type, such as Red or Sparkling." }, "vivino_link": { "type": "string", "description": "Wine page on Vivino." }, "vintage_year": { "type": [ "integer", "null" ], "description": "Vintage year when known." }, "currency_code": { "type": [ "string", "null" ], "description": "Currency for the displayed price, normally USD." }, "typical_price": { "type": [ "number", "null" ], "description": "Price shown for US visitors, when available." }, "average_rating": { "type": [ "number", "null" ], "description": "Average Vivino rating out of 5." }, "vivino_wine_id": { "type": "integer", "description": "Vivino wine identifier.", "x-fous-developer": true }, "bottle_photo_link": { "type": [ "string", "null" ], "description": "Bottle photo link, when available." }, "number_of_ratings": { "type": [ "integer", "null" ], "description": "Number of Vivino ratings." } }, "additionalProperties": false }, "description": "Matching wines, most relevant first." } }, "additionalProperties": false } ``` ## See more - [Vivino API: List recommended wines](https://fous.com/methods/vivino.com/list-recommended-wines.md): 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. - [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. - [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. - [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. - [crates.io API: Search crates](https://fous.com/methods/crates.io/search-crates.md): Finds Rust crates on crates.io by keywords, sorted by relevance, total downloads, recent downloads, or newest creation. - [Instacart API: Search store products](https://fous.com/methods/instacart.com/search-products.md): Searches a named Instacart store's guest-visible grocery products for a US ZIP code. Prices are in USD and can differ from in-store prices; stock estimates can change. - [Sephora API: Search products](https://fous.com/methods/sephora.com/search-products.md): Searches Sephora US beauty products in Sephora's order, with brand and USD price filters and shopper sort options. Loves counts are null when a product page cannot be loaded. - [Apple API: Search apps](https://fous.com/methods/apps.apple.com/search-apps.md): Finds iPhone and iPad apps by keyword in a chosen country's App Store, with ratings, prices, categories and App Store links. - [All Vivino methods](https://fous.com/methods/vivino.com.md)