# Flipp Scraper — No Login, $5/1k (`chimerical_quicklime/flipp-scraper`) Actor

Scrape Flipp grocery flyer deals by ZIP: item name, sale price, merchant, validity dates, and image. Built for grocery price intelligence and deal monitoring. No login or cookies. MCP-ready for AI agents. $5 per 1,000 records.

- **URL**: https://apify.com/chimerical_quicklime/flipp-scraper.md
- **Developed by:** [Khrystyna Skotte](https://apify.com/chimerical_quicklime) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 39 total users, 6 monthly users, 96.6% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.79 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Flipp Grocery Deals & Weekly Flyer Price Scraper

Search the weekly sale flyers of US and Canadian grocery stores, pharmacies and big-box retailers through Flipp, by keyword and ZIP / postal code. Get the item, sale price, store and the dates the deal runs. No login or cookies.

### What data you get

One row per flyer item:

| Field | Description |
|---|---|
| `id` | Flipp flyer item ID |
| `name` | Item name as printed in the flyer |
| `price` | Sale price |
| `originalPrice` | Regular price, when the flyer shows one |
| `saleStory` | Promo text such as "Buy 1 Get 1", when present |
| `merchant` | Store, e.g. Stop & Shop, C Town |
| `postalCode` | The ZIP / postal code you searched |
| `validFrom`, `validTo` | When the deal starts and ends (ISO timestamps) |
| `url` | Image of the flyer clipping |
| `flyerId` | Flipp flyer ID |
| `scrapedAt` | When the row was collected |

`originalPrice` and `saleStory` are only included when the flyer prints them.

### Use cases

- **Grocery price intelligence:** see which chains are discounting an item this week in a market.
- **Promo monitoring for CPG brands:** track where and at what price your products (or a competitor's) are featured.
- **Deal and coupon apps:** feed current local deals into an app, newsletter or chatbot.
- **Retail and inflation research:** sample advertised prices for a basket of items across ZIP codes over time.

### Input

All fields are optional. With no input the actor searches "milk" in ZIP 10001.

| Field | Description |
|---|---|
| `query` | Item or keyword, e.g. `eggs`, `chicken breast`, `Tide` (default `milk`) |
| `postalCode` | US ZIP or Canadian postal code (default `10001`) |
| `maxItems` | Maximum deals to return (default 10) |

```json
{ "query": "eggs", "postalCode": "60614", "maxItems": 100 }
```

Canada:

```json
{ "query": "coffee", "postalCode": "M5V 2T6", "maxItems": 50 }
```

### Output example

From a test run with `{}` input, October 2026:

```json
{
  "id": 1046626107,
  "name": "Tru Moo Milk",
  "price": 2.99,
  "merchant": "Stop & Shop",
  "postalCode": "10001",
  "validFrom": "2026-10-16T04:00:00+00:00",
  "validTo": "2026-10-23T03:59:59+00:00",
  "url": "https://f.wishabi.net/page_items/436869792/1791497130/extra_large.jpg",
  "flyerId": 8182415,
  "scrapedAt": "2026-10-21T07:44:18.904Z"
}
```

Download results as JSON, CSV, Excel or XML, or read them through the Apify API.

### Pricing

Pay per result: **$0.00465 per deal** ($4.65 per 1,000) on the free plan, lower on paid Apify plans (down to $0.00279 per deal, $2.79 per 1,000, on Gold and above), plus a $0.00465 start fee per run.

### FAQ and limits

- **One keyword and one postal code per run.** To cover several items or markets, run the actor once per combination (Apify tasks or the API make this easy).
- **How many results?** As many matching flyer items as Flipp returns for the keyword in that area, up to `maxItems`. Items without a price are skipped.
- **Which stores?** Whichever retailers publish flyers on Flipp for that postal code; coverage varies by area.
- **Prices are flyer prices**, not shelf or online prices, and only for the current flyer week.
- Need another field or filter? Open an issue on the Issues tab.

# Actor input Schema

## `query` (type: `string`):

Grocery item or keyword to search for in Flipp flyers.

## `postalCode` (type: `string`):

Postal code (US ZIP or Canadian) to find local deals for.

## `maxItems` (type: `integer`):

Maximum number of deal records to return.

## Actor input object example

```json
{
  "query": "milk",
  "postalCode": "10001",
  "maxItems": 10
}
```

# Actor output Schema

## `records` (type: `string`):

Dataset of scraped records (JSON).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("chimerical_quicklime/flipp-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("chimerical_quicklime/flipp-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call chimerical_quicklime/flipp-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,chimerical_quicklime/flipp-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/s7rrUvu360cfvx5MJ/builds/WYbhx4TdaPgz3gcVa/openapi.json