Retail, weekly flyers

A weekly flyer API for Canadian and US retailers

Give it a Canadian postal code or a US ZIP code and get the flyer deals near it as rows: product, store, sale and regular price, price per item and per kg, discount, the dates the deal runs and the flyer it came from. Search every flyer for a product, or pull every item in every flyer. $1.50 per 1,000 deals, with no Flipp account or API key.

• $1.50 per 1,000 deals
• 2,500+ retailers, Canada and US
• Past the 200-result cap
• Week-over-week changes

Does Flipp have an API?

Flipp publishes FlyerKit, an API its own documentation describes as access to Flipp's publication data "for use in merchant or publisher applications". Every call needs an access token, and the documentation says to get one from your Flipp account manager (FlyerKit v3.0 documentation, read October 6, 2026). That route is for retailers and publishers showing flyers in their own apps. If you want the deals any shopper sees for a postal code, across every store, this Actor returns them as JSON, CSV or Excel. The README names Walmart, Costco, No Frills, Loblaws, Metro, Sobeys, Shoppers Drug Mart, Canadian Tire, Home Depot, Best Buy, Target, CVS, Walgreens, ALDI and Lowe's among the 2,500+ retailers.

Three ways to use it

Past Flipp's 200-result cap

A search on Flipp stops at 200 results. With completeCoverage on (the default), the Actor sees when a search hits that 200-result cap, re-runs it for each store that has matches and merges the results. In the README's example, "chicken" near a downtown Toronto postal code went from 197 to 715 deals in about 30 seconds, which is $1.07 at $1.50 per 1,000. Turn it off for a quick top-200 sample. sortBy can put the lowest prices first, and every row gets a priceRank within its search (1 = the lowest price, by $/kg for weight-priced items).

Every item in every flyer

Full-flyer mode reads whole flyers instead of searching them. For one Vancouver postal code that is about 18,000 items from 108 flyers in 12 seconds (README): $27.00, plus $9.00 if you add item details. One downtown postal code covers the flyers for most of a metro area. For national coverage, regionPresets has ca-major-cities (46 cities in every province and territory, about 1,200 flyers) and us-major-cities (50 metros); a flyer shared between cities is read once, and dedupeAcrossPostalCodes (on by default) saves each deal once. Narrow it with merchants, categories or searchTerms, and keep only deals running today with onlyValidNow.

Prices you can compare

A weekly price-drop feed

Turn on trackChanges and run the same input on a weekly Apify schedule. The Actor keeps a small snapshot of the last run for each distinct input in your own Apify account, and each row gets changeType (new, price_drop, price_up or unchanged) with previousPrice. The run's CHANGES record lists the totals and the deals that ended. Most retailers publish new flyers weekly, often a day or two before they start, so a Thursday schedule catches the new week. This input is the README's weekly No Frills alert across Canada:

{
  "mode": "flyers",
  "regionPresets": [
    "ca-major-cities"
  ],
  "merchants": [
    "No Frills"
  ],
  "trackChanges": true
}

What it costs

500 deals cost $0.75 plus the $0.001 run start; with item details on, add $0.25. Coverage depends on which retailers publish flyers on Flipp near each code, so test a postal code or ZIP you care about with a small run first.

Limits

• Full postal codes only. A full postal code (M5V 2T6) or a US ZIP works; the first three characters alone (M5V) are not enough.
• Some deals have no single price. "20% off all toys" or "Buy 1 get 1" carry discountPct or saleStory instead. In full-flyer mode, item details fill the sale text and units for most items.
• No archive. Each run reads the flyers live today. Your history is the runs you schedule and keep.
• What Flipp has. A retailer that doesn't publish its flyer on Flipp near your postal code won't appear.

Ask for it from ChatGPT, Claude or Cursor

The Flipp Flyer Deals Scraper works as a tool in ChatGPT, Claude, Cursor and VS Code through Apify's hosted MCP server. Add this URL as a custom connector and sign in with your Apify account; runs bill to that account. Then ask in plain English, for example "find the lowest price per kg for chicken breast in flyers near M5V 2T6 this week".

https://mcp.apify.com/?tools=fetch-actor-details,yugenox/flipp-flyer-deals-scraper

claude mcp add --transport http yugenox-flyers "https://mcp.apify.com/?tools=fetch-actor-details,yugenox/flipp-flyer-deals-scraper"

The AI setup guide walks through each client.

Run it from code

Chicken breast and eggs near one Toronto postal code, lowest price first, at most 500 deals: $0.75 or less, plus the run start. The same input with a US ZIP code works too.

// Save as run.mjs, then: npm i apify-client && APIFY_TOKEN=... node run.mjs
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });

const run = await client.actor('yugenox/flipp-flyer-deals-scraper').call({
  postalCodes: [
    "M5V 2T6"
  ],
  searchTerms: [
    "chicken breast",
    "eggs"
  ],
  sortBy: "price_low_to_high",
  maxItems: 500
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
for (const item of items) console.log(item.merchant, item.name, item.effectivePrice);

import os
from apify_client import ApifyClient  # pip install apify-client

client = ApifyClient(os.environ["APIFY_TOKEN"])

run = client.actor("yugenox/flipp-flyer-deals-scraper").call(run_input={
    "postalCodes": ["M5V 2T6"],
    "searchTerms": ["chicken breast", "eggs"],
    "sortBy": "price_low_to_high",
    "maxItems": 500,
})
if run is None:
    raise RuntimeError("Run did not finish")

for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item.get("merchant"), item.get("name"), item.get("effectivePrice"))

# Small jobs: runs the Actor and returns the rows in one call (up to 5 minutes).
curl -X POST "https://api.apify.com/v2/acts/yugenox~flipp-flyer-deals-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"postalCodes":["M5V 2T6"],"searchTerms":["chicken breast","eggs"],"sortBy":"price_low_to_high","maxItems":500}'

Not affiliated with Flipp, Loblaw Companies Limited, its banners, PC Optimum or any retailer named on this page.

Last updated 2026-10-15.