Total Wine Inventory & Rating Data API · Live

Pull live Total Wine data
down to the vintage,
the state shipping rule.

Store-specific inventory across states, wine vintage and varietal detail, professional ratings from Wine Spectator and Robert Parker, and age-verification and state-by-state shipping-legality compliance data — structured and delivered as clean JSON or CSV. No proxies to manage, no CAPTCHAs to solve, no HTML to parse.

See a Live Response
4 Total Wine verticals covered
<3s avg. response time
17M+ requests / month served
99.9% uptime SLA
GET /v1/totalwine/product
LIVE
// streaming a live inventory pull...
Trusted by global businesses pulling Total Wine data at scale
VintagePriceGraph ShippingLegalityWatch RatingScoreScope RetailIntel Northline Retail Boxed FMCG
280+
GLOBAL CLIENTS SERVED
160+
PROJECTS DELIVERED
17M+
MONTHLY API CALLS
24/7
DEDICATED SUPPORT
Why Choose Our Total Wine API

A wine's shelf price is only half the story — the vintage and the state law are the other half.

Between vintage and varietal detail that changes the identity of a wine even under the same label, professional critic scores that carry real weight in purchase decisions, and state-by-state alcohol shipping laws that vary dramatically across the US, Total Wine's catalog carries more regulatory and provenance structure than a standard retail feed. Our infrastructure absorbs that complexity so your team just calls an endpoint and gets data back.

01

Zero blocking, zero maintenance

We run rotating residential IPs, headless rendering, and CAPTCHA-solving behind every request. When Total Wine changes its layout, we patch our parsers — your integration never breaks.

02

Vintage & varietal aware

Every wine response resolves vintage year and varietal as distinct fields rather than bundling them into a single product title.

03

Professional-rating & compliance detail

We resolve Wine Spectator/Parker scores and state shipping-legality status with the same structured fields as core product data.

04

Built for scale from day one

From a 100-product test batch to millions of daily checks across states, the same endpoint and response shape scale with you.

Total Wine API Features

Everything you need to keep Total Wine data flowing.

⚡

Real-time extraction

Trigger an on-demand pull for any product, store, or keyword and get a fresh response — not a stale cache.

🧩

Custom field selection

Request only the fields you need — price, vintage, rating score — to cut payload size and parsing time.

🍷

Vintage resolution

Get vintage year and varietal broken out per product, including region and appellation detail.

🗂️

Bulk & scheduled requests

Submit thousands of product IDs in one batch job or schedule recurring pulls on an hourly, daily, or custom cadence.

📋

Shipping-legality detection

Flag state-by-state alcohol shipping legality automatically on every eligible product.

📊

Historical price tracking

Store and query price history per product to power trend and vintage-pricing analysis.

What Data Can You Access?

Every field a product page shows — vintage and compliance detail included.

CoreProduct ID & nameWine, spirits, or beer category
PricingPrice & case discountUSD currency, price per unit
WineVintage year & varietalRegion & appellation
RatingsWine Spectator & Robert Parker scoresJames Suckling score where available
ComplianceAge-verification requirement flag21+ legal purchase requirement
ComplianceState shipping legalityState-by-state sale/shipping status
ProductABV% & format/size750ml, 1.5L magnum & other formats
StoreStore location & pickup availabilityStore-specific stock status
MediaLabel image & tasting notesProduct photos, flavor profile
ReviewsUser ratings & review countCustomer rating breakdown
StructureCategory, region & varietal breadcrumbsFull catalog hierarchy
DeliveryCurbside & delivery availabilityFulfillment options per store
Supported Total Wine Verticals

Wine, spirits, beer, and gift sets — one integration covers all of it.

Switch the vertical parameter to pull from a different Total Wine category with the same consistent response shape.

🍷

Wine

Vintage, varietal & region-tracked bottles.

🥃

Spirits

Whiskey, vodka, tequila & spirit category detail.

🍺

Beer

