Transactions API
Auction results, executed exchange trades, and live bids and offers in one subscription.
From $50 / month · 1,000 calls · monthly subscription
The wine data API.Prices, auctions, lists.
One wine price API for live merchant offers, auction results, restaurant wine lists and label imagery. Every record is matched to a canonical LWIN, at 94.5% coverage against a 65% industry baseline.
One wine, every source
Château Margaux, Premier Cru Classé·Margaux, Bordeaux·LWIN 1012781·wl_id 101
SourceWhat you getAll vintages
Merchant offers
Live retailer and broker prices, any currency
0live
Auction lots
Hammer prices with buyer’s premium, lot by lot
0sold
Exchange trades
Executed trades from the fine wine exchanges
0trades
Exchange bids and offers
Live orderbook depth on both sides of the market
0quotes
Restaurant lists
On-premise pricing, venue by venue
0venues
Label imagery
Front label, back label and clean bottle shots
0images
Live counts for this wine across every vintage, read 18 August 2026. All of it behind one key. see the reference
Wine data API endpoints
Full referenceMatching API
Match wine names, vintages, and formats with 94.5% coverage vs 65% industry baseline.
Wine Info API
Fetch canonical details, producers, regions, and formats.
Wine Label Image API
Retrieve bottle, front-label, and back-label images for known wines and product catalogs.
$0.20 per delivered image · 100-credit minimum
In production
“The data quality and matching accuracy are outstanding. Our match rates are significantly better than anything else we tested. The matcher keeps getting better without us lifting a finger.”
Aaran Ameli-Daniel · Head of Data, WineFi
Read the case study- 813K
- Wines in the reference set
- 50.8M
- Merchant offers held
- 12.4M
- Auction lots matched to a wine
- 94.5%
- Match coverage, against 65% baseline
Why teams choose it
Wine data is a pipeline problem. We already run the pipeline.
Stop spending engineering time on scrapers, matching rules and format edge cases. The data arrives clean and keeps improving without you touching it.
- Best-in-class accuracy
- In head-to-head testing we matched 94.5% of a real inventory file against 65% for the next best. Vintages, formats, and label variations are handled without hand-written rules.
- Compounding value
- The matching engine and the source list improve every month. You get the gain immediately, with no re-uploads, no manual clean-up, no extra cost.
- Ship in hours, not months
- A REST API with worked examples you can run from the docs. One key covers matching, prices, auctions and lists.
What the data covers
LWIN matching
Industry-leading LWIN code matching that absorbs typos, format differences and producer variations. Match one wine or 100,000 rows in a batch.
813K wines, 94.5% coverage against a 65% baseline
Market intelligence
Merchant prices, auction results, exchange trades and orderbook depth from the world’s most liquid wine trading venues.
50.8M offers, 12.4M auction lots, 282K exchange trades
Cellar valuation
Price an entire collection in one call. Upload a spreadsheet and get a valuation with market trend and liquidity context.
27.7M priced wine locations behind every valuation
API pricing
Choose your API and call volume.
Choose your API product, then your monthly call allowance. Each product is a separate subscription. Month to month, cancel whenever.
- Billing
- Monthly from your subscription date, usage resets each cycle
- Works in
- Any HTTP client, plus Google Sheets and Excel on every plan
Core Data APIs
Includes:
Calls are pooled across all core routes
/match_to_lwin, /wine_infoCalls are pooled across all core routes
Popular30K
Starter
30,000 calls / month
$200
/ month
- Included usage
- 30,000 calls
- Overage
- $0.0065
Upgrade instantly as your usage grows.
Monthly usage
30,000 callsStarter plan · $200 / month
Market Data APIs
Includes:
Calls are pooled across all market routes
/price_stats, /listings, /restaurant_listingsCalls are pooled across all market routes
Popular30K
Starter
30,000 calls / month
$250
/ month
- Included usage
- 30,000 calls
- Overage
- $0.0083
Upgrade instantly as your usage grows.
Monthly usage
30,000 callsStarter plan · $250 / month
Market Insights APIs
Includes:
/price_history, /trade_signalsPopular30K
Starter
30,000 calls / month
$300
/ month
- Included usage
- 30,000 calls
- Overage
- $0.0104
Upgrade instantly as your usage grows.
Monthly usage
30,000 callsStarter plan · $300 / month
Transactions API
Includes:
Calls are pooled across all transaction routes
/auctions, /exchange/trades, /exchange/orderbookCalls are pooled across all transaction routes
Popular30K
Starter
30,000 calls / month
$375
/ month
- Included usage
- 30,000 calls
- Overage
- $0.013
Upgrade instantly as your usage grows.
Monthly usage
30,000 callsStarter plan · $375 / month
Need custom limits, dedicated support, or custom integrations?
Talk to salesPriced on request
Need coverage beyond the self-serve plans? Tell us your requirements
Custom transaction plans
Larger transaction allowances, dedicated support, and tailored integrations.
Ask for a quoteHistorical pricing
The estimated price of any wine at any date, built from market signals where no trade exists.
Ask for a quotePrefer email? hello@winelabs.ai
In every API plan
- One API key
- Use the same key across the API products you subscribe to
- Clear product scope
- Each subscription grants the endpoints and allowance listed in its plan
- Documentation and examples
- Integrate using the endpoint reference and worked request examples
- Self-serve billing
- Subscribe online and manage your subscriptions from your account
On larger plans
- Higher rate limits
- Throughput sized to the volume you actually send
- Dedicated support
- Priority response and technical consultation on your integration
- Custom integrations
- Feeds and formats shaped to your own pipeline
- Uptime commitments
- A formal SLA, which the self-serve tiers do not carry
Who builds on it
Investment tools, marketplaces and data products.
Wine investment and trading
Portfolio tracking, performance analytics and valuation, on live pricing and full history.
WineFi reconciled 150K+ wines and unlocked transaction data from 10+ marketplaces, Read the case study
Marketplaces and retailers
LWIN matching, dynamic pricing and cellar valuation inside an e-commerce or auction platform.
Messy inventory becomes standardised wine identities in minutes
Fintech and insurance
Wine-backed lending, underwriting and asset verification against defensible valuations.
Exchange and auction data for instant, evidenced valuations
Need Higher Limits or Have Questions?
Contact Us for Enterprise Pricing
Already have an account? Sign in to get your API key instantly. Need custom limits, dedicated support, or have questions? Fill out the form below and our team will respond within 24 hours.
Common questions
Frequently Asked Questions
The questions we get asked most, whichever plan you are on. How billing works, how calls are counted, and what you can do with the data. Something not covered here? Ask us directly.
Plans & billing
How are API plans billed: monthly, annually, or one-off?
Every plan is a monthly recurring subscription, charged on the same day each month from the date you subscribe. Tiers differ only in the size of the monthly call allowance, so you can move up or down as your volume changes.
Does a plan renew automatically?
Yes. A plan renews every month until you cancel it. You will see the next renewal date on your account page.
Can I cancel anytime? Is there a minimum commitment?
Cancel whenever you like. There are no long-term contracts and no minimum commitment, and your access runs to the end of the month you have already paid for.
Do unused calls roll over to the next month?
No. The allowance resets at the start of each billing cycle, and whatever you did not spend does not carry forward. There is no credit bank to draw down later.
Quotas & call counting
Is my allowance per endpoint, or shared across them?
Shared, within each product. One Core allowance covers every Core endpoint:
- /match_to_lwin
- /wine_info
Markets, Market Insights, and Transactions API are separate products. Transactions includes auctions, exchange trades, and exchange order book under one shared allowance.
What counts as one call?
One request to one endpoint. Matching a wine and then fetching its details is two calls, even though it is the same wine. Batch endpoints charge per item rather than per request, so a match_to_lwin_batch carrying 20 wines spends 20 calls.
What a plan covers
Which endpoints does a Core plan include?
Core gives you wine identity and reference data: matching and wine details, from a single shared allowance.
- The self-serve Wine Label API (/wine_labels) is a separate product with delivery credits and is not part of a Core plan.
- Live merchant prices belong to Markets. Historical market analytics belong to Market Insights. Transactions API covers auctions, exchange trades, and exchange order book with one shared allowance.
Using the data
Can I show Wine Labs data to my own users?
Yes. Display it in your product, whether web, mobile, or internal tooling, and store it for that product to run on, provided you credit Wine Labs as the source. One limit applies:
- You cannot resell or redistribute the raw dataset, or republish it as a standalone data feed.
Can I cache what the API returns?
Yes, and we encourage it. Store the LWIN identifiers and wine metadata you have already fetched. A wine you have matched once does not need matching again, and a cached identifier costs you nothing further.
Evaluating, limits & support
Is there a free tier, sandbox, or trial?
Every account starts with a one-time free allowance that runs against the live production API. It does not reset each month; paid plans add a monthly quota. There is no separate sandbox to build against, so the integration you test with is the one you ship.
- 100 free Core calls, one-time
- 100 free Market calls, one-time
What are the rate limits?
Alongside your plan allowance, each endpoint category has a burst gate, with daily and monthly rolling quotas behind it. Current limits are approximately:
- 24 requests per second
- 360 requests per minute, per endpoint category
Expecting heavier or spikier traffic? Tell us the volume and we will size the limits around it.
Is there an uptime SLA?
The self-serve plans carry no formal uptime SLA. If you need committed uptime, agreed support response times, or custom limits, talk to us about an enterprise plan.
Stop Building Data Pipelines. Start Shipping Features.
Join the teams building the next generation of wine platforms. Get accurate data, ship faster, and scale without the headaches.