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 Skill Integration

Use the ready-made Claude/OpenClaw API skill guide to plug this API into assistant workflows.

View Claude/OpenClaw 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.