Style, brewery & ABV-tracked inventory.

🎁

Gift Sets & Accessories

Bundled gift sets & bar accessories.

CoverageMulti-stateStore-specific inventory across the US
ComplianceCompliance-trackedAge verification & shipping legality resolved per product
FreshnessReal-timePrice and stock checked on every request
Total Wine API Endpoints

A small set of endpoints that cover the whole product lifecycle.

Method Endpoint Description Typical use
GET /v1/totalwine/product Full product detail by product ID or name Price & feature monitoring
GET /v1/totalwine/store Store-level detail including stock & pickup status Store-inventory tracking
GET /v1/totalwine/search Category, varietal, or keyword search results Catalog & competitor discovery
GET /v1/totalwine/reviews Paginated customer reviews Sentiment analysis
GET /v1/totalwine/ratings Professional critic scores by product Rating-trend research
POST /v1/totalwine/bulk Submit up to 10,000 product IDs per batch job Catalog-wide monitoring
GET /v1/totalwine/shipping-legality State-by-state shipping & sale legality Compliance auditing
Live API Response Example

This is exactly what comes back. No extra parsing needed.


        

    







    

        

            Popular Total Wine API Use Cases
            
Built for the teams that live and die by verified alcohol retail data.

        

        

            

                
📈

                
Price/vintage trend monitoring

                
Feed live prices and vintage-specific pricing into your tracking tools every few minutes.

            

            

                
🏆

                
Professional-rating tracking

                
Track Wine Spectator and Robert Parker scores across the catalog over time.

            

            

                
🗺️

                
State-by-state shipping-legality compliance research

                
Study which states allow shipping and sale for a given product category.

            

            

                
🏬

                
Store-level inventory availability tracking

                
Monitor stock status and pickup availability across store locations.

            

            

                
🍇

                
Varietal/region catalog composition analysis

                
Study how the catalog splits across varietals, regions, and appellations.

            

            

                
💰

                
Case-discount/bulk-pricing benchmarking

                
Compare bulk and case-discount pricing structures across products.

            

            

                
🤖

                
ML training data

                
Generate labeled product, price, and rating datasets for recommendation models.

            

            

                
🎯

                
Competitive benchmarking

                
Track how Total Wine pricing compares against BevMo, Drizly, and local liquor stores.

            

        

    







    

        

            How the Total Wine API Works
            
From API key to structured data in five steps.

        

        

            

            

                
1

                
Get your API key

                
Sign up and generate a key from your dashboard in under two minutes.

            

            

                
2

                
Choose an endpoint

                
Pick /product, /store, /reviews or /ratings depending on what you need.

            

            

                
3

                
Send the request

                
Call the endpoint with a product ID, varietal, or store location plus your vertical parameter.

            

            

                
4

                
We handle the hard part

                
Proxies, headless rendering, CAPTCHA-solving, and parsing all happen behind the scenes.

            

            

                
5

                
Receive structured data

                
Get clean JSON or CSV back in seconds, ready to drop into your pipeline.

            

        

    







    

        

            Developer-Friendly Integration
            
Built by people who read the docs too.

            
One consistent JSON schema across every endpoint and every vertical. No SDK lock-in — plain REST calls work from any language or platform.

            

                

                    
→

                    

                        
Predictable REST design

                        
Standard HTTP verbs, query params, and status codes — nothing proprietary to learn.

                    

                

                

                    
→

                    

                        
JSON, CSV, or webhook delivery

                        
Get results inline, as a downloadable file, or pushed to your endpoint when a batch job finishes.

                    

                

                

                    
→

                    

                        
Sandbox & test keys

                        
Free sandbox environment with sample product IDs so you can build before you pay.

                    

                

                

                    
→

                    

                        
Postman collection & SDK snippets

                        
Import a ready-made collection or copy request snippets for Python, Node.js, and cURL.

                    

                

            

        

        

            

                
                Quickstart
            

            

                
                
                
            

            

        

    







    

        

            API Performance & Reliability
            
