wineapi.io

The idea

Wine data is scattered, inconsistent, and locked behind scraping-hostile sites. wineapi.io turns the world's wine knowledge into a single, developer-ready REST API: one endpoint to search, one to fetch a complete profile, authenticated with a simple API key.

It's built for anyone shipping a wine-aware product — a cellar app, a sommelier assistant, a pairing tool, or an AI agent that needs structured wine facts instead of hallucinated vintages.

What it does

Search the catalog by wine name, winery, or appellation and get back matching wines with ratings and relevance scores. Fetch a wine by ID and you get the full picture: tasting profile (body, acidity, classification), grape varieties, region and winery, aggregated critic scores, merchant pricing with a normalised price range, and food pairing suggestions with confidence values.

The API handles enrichment transparently — if a wine hasn't been fully populated yet, the response signals X-Update-Status: pending with a Retry-After hint so you can re-fetch once the background update completes. Requests are authenticated with an X-API-Key header, paginated, and rate-limited.

Get started

The full machine-readable OpenAPI specification and interactive documentation cover every endpoint. Authenticate with the X-API-Key header:

curl "https://api.wineapi.io/wines/search?q=barolo" \
  -H "X-API-Key: <your-key>"

Built by Pinnacle Ridge Cloud Solutions.