Grocery Deals & Flyer Scraper for Flipp (US & Canada)

Extract grocery flyer & online deals from Flipp at scale: item name, current & original price, discount, sale story, merchant, validity dates and image. Search by product/category and postal code and get clean JSON/CSV/Excel in seconds. Built for price tracking, deal aggregation, comparison and market research.

---

What This Actor Does

Flipp aggregates weekly grocery flyers and online deals from thousands of US & Canadian retailers. This Actor turns a product search into a structured deals dataset. For each deal it returns:

• Item — name, weight/size, image
• Pricing — current price, original price, discount % and the sale story (e.g. "SAVE 46%")
• Merchant — store name, logo, flyer ID
• Validity — deal start and end dates
• Online extras — SKU, rating, review count and shipping (for e-commerce deals)

Search one or many terms for a postal/ZIP code and it returns matching flyer and online deals, deduped.

---

Why Use This

• Local grocery prices & discounts. Real, current deals for a ZIP/postal code across many stores — perfect for price tracking and comparison.
• Flyer + online in one. Printed weekly-flyer deals and online/e-commerce deals together, each tagged by type.
• Discount intelligence. Current vs original price, discount % and sale story make it easy to rank the best deals.
• Fast and clean. Reads Flipp's own public API — no anti-bot, no browser, no proxy needed.

---

Quick Start

Run it in the console (no code)

1. Add Search terms (e.g. milk, eggs, coffee).
2. Enter a Postal / ZIP code (US ZIP like 10001 or Canadian like M5V2T6) and pick the Locale.
3. Click Start, then export as JSON, CSV, Excel or HTML, or push to Google Sheets, a webhook or a database.

Run it via API (Python)

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {
    "searchTerms": ["milk", "eggs", "coffee"],
    "postalCode": "10001",
    "locale": "en-us",
}

run = client.actor("YOUR_USERNAME/flipp-scraper").call(run_input=run_input)

for d in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(d["name"], "·", d["currentPrice"], "·", d["merchant"], "·", d.get("saleStory"))

Find the cheapest option per term (Python)

run = client.actor("YOUR_USERNAME/flipp-scraper").call(run_input={
    "searchTerms": ["chicken breast"], "postalCode": "60601",
})
best = {}
for d in client.dataset(run["defaultDatasetId"]).iterate_items():
    if d.get("currentPrice") is not None:
        key = d["searchTerm"]
        if key not in best or d["currentPrice"] < best[key]["currentPrice"]:
            best[key] = d
for term, d in best.items():
    print(term, "→", d["merchant"], d["currentPrice"])

---

Input Parameters

Field	Type	Description
searchTerms	array	Products/categories to search (e.g. milk, eggs).
postalCode	string	US ZIP or Canadian postal code for local flyers.
locale	string	en-us or en-ca.
includeEcom	boolean	Also include online/e-commerce deals. Default true.
maxItems	integer	Max deals across all terms. 0 = no limit.
proxyConfiguration	object	Apify Proxy. Datacenter is enough and enabled by default.

---

Output

Each deal is one record:

{
  "type": "flyer",
  "name": "Eclipse Non-Dairy Whole Milk",
  "currentPrice": 2.99,
  "originalPrice": 5.49,
  "discountPercent": 46,
  "saleStory": "SAVE 46%",
  "itemWeight": "64 oz",
  "merchant": "Food Bazaar Supermarket",
  "flyerId": "8141393",
  "validFrom": "2026-09-24T04:00:00+00:00",
  "validTo": "2026-10-01T03:59:59+00:00",
  "imageUrl": "https://f.wishabi.net/page_items/....jpg",
  "searchTerm": "milk",
  "postalCode": "10001"
}

Online deals (type: "online") additionally include sku, averageRating, totalReviews and shippingInfo.

---

Use Cases

1. Grocery price tracking

Track current prices and discounts for products across local stores over time — a base for price-monitoring apps and dashboards.

2. Deal aggregation & comparison

Aggregate the best weekly deals by product and merchant for a ZIP code — power a savings/comparison site or newsletter.

3. Competitive & pricing intelligence

Compare how retailers price and discount the same products in a market.

4. Market & CPG research

Analyze promotions, discount depth and merchant activity by category and region.

5. Personal savings automation

Feed deals into a shopping-list or budget tool to surface the cheapest options near you.

---

Tips

• More terms = more coverage. Add several products/categories; results are deduped across terms.
• Locale must match the code: use en-us with US ZIPs and en-ca with Canadian postal codes.
• type tells flyer (printed weekly-ad) from online (e-commerce) deals.
• Schedule it with Apify Schedules to track weekly-flyer prices over time.

---

Frequently Asked Questions

Do I need an account? No. The Actor reads publicly available deal data — no login required.

Which countries are covered? United States (en-us) and Canada (en-ca) — set the locale to match your postal code.

Why do some flyer items lack a price? Printed-flyer entries are sometimes image-only; this Actor keeps named deals and includes clean online deals with full pricing.

What export formats are supported? JSON, CSV, Excel, HTML, or via API — plus Google Sheets, webhooks, Make and Zapier.

---

Legal & Responsible Use

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Flipp or any retailer. All trademarks are the property of their respective owners.

It collects only publicly available deal information for research and personal use. You are responsible for how you use the data. Please:

• Respect Flipp's Terms of Service and applicable laws.
• Do not use the data for spam or any unlawful purpose.
• Use reasonable request volumes and scheduling.