SAQ Scraper — Quebec Wine & Spirits Prices, Sales & Store Stock

Scrape the full SAQ catalogue (Société des alcools du Québec, saq.com): wine, spirits, beer, cider, sake and more — with current and regular prices, rebates, bonus points, UPC codes, producers, import agents, grapes, vintages, tasting profiles, ratings and store-level stock with exact quantities.

Search like the saq.com search box, list whole categories, track a watch-list of SAQ codes, or pull the store directory. English or French. No SAQ account needed.

What you can do with it

• Price & sale tracking — run it daily on a list of SAQ codes or a category and see price drops, rebates and bonus-point offers as they appear.
• "What's in stock near me?" — products available at the stores nearest a postal code, or at specific stores, with the quantity on each shelf.
• Trade & import-agency intelligence — every listing with its producer, import agent, listing type (continuous supply, speciality lot, private import), status and UPC. Watch competitors' listings and delistings.
• Restaurants & retailers — find where a wine is still available and how many bottles each store holds.
• Cross-province price comparison — match on UPC against other Canadian liquor boards.
• Wine apps & datasets — grapes, appellations, alcohol and sugar content, SAQ taste tags, aromas, body, acidity, serving temperature and ageing potential.

Input

Field	What it does
Search terms	Keywords, e.g. merlot, gin, Tanqueray, Rioja. Each term runs its own search.
Categories	Names or paths in English or French: Red wine, vin blanc, Spirit, products/spirit/gin.
saq.com URLs	Category, search or product pages copied from saq.com.
SAQ codes	Specific products by SAQ code (e.g. 11184968).
Language	en or fr — names, types, countries and tasting notes in that language.
Availability	Any, in stock (online or in store), online only, in stores only.
On sale only	Only products with a current rebate.
Min / max price	Price band in CAD.
Countries of origin	e.g. Italy, france, USA, Italie — matched to SAQ's spelling in either language, any case or accents.
Location	Postal code (H2X 1Y4), a city (Sherbrooke, QC) or latitude,longitude.
Nearest stores	Only products in stock at the N stores nearest the location.
Store IDs	Only products in stock at these stores.
Include store quantities	Adds each product's stores (nearest first) with the exact quantity on hand.
Mode: Stores	Lists SAQ stores instead of products (address, phone, GPS, hours, services), optionally the N nearest.
Max results / per query	Caps for the run and for each search, category or URL.

Filters used on their own (for example just On sale only) apply to the whole catalogue.

Example inputs

Everything on sale at the three stores nearest a postal code:

{ "onSaleOnly": true, "location": "H2X 1Y4", "nearestStores": 3 }

French red wines between $15 and $20, in French:

{ "categories": ["vin rouge"], "countries": ["France"], "minPrice": 15, "maxPrice": 20, "language": "fr" }

Daily watch-list with shelf quantities near Quebec City:

{ "skus": ["11184968", "10699644", "12592980"], "includeStoreInventory": true, "maxStoresPerProduct": 10, "location": "G1R 4P5" }

Output

One row per product (store rows in Stores mode). Example (trimmed):

{
  "sku": "11184968",
  "name": "Rocca di Montemassi Le Focaie Maremma Toscana",
  "url": "https://www.saq.com/en/11184968",
  "imageUrl": "https://www.saq.com/media/catalog/product/1/1/11184968-1_1691165583.png",
  "productType": "Red wine",
  "price": 16.5,
  "regularPrice": 17.5,
  "onSale": true,
  "discountPercent": 5.71,
  "latestOffers": ["Bonus point", "Rebates"],
  "bonusPoints": 500,
  "inStock": true,
  "availableOnline": true,
  "availableInStores": true,
  "storeCountInStock": 127,
  "storeIdsInStock": ["23002", "23008", "…"],
  "country": "Italy",
  "region": "Tuscany",
  "appellation": "Maremma Toscana",
  "sizeMl": 750,
  "alcoholPercent": 13,
  "sugarGramsPerLitre": 2.2,
  "tasteTag": "Aromatic and supple",
  "aromas": ["pastry", "wild fruit", "sweet spices", "vanilla"],
  "tasting": { "body": "medium-bodied", "acidity": "present", "sweetness": "dry", "oak": "dominant", "servingTempMinC": 15, "servingTempMaxC": 17, "agingPotential": "Drink now or keep 6 years following the vintage" },
  "producer": "C.D.A. S.A.R.L.",
  "importAgent": "Mosaiq Vins et Spiritueux Inc.",
  "upc": "08002235023313",
  "listingType": "Current continuous supply",
  "specialFeatures": ["Organic product"],
  "ratingPercent": 88,
  "reviewCount": 90,
  "storeInventory": [
    { "storeId": "23028", "name": "Faubourg Sainte-Catherine", "city": "Montréal", "phone": "514 935-5127", "distanceKm": 1.81, "quantity": 6, "openingHours": [{ "day": "Monday", "open": "13:00", "close": "20:00" }] }
  ]
}

Also included: color, subRegion, designation, classification, grapes, grapeShares, vintage, unitsPerPack, spiritType, closure, container, productStatus, quebecProduct, newArrival, depositFee, onlineQuantityLimit, description, availableSince, language, source, scrapedAt.

Download as JSON, CSV, Excel or via API. The dataset has three views: Products, Trade (producer, agent, UPC, listing) and Stores.

Speed

About 250 products per request — a 1,000-product category takes seconds, and the whole catalogue (~26,700 products) runs in a few minutes. Store quantities add one request per product.

FAQ

Do I need an SAQ account? No.

How fresh is the data? Live — prices, sales and stock are read at run time.

Why is grapes or tasteTag empty for some products? SAQ only publishes them for some products (e.g. wines have grapes, beers don't).

What do inStock, availableOnline and availableInStores mean? availableOnline: can be ordered on saq.com. availableInStores: on the shelf in at least one store (storeCountInStock stores). inStock: either.

How do I get store IDs? Run the Stores mode (optionally with a location and Nearest stores) — each row has a storeId.

Can I get French data? Yes — set Language to fr. Category names and paths are translated automatically.

Is there a limit? Only the ones you set. Very large queries are split automatically so nothing is cut off.

Is it legal to scrape SAQ? This Actor only collects publicly available data: product listings, prices, sales, stock levels and store locations that anyone can see on saq.com without an account. Collecting publicly available data is generally legal, but you're responsible for how you use it. You must follow privacy laws such as GDPR, PIPEDA and CCPA, as well as the SAQ's terms. If you're unsure, check with a lawyer. More on this: Is web scraping legal?

Does it access any private data? No. Everything comes from pages SAQ shows to any visitor without logging in. It never uses a login, never touches private or restricted accounts, and never reaches password-protected areas.