Master of Malt Scraper

Scrape Master of Malt — one of the world's largest online drinks marketplaces, covering whisky, gin, rum, vodka, beer, wine, liqueurs, brandy, champagne, and sake. Search products by name, browse by category, find the top-rated bottles in any category, or pull full product detail with customer reviews and star ratings. No login, no API key, no residential proxy required.

What this actor does

• Four modes: search, browseCategory, topRated, byProductUrls
• Real category taxonomy: whisky, gin, rum, vodka, beer, wine, liqueur, brandy, champagne, sake
• Filters: min rating, min number of ratings, price range (GBP), ABV range, country of origin, in-stock only
• Sort: relevance, price (asc/desc), rating (desc), ABV (desc)
• Full customer reviews — written reviews with author, date, and star rating on product-detail lookups
• Empty fields are omitted

Output per product

• productId — Master of Malt internal product ID
• name, shortName
• category (e.g. Whiskies), style (e.g. Single Malt), categoryTags[]
• distillery / bottler — producer or brand
• country, region — e.g. Scotland / Islay
• abv — alcohol by volume (%)
• ageYears, volumeCl, vintage
• priceGBP, originalPriceGBP, isOnSale
• inStock, isBestSeller
• avgRating (0–5), ratingCount
• imageUrl
• sourceUrl — canonical product page URL
• recordType: "product", scrapedAt

Additional fields (mode = byProductUrls only)

• description — full tasting-note / marketing description
• brand, sku
• priceGBP, inStock — primary listing's current price and stock status
• awards[] — competition medals/awards (e.g. "Double Gold — 2022 San Francisco World Spirits Competition"), when the product has any
• reviews[] — up to 25 written customer reviews, each with author, date, rating, reviewText

Input

Field	Type	Default	Description
mode	string	search	search / browseCategory / topRated / byProductUrls
searchQuery	string	laphroaig	Free-text product/brand query (mode=search)
category	string	–	whisky / gin / rum / vodka / beer / wine / liqueur / brandy / champagne / sake — required for browseCategory and topRated, optional filter for search
productUrls	array	–	Product page URLs or paths (mode=byProductUrls)
sortBy	string	relevance	relevance / priceAsc / priceDesc / ratingDesc / abvDesc
minRating	number	–	Drop products below this average rating (0–5)
minRatingCount	int	–	Drop products with fewer ratings than this
minPriceGBP / maxPriceGBP	number	–	Price range in GBP
minAbv / maxAbv	number	–	ABV percentage range
country	string	–	Filter by country of origin (substring match)
inStockOnly	bool	false	Only emit in-stock products
maxItems	int	20	Hard cap on emitted records (1–500)
proxyConfiguration	object	AUTO	Apify proxy config (free AUTO/datacenter group is sufficient)

Example: search by name

{
  "mode": "search",
  "searchQuery": "hendricks gin",
  "maxItems": 30
}

Example: browse a category with filters

{
  "mode": "browseCategory",
  "category": "whisky",
  "minAbv": 40,
  "maxPriceGBP": 100,
  "inStockOnly": true,
  "maxItems": 50
}

Example: top-rated rums

{
  "mode": "topRated",
  "category": "rum",
  "minRatingCount": 10,
  "maxItems": 20
}

Example: full product detail with reviews

{
  "mode": "byProductUrls",
  "productUrls": [
    "https://www.masterofmalt.com/whiskies/laphroaig/laphroaig-10-year-old-sherry-oak-whisky/"
  ]
}

Use cases

• Price monitoring — track bottle prices and sale status across whisky, gin, rum and more
• Market research — analyze rating distribution and review sentiment by category or country
• Recommendation engines — feed real customer ratings into a drinks recommender
• Retail intelligence — spot best-sellers and top-rated products per category
• Content & comparison sites — build "best whisky under £50" style roundups from live data

FAQ

Is this affiliated with Master of Malt? No — this is an independent, third-party actor that reads publicly available product and review pages.

Do I need an account, cookies, or API key? No. All modes work anonymously.

Why do some products have no avgRating? Ratings are only included when the product has at least one customer review; new or unreviewed listings omit the field entirely rather than showing a 0.

What currency are prices in? GBP (British Pounds), Master of Malt's base currency.

How does topRated differ from browseCategory sorted by rating? topRated first gathers a larger candidate pool within the category (filtering out very-low-review-count outliers by default), then ranks by rating — giving a more meaningful "best of" list than a single sorted page.

Why is category required for browseCategory and topRated but optional for search? search is a free-text query across the whole catalog; category there just narrows the results. browseCategory/topRated need a category to know which slice of the catalog to browse.

Can I look up a specific bottle directly? Yes — use mode=byProductUrls with the product's page URL to get full details and up to 25 written reviews.

How fresh is the data? Real-time — every run reads the live site.