Numbers we publish because we track them daily.

        

        

            

                
99.9%

                
Uptime SLA

                

                    

                

            

            

                
<3s

                
Avg. response time

                

                    

                

            

            

                
98.7%

                
Successful extraction rate

                

                    

                

            

            

                
9K+

                
Concurrent requests supported

                

                    

                

            

        

    







    

        

            Security & Compliance
            
Compliant by design, not as an afterthought.

        

        

            

                
🔒

                
Encrypted in transit

                
All requests and responses travel over TLS 1.2+. API keys can be scoped and rotated anytime.

            

            

                
⚖️

                
Alcohol e-commerce compliance-aware

                
Our extraction workflows account for age-verification and state-level alcohol shipping regulations alongside CCPA and GDPR guidelines.

            

            

                
🌐

                
Public-data-only policy

                
We collect only publicly accessible product and store data — never login-gated or private account information.

            

        

        

            
                ✓ISO 9001:2015 Certified
            
            
                ✓ISO/IEC 27001:2013 Certified
            
            
                ✓IAF Multilateral Recognition
            
            
                ✓GDPR-aligned workflows
            
        

    







    

        

            API Documentation & Resources
            
Everything to go from key to production.

        

        

            

                Guide
                
Quickstart Guide

                
Get your first API response back in under five minutes.

                Read guide →
            

            

                Reference
                
Full API Reference

                
Every endpoint, parameter, and response field documented in detail.

                View reference →
            

            

                Tool
                
Postman Collection

                
Import ready-made requests for every Total Wine API endpoint.

                Download →
            

            

                Code
                
SDKs & Code Samples

                
Python, Node.js, PHP, and Ruby snippets for every use case.

                Browse samples →
            

        

    







    

        

            Frequently Asked Questions
            
Still deciding? Here's what most teams ask first.

        

        

            

                
                

                    
We collect only publicly accessible product and store data using automated tools, following publicly available web-data guidelines. We recommend reviewing your own use case with legal counsel, especially for redistribution and for any age-restricted product handling.

                

            

            

                
                

                    
Every request to /product, /store, and /shipping-legality triggers a live pull — you're not reading from a stale cache. Price and stock status are checked live on every request.

                

            

            

                
                

                    
Yes. The /product endpoint returns vintage year, varietal, and region as distinct fields rather than bundling them into a single title string.

                

            

            

                
                

                    
Yes — the /shipping-legality endpoint returns state-level sale and shipping status wherever Total Wine publishes that detail.

                

            

            

                
                

                    
Our infrastructure retries automatically across a rotating proxy pool. You're only billed for successfully returned responses.

                

            

            

                
                

                    
Yes, every account starts with a free sandbox key and sample credits so you can test all endpoints before committing to a plan.

                

            

        

    








    

        
Contact Us

        
We are eagerly waiting to hear you.

        

            

                

                    


                    
Chat with Us

                

                

                    
 Take to our Social Experts, who are at your service 24x7 worldwide.

                

            

            

                

                    
                    
Email Us

                

                

                    
Drop us an email at sales@realdataapi.com
                        and you'll receive a reply within 24 hours!

                

            

            

                

                    
                    
Give us a Call

                

                

                    

                        Want to talk? Our support staff on
                        +91 8866656657
                        is at your service 24x7 support worldwide.
                    

                

            



        

    



    

        

            Brand Image
        



        

            
            

                

                    
                

                

                    
                

                
                

                    

                        

                            

                                
                                

                                    

                                        
                                        ▼
                                    


                                    
                                    
                                


                                
                                

                                
                                
                            

                        

                    

                


                

                    
                

                

                    
                


                

                    
                


                

                    
                


                

                

                    
                    
                    
                    
                    
                    
                    
                    
                    
                    
                    
                    
                    
                

            

        

    









    

        

            

                

                    
                    
