Vivino API Presentation

API Documentation

This landing page is for direct clients using private API credentials. Authenticate with your bearer token and use the direct OpenAPI spec below for integration details.

GET /api/wine/search

Query our backend to match and retrieve detailed wine metadata for server-to-server integrations. When a cached match is unavailable, the service can fall back to direct catalog fetching.

Mandatory Headers

Authorization: Bearer {YOUR_API_KEY}
Accept: application/json

OpenAPI JSON

Download the direct-client OpenAPI document for code generation, SDK setup, or importing into your API tooling.

View Direct OpenAPI JSON

AI Agent Skill Integration

Use the ready-made API skill for Claude, Codex, OpenClaw, Hermes, and other AI agents to query wine ratings, reviews, and vintages directly.

View AI Agent Skill Page

Query Parameters

q (string, required) - The wine string to search (e.g. "Chateau Margaux 2015")

Example Success Response

{
  "id": 42,
  "name": "Malbec",
  "score": 4.3,
  "reviews": 250,
  "url": "https://www.vivino.com/purcari-malbec/w/1234567",
  "year": 2020,
  "winery": "Purcari",
  "grapes": "Malbec",
  "details": "Purcari Malbec 2020",
  "avg_price": "99.99",
  "currency": "EUR",
  "type": 1
}

Request Access

Need a dedicated direct-client API key, specialized proxies, or customized database matching rules? Let's talk.