🥃 The Whisky Exchange Scraper

Want The Whisky Exchange whiskies and fine spirits in a spreadsheet? This scraper makes it easy.

Use structured filters — better for AI agents — or paste an input_url. When input_url is set it overrides the filters.

The Whisky Exchange is the world's leading specialist retailer of Scotch whisky, Japanese whisky, Irish whiskey, bourbon, rum, cognac, and champagne with over 10,000 bottles. This actor returns up to 2000 rows per run.

💡 Perfect for...

• Collectors & retailers: Track bottle prices, stock counts, cask types, and age statements.
• Dashboards: Monitor rare single malts, new releases, and price per litre.
• Market research: Slice by distillery, region (Speyside, Islay, Highland), cask type, or ABV.
• Data analysts: Export structured rows with full tasting descriptions and high-resolution bottle photos.
• 🤖 AI Agents: Power Claude, Cursor, Codex, the Hermes Agent, and OpenClaw workflows with live Whisky Exchange data.
• 📚 RAG Systems: Feed bottle names, tasting notes, and cask specs into retrieval pipelines.
• 🔗 AI Workflows: Plug into LangChain, AutoGPT, CrewAI, and similar stacks.

✨ Why you'll love this scraper

• 🔗 Input URL or Filters: Paste any Whisky Exchange category or search URL, or pick the same filters as the shop. input_url always wins when set.
• 🎯 Website-Matched Filters: Category, keyword, brand/distillery, country, price range, and sort.
• 🌐 Rich bottle metadata: Price (inc. and ex. VAT), price per litre, age statement, ABV %, bottle size in cl, cask type, flavour profile, bottler, stock count, full description, and high-res photo.

📦 What's inside the data?

id, sku, url, title, brand, bottler, category, subcategory, classification, country, region, age_years, abv_percent, volume_cl, cask_type, cask_detail, flavour_profile, colouring, price, list_price, price_ex_vat, price_per_litre, currency (GBP), availability, stock, description, published, image

🚀 Quick start

Option A: paste https://www.thewhiskyexchange.com/c/40/single-malt-scotch-whisky. Option B: pick a category, brand, or keyword and set max_results.

Input Example (filters):

{
  "category": "40",
  "brand": "Macallan",
  "sort": "price-asc",
  "max_results": 100
}

Input Example (URL):

{
  "input_url": "https://www.thewhiskyexchange.com/c/40/single-malt-scotch-whisky",
  "max_results": 100
}

Output Example:

{
  "id": "34537",
  "sku": "MACOB.12YOV26",
  "url": "https://www.thewhiskyexchange.com/p/34537",
  "title": "Macallan 12 Year Old Double Cask",
  "brand": "Macallan",
  "bottler": "Distillery Bottling",
  "category": "Single Malt Scotch Whisky",
  "subcategory": "Speyside",
  "classification": "Speyside Single Malt Scotch Whisky",
  "country": "Scotland",
  "region": "Speyside",
  "age_years": 12,
  "abv_percent": 40.0,
  "volume_cl": 70.0,
  "cask_type": "Sherry",
  "cask_detail": "Oloroso",
  "flavour_profile": "Rich fruit and spice",
  "colouring": "No",
  "price": 73.25,
  "list_price": null,
  "price_ex_vat": 61.04,
  "price_per_litre": 104.64,
  "currency": "GBP",
  "availability": "in stock",
  "stock": 414,
  "description": "This luxurious Speyside whisky boasts an inviting palate of warm oak, orange zest, toasted fruitcake and ginger biscuits with hints of mocha...",
  "published": "2022-06-07T12:33:45.19Z",
  "image": "https://img.thewhiskyexchange.com/900/MACOB.12YOV26.jpg"
}

Output fields:

Field	Description
id	Product id.
sku	Whisky Exchange product code.
url	Public bottle page.
title	Full bottle display name.
brand	Distillery or brand name.
bottler	Distillery Bottling or independent bottler name.
category	Master category name.
subcategory	Region or style subcategory.
classification	Official spirit classification.
country / region	Country and whisky region.
age_years	Age statement in years when stated.
abv_percent	Alcohol by volume percentage.
volume_cl	Bottle volume in centilitres.
cask_type / cask_detail	Cask type and wood detail when shown.
flavour_profile	Tasting profile summary.
colouring	Whether caramel colouring is added.
price	Selling price in GBP (including VAT).
list_price	Standard price before discount when on offer.
price_ex_vat	Price excluding VAT in GBP.
price_per_litre	Price per litre in GBP.
currency	Always GBP.
availability	in stock or out of stock.
stock	Available bottle count.
description	Full tasting notes and bottle description.
published	Date added to the catalog.
image	High-resolution 900px bottle photo.

📋 Input reference

Parameter	Type	Required	Default	Description
input_url	string	No	—	Whisky Exchange category or search URL. Overrides every filter.
category	dropdown	No	Single Malt Scotch	Single Malt, Blended Scotch, Irish, American, Japanese, World Whisky, Gin, Rum, Vodka, Cognac, Champagne.
query	string	No	—	Search keyword.
brand	string	No	—	Distillery or brand name.
country	string	No	—	Country name.
price_min	integer	No	—	Lowest price in GBP.
price_max	integer	No	—	Highest price in GBP.
sort	dropdown	No	relevance	Relevance, Newest, Oldest, Price low/high, Name A-Z/Z-A.
max_results	integer	No	50	Maximum rows (1–2000).