Real Data API stands out as one of the premier global companies specializing in web data Scraping and web extraction.

                    

                       
    



    



    



    



    

                    

                

                

                

                    
Get in Touch

                    
                    

                    

                    

                     +91 8866656657
                    
                     sales@realdataapi.com
                     60 Paya Lebar Rd, #11-22 Paya Lebar Square, PMB 1010, Singapore 409051
                

                

            

            

            

                

                    

                        

                            
Web Data

                            Live Crawler
                            Scraping Browser API
                            Anti Blocking
                            Web Unlocker API
                            Use Cases
                            Web Scraping
                            Enterprise Web Crawling
                            Web Scraping API Services
                            Mobile App Scraping Services
                             
Store Location

                        


                        
                                       
                             
Company

                           
                            About Us
                            FAQs
                            Contact Us
                           
                           
                        


                    


                    
                    

                        

                            
By APIs

                            Ecommerce Scraping API
                            Food Scraping API
                            Q-Commerce Scraping API
                            Grocery Scraping API
                            Travel Scraping API
                            Real Estate Scraping API
                            Social Media Scraping API
                            OTT Scraping API
                            Liquor Scraping API
                            Recruitment Scraping API
                            Healthcare Scraping API
                            Fashion Scraping API
                        

                    

                    

                        

                            
Scraper

                            Amazon Product Scraper
                            AliExpress Scraper
                            Google Shopping Scraper
                            Zomato Scraper
                            Swiggy Scraper
                            E-Commerce Scraper
                            Blinkit Scraper
                            Flipkart Scraper
                            Twitter Scraper
                            eBay Scraper
                            Zepto Scraper
                            Airbnb Scraper
                            Booking Scraper
                            Tiktok Scraper
                            Reddit Scraper
                        

                    

                    

                        

                            
Use Cases

                            Price Comparison
                            Market Research
                            Robotic Process Automation (RPA)
                            Product Development
                            Lead Generation
                            Machine Learning
                        

                        

                            
Datasets

                            E-Commerce Datasets
                            Food Datasets
                            Travel Datasets
                            Real Estate Datasets
                            Grocery Datasets
                            Liquor Datasets
                            Fashion Datasets
                        

                    

                    

                        


                            


                             
Knowledge Center


                            
 Blogs

                             Web
                                Scraping Python
                             Web
                                Scraping PHP
                             Web Scraping
                                Java
                             Web Scraping Ruby
                            

                            
                                Web Scraping Rust
                            Web
                                Scraping in Go
                            Web
                                Scraping in Elixir
                            Web
                                Scraping with R
                            Web
                                Scraping with C#
                            
                                Web Scraping JS and Node.js





                            
 Case Studies
                            

                            
 Research Report

                            
Infographics

                           
                        


                    

                

            

        

       



    

        

            

                
                    clutch
                
            

            

                
                    clutch
                
            

            

                
                    clutch
                
            

            

                
                    clutch
                
            

            

                
                    clutch
                
            

            

                
                    clutch
                
            

            
            
        

    




            

                

                    

                        
                        
                        
                        
                        
                    

                

            



        

            

                

                    

                        
                            
About Us

                        
                        
                            
Contact us

                        
                    

                

                

                    

                        
© 2026 RealdataAPI. All rights reserved.

                    

                

                

                    
                

            

        


        

            

                
Disclaimer : RealData API functions solely as an independent data infrastructure and technology solutions provider. We build customized automation workflows designed to collect publicly accessible web data based exclusively on client instructions. RealData API neither owns proprietary datasets nor engages in the sale or redistribution of extracted information. Our operations are limited strictly to lawful public web data processing and never involve unauthorized access to restricted systems or private networks. Any company names, trademarks, logos, or brand references displayed on this website are used purely for demonstrative and illustrative purposes to showcase our technical capabilities and do not imply endorsement, partnership, or affiliation. Use of our platform and services remains subject to our Terms of Service.

            

        

    








































  





























    
    
    
















    

        
        
INQUIRE NOW