Flipp Flyers Scraper — Canadian Grocery & Retail Deals

Flipp Flyers Scraper — Canadian Grocery & Retail Deals

---

Scrape this week's flyer deals of every Canadian grocer and retailer in one run. Give the Actor a Canadian postal code and it returns the items of all flyers published on Flipp for that region — Maxi, Provigo, Loblaws, No Frills, Real Canadian Superstore, Metro, Super C, Food Basics, IGA, Sobeys, FreshCo, Walmart, Costco, Giant Tiger, Canadian Tire, Shoppers Drug Mart / Pharmaprix, Jean Coutu, Home Depot, RONA, Best Buy and 150+ more banners. Add a keyword (milk, chicken breast, laundry detergent) to search all flyers at once, or a list of merchants to keep only the stores you care about.

Each record carries the item name, merchant, sale price, promotion text, validity dates, flyer name, a cut-out image and a public flipp.com link. English and French (fr-ca) catalogues are supported.

Data source: the public flyer service behind flipp.com (backflipp.wishabi.com). No login, no cookies, no browser — the Actor is fast and cheap to run.

---

📋 Example Output

{
  "id": "1048322120",
  "url": "https://flipp.com/en-ca/item/1048322120-farm-boy-farm-boy-organic-milk-or-cream?postal_code=M5V3L9",
  "title": "Farm Boy™ Organic Milk or Cream",
  "merchant": "Farm Boy",
  "brand": null,
  "price": 3.99,
  "priceText": "$3.99 ea",
  "prePriceText": null,
  "postPriceText": "ea",
  "originalPrice": 5.99,
  "saleStory": "Save $1-$2 ea",
  "discount": 33,
  "validFrom": "2026-10-22T04:00:00+00:00",
  "validTo": "2026-10-29T03:59:59+00:00",
  "flyerId": "8191964",
  "flyerTitle": "Weekly",
  "imageUrl": "https://f.wishabi.net/page_items/437585099/1792301779/extra_large.jpg",
  "categories": "Food, Beverages & Tobacco > Beverages",
  "itemType": "flyer",
  "postalCode": "M5V3L9",
  "scrapedAt": "2026-10-28T19:58:18.625Z"
}

⚙️ Configuration

Parameter	Type	Default	Description
postalCode	String	(required)	Canadian postal code, e.g. M5V3L9 (Toronto) or H2X 1Y6 (Montréal). Flyers differ by region.
query	String	(empty)	Keyword search across all flyers at the postal code (about 90 flyer items plus the merchants' online deals). Leave empty to scrape every item of every flyer.
merchants	Array	(all)	Merchant names to keep, e.g. ["Maxi", "Metro", "IGA"]. Case- and accent-insensitive; Familiprix also matches Familiprix Extra.
locale	String	en-ca	en-ca or fr-ca (French flyer catalogue, e.g. for Québec).
maxItems	Integer	0	Max items to return (0 = all). One supermarket flyer holds 300-600 items; all flyers at one postal code hold tens of thousands.
proxyConfiguration	Object	Apify Proxy (auto)	Proxy settings.

Example Input

Every deal of the Maxi, IGA and Metro flyers around Montréal, in French:

{
  "postalCode": "H2X 1Y6",
  "locale": "fr-ca",
  "merchants": ["Maxi", "IGA", "Metro"],
  "maxItems": 0
}

Every flyer item mentioning milk in downtown Toronto:

{
  "postalCode": "M5V3L9",
  "query": "milk",
  "maxItems": 100
}

Two modes

1. Flyer mode (no query): the Actor lists every flyer available at the postal code (optionally filtered by merchants), then downloads each flyer's items one by one until maxItems is reached. price, discount, validity dates and flyerTitle are filled for nearly every item; saleStory / prePriceText / originalPrice are not published in this feed and stay null.
2. Search mode (query set): a single search call returns the matching flyer items of all merchants with the richer price fields (prePriceText, postPriceText, originalPrice, saleStory, derived discount), followed by the merchants' online-store deals (itemType = ecom, no flyer or validity, prefixed ecom- ids). Flyer items come first, so a small maxItems keeps the printed-flyer deals.

Finding merchant names

Run the Actor once without merchants and look at the merchant column, or check the log line [flyers] N flyers available. When a filter matches nothing, the log lists every merchant available at that postal code.

---

💬 Support and Feedback

Reach out via Apify support channels or leave feedback on the Actor's page.

Is it legal to scrape Flipp flyer data?

The Actor reads the same publicly available flyer data that flipp.com shows to any visitor: product names, prices and validity dates published by the retailers themselves. Flyer content belongs to the respective retailers and is distributed through Flipp's public flyer service; use the data for price comparison, research and personal purposes, and consult your legal advisor before any commercial redistribution. No personal data is collected.