WineAPI.io
Wine API — AI-first wine intelligence, delivered via API. Structured wine data for developers, sommeliers, and retailers. Search hundreds of thousands of wines with hybrid semantic + keyword matching, get real-time pricing from multiple merchants, AI-powered food pairings, critic scores, tasting notes, and instant wine label recognition from a photo. One API, the world's wine knowledge.
WineAPI.io endpoints
| Method | Endpoint | Description |
|---|---|---|
| Wines | ||
| GET |
searchWines /wines/search |
Search our wine catalog by name, winery, or appellation. Returns matching wines with ratings and relevance scores. |
| GET |
getWineById /wines/{id} |
Retrieve a complete wine profile including tasting notes, critic scores, pricing, and food pairings. |
| Prices | ||
| GET |
getWinePriceHistory /wines/{id}/price-history |
View how a wine's retail price has changed over time. Available on Pro plans and above. |
| GET |
getWinePrices /wines/{id}/prices |
Get current retail prices for a wine from merchants worldwide. |
| Pairings | ||
| GET |
getWinePairings /wines/{id}/pairings |
Get recommended food pairings for a wine, including pairing notes and confidence levels. |
| Identification | ||
| POST |
identifyWineByImage /identify/image |
Identify a wine by uploading a photo of its label. Accepts JPEG or PNG images up to 10 MB. |
| POST |
identifyWineByText /identify/text |
Identify a wine from a text description. Provide details like the name, vintage, or label text and we'll match it to our catalog. |
| Submissions | ||
| POST |
createSubmissionWithImage /submissions/upload |
Request that a wine be added to our catalog with a label image. Requires a Pro or Enterprise plan. |
| GET |
getSubmissionById /submissions/{id} |
Check the status of a wine submission request. |
| POST |
createSubmission /submissions |
Request that a wine be added to our catalog. Requires a Pro or Enterprise plan. |
| Reference | ||
| GET |
listGrapes /grapes |
Browse grape varieties. Filter by name or color (red, white, rosé). |
| GET |
listRegions /regions |
Browse wine regions around the world. Optionally filter by country. |
WineAPI.io pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|