wine.com APIwine.com ↗
Access Wine.com product data via 5 endpoints: search wines, browse by category, get detailed ratings, critic reviews, pricing, and current sale listings.
curl -X GET 'https://api.parse.bot/scraper/b8502cfe-cf7f-4f0c-9124-ea08ebff0e88/search_wines?page=1&sort=mostPopular&query=Pinot+Noir' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for wines by keyword. Returns a paginated list of wines matching the search term with detailed attributes including pricing, reviews, and images.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order for results (e.g. 'mostPopular', 'ratingDescending', 'savings'). |
| queryrequired | string | Search term for wine name, producer, region, or other attributes (e.g. 'Pinot Noir', 'Chateau'). |
{
"type": "object",
"fields": {
"results": "array of wine objects with id, name, producer, region, price, reviews, images, etc.",
"pagination": "object with current_page, total_pages, page_size, total_count"
},
"sample": {
"data": {
"results": [
{
"id": "CGM66829_2017",
"abv": null,
"url": "https://www.wine.com/product/Dom-Perignon-Vintage-with-Gift-Box-2017/CGM66829_2017",
"name": "Dom Perignon Vintage with Gift Box 2017",
"size": 750,
"is_nv": false,
"price": {
"whole": "300",
"display": "$300.00",
"currency": "USD",
"fractional": "00",
"isNegative": false
},
"stock": 180,
"images": [
{
"alt": "Dom Perignon Vintage with Gift Box 2017 Front Bottle Shot",
"url": "http://res.cloudinary.com/winecom/image/upload/p8m85hx8xdnn7sbwp8cb"
}
],
"region": "France",
"country": null,
"savings": {
"whole": "0",
"display": "$0.03",
"currency": "USD",
"fractional": "03",
"isNegative": false
},
"vintage": "2017",
"producer": "Dom Perignon",
"seo_name": "Dom-Perignon-Vintage-with-Gift-Box-2017",
"varietal": null,
"attributes": [],
"sale_price": {
"whole": "299",
"display": "$299.97",
"currency": "USD",
"fractional": "97",
"isNegative": false
},
"sub_region": "Champagne",
"description": "Dom Pérignon Vintage 2017...",
"community_rating": {
"count": 0,
"score": "0.0"
},
"professional_reviews": [
{
"text": "Dense and layered...",
"score": 96,
"critic": "James Suckling",
"vintage": null
}
]
}
],
"pagination": {
"page_size": 25,
"total_count": 13679,
"total_pages": 548,
"current_page": 1
}
},
"status": "success"
}
}About the wine.com API
The Wine.com API provides access to Wine.com's catalog across 5 endpoints, covering product search, category browsing, detailed wine metadata, top-rated lists, and current sale inventory. The get_wine_detail endpoint returns critic scores, community ratings, vintage-specific professional reviews, and structured pricing fields for a single product. Whether you're building a wine recommendation tool or tracking price movements, the API surfaces the data Wine.com exposes on its product pages.
Searching and Browsing
The search_wines endpoint accepts a query parameter (wine name, producer, region, or varietal) and returns a paginated array of wine objects including id, name, producer, region, price, reviews, and images. The sort parameter accepts values like mostPopular, ratingDescending, and savings, giving you control over result ordering. The list_wines endpoint works similarly but supports a filters string and a category_id — category ID 7155 covers the full Wine Shop, while sub-filters like 7155-124 narrow to red wines.
Wine Detail and Ratings
Use get_wine_detail with a product_id (e.g. CGM66829_2017, retrievable from any list endpoint) to pull the full record for a single wine. The response includes a structured price object with currency, whole, fractional, and display fields, a parallel sale_price object when applicable, a community_rating with numeric score and review count, and a professional_reviews array where each item carries a critic name, score, text, and vintage.
Sale and Top-Rated Lists
get_wines_on_sale returns wines currently discounted, sorted by savings descending, and adds a savings field to the standard wine object alongside both price and sale_price. get_top_rated_wines sorts results by rating descending and shares the same paginated response shape as list_wines. Both endpoints accept a page parameter for iteration. All list endpoints return a pagination object with current_page, total_pages, page_size, and total_count.
- Build a wine recommendation engine filtered by region and sorted by community rating using
search_wines. - Track price drops on specific wines by comparing
priceandsale_pricefields fromget_wines_on_sale. - Aggregate professional critic scores across vintages using the
professional_reviewsarray fromget_wine_detail. - Create a curated 'top picks' feed by paginating through
get_top_rated_winesresults. - Populate a wine catalog app with producer, region, and image data from
list_winesusing category filters. - Monitor discount depth on specific varietals by sorting
get_wines_on_saleresults and reading thesavingsfield. - Cross-reference community ratings and critic scores for the same vintage using
community_ratingandprofessional_reviewsin a single detail call.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Wine.com have an official developer API?+
What does `get_wine_detail` return that the list endpoints don't?+
professional_reviews array, which includes individual critic name, score, review text, and vintage for each published review. List endpoints return summary reviews data but do not break out per-critic records.How do filters work in `list_wines`?+
filters parameter takes a string like 7155-124, where the prefix corresponds to the parent category and the suffix narrows the result set. The base category ID 7155 represents the full Wine Shop. Combining category_id with a filters string lets you target subcategories such as red or white wines.