whiskybase.com APIwhiskybase.com ↗
Access Whiskybase data via API: search whiskies, browse distilleries, check marketplace prices, get new releases, and fetch the Top 1000 ranked bottles.
curl -X GET 'https://api.parse.bot/scraper/1fa3ba9e-3cd6-4ffe-b2d7-0da0f2ba5f66/search_whiskies?query=Laphroaig' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for whiskies by keyword. Returns matching bottles with basic info including name, brand, strength, rating, and photo URL.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g. 'Ardbeg', 'Laphroaig', 'Macallan') |
{
"type": "object",
"fields": {
"items": "array of whisky objects with id, name, brand, display_name, age, strength, bottle_size, vintage_year, bottle_year, rating, url, photo",
"total": "integer total number of matching results"
},
"sample": {
"data": {
"items": [
{
"id": 54930,
"age": null,
"url": "https://www.whiskybase.com/whiskies/whisky/54930",
"name": "Select",
"brand": "Laphroaig",
"photo": "https://static.whiskybase.com/storage/whiskies/5/4/930/87550-normal.png",
"rating": "79.39 / 100",
"strength": "40 %vol",
"bottle_size": "700 ml",
"bottle_year": null,
"display_name": "<b>Laphroaig</b> Select",
"vintage_year": null
}
],
"total": 3651
},
"status": "success"
}
}About the whiskybase.com API
The Whiskybase API exposes 6 endpoints covering the full Whiskybase catalogue — from keyword search and distillery browsing to live marketplace listings and the community-voted Top 1000. The get_top_1000_whiskies endpoint alone returns rank, age, strength, rating, and vote count for every bottle that has cleared the 15-vote threshold, giving you a clean, sortable benchmark of community consensus.
Search and Discovery
The search_whiskies endpoint accepts a keyword — a distillery name, brand, or bottler — and returns an array of matching bottles. Each item includes id, name, brand, display_name, age, strength, bottle_size, vintage_year, bottle_year, rating, and a direct url back to the Whiskybase listing. The total field tells you how many records matched so you can gauge coverage before paginating.
Distilleries and Their Catalogues
get_distilleries returns every distillery on Whiskybase with name, country, and whiskies_count — useful for building a directory or scoping a research project by region. Once you have a distillery ID from that response, pass it to get_distillery_whiskies to pull every bottle associated with that producer, each carrying id, name, age, strength, and rating.
New Releases and Marketplace
get_new_releases lists the latest bottlings across the database. Supply an optional year parameter (e.g. 2024) to narrow results to a specific bottling year; each release object includes bottled, age, strength, size, and rating. For pricing data, get_marketplace_listings returns active buy/sell listings with price, seller, and rating. Pass an optional query string to filter by bottler or distillery name, or omit it to retrieve the most recent listings across the whole market.
Top 1000 Rankings
get_top_1000_whiskies fetches Whiskybase's community ranking. Only bottles with 15 or more community votes are included, so low-sample outliers are filtered out automatically. Response fields are rank, id, name, age, strength, rating, and votes — enough to build leaderboards, track consensus shifts, or benchmark a specific bottle against the broader field.
- Build a whisky price tracker by polling
get_marketplace_listingsfor a specific distillery name over time. - Populate a bottle database with distillery-level catalogues using
get_distilleriesandget_distillery_whiskiesin sequence. - Generate a 'top-rated this year' newsletter section by combining
get_new_releases(filtered by year) with ratings fromget_top_1000_whiskies. - Run competitive shelf analysis by searching multiple brand names via
search_whiskiesand comparing average ratings. - Build a country-filtered distillery directory using the
countryfield fromget_distilleries. - Flag newly listed high-rated bottles for auction or investment watchlists by crossing
get_marketplace_listingsresults againstget_top_1000_whiskiesIDs. - Aggregate vintage coverage per distillery by collecting
vintage_yearandbottle_yearfields fromsearch_whiskiesresults.
| 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 Whiskybase have an official developer API?+
What does `get_top_1000_whiskies` return and how is the ranking determined?+
rank, id, name, age, strength, rating, and votes. Only bottles with 15 or more votes are included, so bottles with very few ratings do not appear even if their average score is high.Can I filter marketplace listings by country, price range, or bottle size?+
get_marketplace_listings endpoint supports only a keyword query filter; there are no parameters for country, price range, or bottle size. The API covers listing-level fields including price, seller, rating, and whisky_name. You can fork it on Parse and revise it to add those filter parameters if your use case requires them.Does the API return tasting notes, flavour profiles, or individual user reviews?+
How fresh is the marketplace listing data?+
get_marketplace_listings endpoint reflects active listings on Whiskybase at the time of the request. Because listings are user-posted and can be added, updated, or removed at any time, the data represents a point-in-time snapshot. Polling at regular intervals is the practical way to detect price changes or new listings for a given bottle.