Bottle images
Product-ready bottle imagery for listings, search results, and detail pages.
Wine Label Image API
Wine label and bottle image API for product catalogs.
Retrieve imagery by wine, vintage, Wine Labs ID, or LWIN11. Add your logo, choose a polished Studio background, and request the exact pixel size your catalog needs.
Standard delivered image
$0.20
Minimum purchase
100 credits
No file delivered means no charge.
Request → delivery
Typical website catalog workflow
Request
- identifier
- wine_id or LWIN11
- vintage
- 2021
- assets
- bottle, front_label, back_label
Delivered assets
bottle_imageavailable
front_labelavailable
back_labelavailable
Use the self-serve dashboard, CSV upload, or API.Billable assets: 3
Wine image delivery
A wine label image API and wine bottle image API for product catalogs
Connect product identities to the visual assets customers expect to see when browsing, comparing, buying, or managing wine.
Front labels
Clear front-label assets tied to the requested wine and vintage.
Back labels
Back-label imagery for richer product records and customer reference.
Bottle and label files ready for your website
Missing → delivered
Live example
Image missing
Wine and vintage supplied. No usable catalog image.
BeforeBottle example
Ayala A/18 · 2018
- Wine checked
- Vintage checked
- Clean background
Add your logo
Use a transparent PNG hosted on your CDN. We add it to the delivered image; the original stays unchanged.
"overlay": {
"image_url": "https://cdn.example/logo.png",
"position": "bottom_right",
"scale": 0.2,
"opacity": 0.95
}Logo option: +0.1 credit · no delivery: 0 credits
YOUR LOGO
Corner mark
bottom_right · foreground
YOUR LOGO
Diagonal watermark
center · 20% opacity · −24°
YOURLOGO
Behind the bottle
center · filled background layer
Studio backgrounds
Put the bottle in a studio.
Choose Warm stone, Limestone, or Soft rose. We keep the bottle image unchanged and add the background when we deliver it.
Bottle image1.0Studio+0.1Total1.1 credits
+0.1 creditWarm stone
+0.1 creditLimestone
+0.1 creditSoft rose
Add a logo too: 1.2 credits total. Custom dimensions do not cost extra.
Request a Studio imageIdentifiers
Request labels by the wine identity you already use
Wine Labs ID
Use a canonical Wine Labs wine identity for a direct catalog-to-asset workflow.
LWIN11
Supply an LWIN11 identifier where available for interoperability with existing wine data.
Wine and vintage
Use structured producer, wine, and vintage details when an identifier is not supplied.
Batch catalog input
Scope a larger list of products that need bottle, front-label, or back-label imagery.
Pricing
$0.20 per delivered image.
Buy credits in 100-credit increments, starting at 100 credits. Standard delivery uses 1 credit. A logo adds 0.1 credit, and a Studio background adds 0.1 credit. Requests with no delivered file use no credits.
01
Request
Send the product identity and the imagery types needed.
02
Receive
Get the bottle, front-label, and back-label files Wine Labs can provide.
03
Bill
Use 1 credit, plus 0.1 for a logo and 0.1 for Studio.
Wine Label API questions
Plan the identifiers, assets, and delivery format together.
What is a Wine Label API?
A Wine Label API lets a product request available label or bottle imagery for a known wine record. Wine Labs supports workflows that use wine and vintage details, canonical Wine Labs IDs, or LWIN11 identifiers to connect delivered imagery to the right product record.
Can I request wine labels using an LWIN11 code?
Yes. LWIN11 can be supplied as an identifier where it is available. Wine Labs can also work with a canonical Wine Labs wine ID or structured wine and vintage details.
Which image assets can be returned?
Available output can include a clean bottle image, front label, back label, or a subset of those assets for the requested wine and vintage.
Is this a wine label recognition API?
No. Wine label recognition starts with an uploaded photo and attempts to identify the wine. The Wine Labs Wine Label API starts with a known wine identity and retrieves available bottle, front-label, and back-label images for that record.
What does the Wine Label API cost?
$0.20 per credit. A standard delivered image uses 1 credit; a logo adds 0.1 credit and a Studio background adds 0.1 credit. Credits are sold in increments of 100, and requests that return no file cost nothing.
Can Wine Labs add my logo to bottle imagery?
Yes. Send a public HTTPS image URL with the request and choose a corner, centered, diagonal, custom, or behind-bottle treatment. Wine Labs creates a request-specific derivative without changing the canonical bottle image.
How does billing work for unavailable labels?
Only imagery Wine Labs provides is billable. A request that does not produce a delivered bottle or label file is not charged.
Is the Wine Label API a self-serve public endpoint?
Yes. Create an account, open the imagery desk, buy at least 100 delivery credits, and request bottle, front-label, or back-label imagery immediately. You can use the dashboard, upload a CSV, or integrate the documented API endpoints.
Wine Label API access