# Regional Grocery Prices: Giant Eagle, Hannaford & Schnucks (`niches/regional-grocery-prices`) Actor

Price, stock & unit price at Giant Eagle, Hannaford, Schnucks, ShopRite, Stop & Shop, Giant Food, Price Chopper, Weis, Tops, Ingles, Save A Lot, Stater Bros, Raley's, Fresh Market, Big Y, Rouses, Food City, Smart & Final, Grocery Outlet, 99 Ranch & Loblaws. Free comparisons & tracking.

- **URL**: https://apify.com/niches/regional-grocery-prices.md
- **Developed by:** [Niches](https://apify.com/niches) (community)
- **Categories:** E-commerce, Marketing
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 products

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

## Regional Grocery Prices: Giant Eagle, Hannaford, Schnucks and 18 more chains

**Get product prices, regular and sale prices, unit prices, sizes, stock signals, UPCs when published, images and product URLs across regional grocery chains in one run.** Search several chains and ZIP codes with one input and one product schema.

Covers **Giant Eagle, Hannaford, Schnucks, ShopRite, Stop & Shop, Giant Food, Price Chopper and Market 32, Weis Markets, Tops, Ingles, Save A Lot, Stater Bros., Raley's, The Fresh Market, Big Y, Rouses, Food City, Smart & Final, Grocery Outlet and 99 Ranch Market**, plus **Loblaws** in Canada.

**These are prices displayed on Instacart for the shop serving the requested location.** They may exceed shelf prices. Delivery is preferred; the row says which shop and fulfillment were used. A chain without a matching local shop produces a free coverage note rather than prices from another region.

**Free comparisons:** each search gets a comparison row in the dataset, with per-chain counts, cheapest and median prices, per-location statistics, the cheapest result containing every search word, the best word match and valid cross-chain UPC matches. USD and CAD have separate records.

**Free price tracking:** repeat a search with the same tracking name to see the previous price, price change and first-seen, unchanged, dropped or raised status. Run one job at a time per history.

**Start with the filled-in form:** milk and eggs at six chains in Pittsburgh (`15222`) and Hoboken (`07030`), capped at ten products per chain, search and location. The local check on 12 November 2026 delivered 60 products from Giant Eagle, ShopRite and Stop & Shop, plus two free comparisons. The other three selected chains had no serving shop at these ZIPs.

### Supported chains

| Chain ID | Chain | Example ZIP / postal code |
|---|---|---|
| `giant-eagle` | Giant Eagle | `15222` |
| `hannaford` | Hannaford | `04101` |
| `schnucks` | Schnucks | `63101` |
| `shoprite` | ShopRite | `07030` |
| `stop-and-shop` | Stop & Shop | `02108` |
| `giant-food` | Giant Food | `20001` |
| `price-chopper` | Price Chopper & Market 32 | `12203` |
| `weis-markets` | Weis Markets | `17101` |
| `tops` | Tops Markets | `14202` |
| `ingles` | Ingles | `28801` |
| `save-a-lot` | Save A Lot | `63101` |
| `stater-bros` | Stater Bros. | `92401` |
| `raleys` | Raley's | `95814` |
| `the-fresh-market` | The Fresh Market | `27401` |
| `big-y` | Big Y | `01103` |
| `rouses` | Rouses Markets | `70130` |
| `food-city` | Food City | `37902` |
| `smart-and-final` | Smart & Final | `90012` |
| `grocery-outlet` | Grocery Outlet | `94607` |
| `99-ranch` | 99 Ranch Market | `94538` |
| `loblaws` | Loblaws | `M5V 2T6` |

Price Chopper checks both the New York / Market 32 shop and the separate Kansas City shop. Loblaws uses Canadian postal codes and CAD; it is optional and is not in the default six. Example locations help you choose a trading area; they do not guarantee every product is available.

### What you get

| Field | What it holds |
|---|---|
| Record filter | `recordType` and `kind` are `product` for paid rows and `comparison` for free rows. |
| Product identity | `productId`, `productName`, `brand`, `size`, `image`, `productUrl`, `upc` (null unless supplied). |
| Prices | `price`, `regularPrice`, `onSale`, `currency`, `priceBasis`, `unitPrice`, `unit`. Missing source values remain null. |
| Location and stock | `chainId`, `chain`, `country`, `storeId`, `zipCode`, `fulfillment`, `availability`, `inStock`. |
| Search relevance | `searchTerm`, `rank`, `matchedWords`, `related`, `allWordsMatch`, `matchScore`. |
| Price history | `previousPrice`, `priceChange`, `priceChangePercent`, `priceStatus`, `firstSeenAt`, `priceDropped`, `priceRose`, `newProduct`. |
| Comparison | `productsCompared`, `byChain` (including `byZip`), `cheapestProduct`, `cheapestMatchingProduct`, `bestMatch`, `upcMatches`, `partial`. |
| Evidence and deduplication | `scrapedAt` on products, `generatedAt` on comparisons, and a stable `resultId`. |

### What people use it for

- **Regional price feeds:** Read regional grocers using the same field names, then group by chain, location and currency.
- **Promotion checks:** Find products with a published regular price above the current price and monitor later changes.
- **Product research:** Compare sizes and unit denominators before treating low prices as substitutes.
- **Stock monitoring:** Record the source availability flag and stock label for each shop.
- **Price alerts:** Schedule repeat runs and filter product rows on `priceDropped` or `priceStatus`.
- **Data pipelines:** Export paid product rows separately from free comparisons using `recordType`.

### How to use it

1. Enter one or more **product searches** and **ZIP codes**. For Loblaws, add a Canadian postal code such as `M5V 2T6`.
2. Select the **chains** and set **maxProductsPerChain**, which applies to each search at each location across that chain's banners.
3. Leave **onlyRelated** on to skip and avoid charges for results sharing no search word with the product name or brand.
4. Start the run. Filter `recordType=product` for products or `recordType=comparison` for the free comparisons. Check `SUMMARY` for local coverage and failures.
5. Repeat with **trackPrices** on and the same **trackingName** for a price-change feed.

### Input

| Field | Example | Notes |
|---|---|---|
| `searches` | `["milk", "eggs"]` | One to 20 search strings; be specific about brand, size or type. |
| `zipCodes` | `["15222", "07030"]` | One to 10 US ZIP / Canadian postal codes. Each chain checks its own country only. |
| `chains` | Six chains preselected | IDs in the supported-chain table; select any subset. |
| `maxProductsPerChain` | `10` | One to 500 delivered rows per chain, search and location. Visible source results may be fewer. |
| `onlyRelated` | `true` | Case- and accent-insensitive whole-word overlap in product name or brand. Zero overlap is skipped and free. |
| `trackPrices` | `true` | Free comparison with your last completed history. False leaves tracking fields null. |
| `trackingName` | `weekly-groceries` | Optional separate history name, at most 80 characters. |

### Output

Each result is one row in the run's dataset (download it as JSON, CSV, Excel, XML or HTML, or read it through the API). An example row (values shortened):

```json
{
  "kind": "product",
  "recordType": "product",
  "chainId": "giant-eagle",
  "chain": "Giant Eagle",
  "source": "instacart",
  "country": "US",
  "storeId": "167407",
  "zipCode": "15222",
  "searchTerm": "milk",
  "rank": 1,
  "productId": "25819679",
  "productName": "Giant Eagle Vitamin D Whole Milk",
  "brand": "Giant Eagle",
  "size": "128 oz",
  "price": 5.49,
  "regularPrice": null,
  "onSale": false,
  "currency": "USD",
  "priceBasis": "instacart",
  "unitPrice": 0.04,
  "unit": "fl oz",
  "availability": "Many in stock",
  "inStock": true,
  "upc": null,
  "image": "https://d2lnr5mha7bycj.cloudfront.net/product-image/file/large_e2c32a3d-38fa-4402-bf03-bea567d1de99.png",
  "productUrl": "https://www.instacart.com/store/giant-eagle/products/25819679-eagle-vitamin-d-whole-milk-1-gal",
  "fulfillment": "delivery",
  "scrapedAt": "2026-11-12T16:02:03Z",
  "previousPrice": null,
  "priceChange": null,
  "priceChangePercent": null,
  "priceStatus": "first-seen",
  "firstSeenAt": "2026-11-12T16:02:03Z",
  "priceDropped": false,
  "priceRose": false,
  "newProduct": true,
  "matchedWords": [
    "milk"
  ],
  "related": true,
  "allWordsMatch": true,
  "matchScore": 1.0,
  "resultId": "adbdb670da8404d1fe5583cc164544af8c0a16ad69f6e62d7567b0e8346d2acb"
}
```

The example above is a real row from a run on 12 November 2026. Values vary by time and location. `SUMMARY` in the key-value store lists every selected chain, each searched location, missing coverage, skipped unrelated products, failures, requests and charged products. `COMPARISONS` contains the same free comparison records delivered to the dataset. A comparison marked `partial` has a failed, unrun or spending-limited chain.

### Pricing

- **$0.0015 per delivered product row** ($1.50 per 1,000). One primary `product` event; no run fee.
- Comparisons, price tracking, missing-shop notes, failures and skipped unrelated or unpriced products are free.
- The billing unit is a product in one chain, location and search. A product appearing in two distinct searches or ZIP codes is a separate contextual row for each. Repeated identical inputs are deduplicated within a run.

What typical jobs cost at the list price:

| Job | Cost |
|---|---|
| 60 products, as in the local default check | $0.09 |
| 1,000 product rows across any selected chains | $1.50 |
| 200 product rows daily for 30 days | $9.00 |
| No priced products delivered | $0.00 |

Set Maximum cost per run to your budget. The Actor stops paid delivery when another product does not fit, and still writes the free comparisons and summary. Store plan discounts may reduce the list price.

### Tips

- Select ZIP codes where the selected chains trade. An empty result at one location does not establish that the chain has no catalog elsewhere.
- Filter `recordType=product` before counting paid products. Comparison rows are free and add to total dataset rows.
- Use `allWordsMatch=true` for a stricter text match. `cheapestMatchingProduct` requires every search word; `bestMatch` ranks word coverage, then source rank, then price.
- Word matching does not establish an identical item. For example, milk and milk chocolate share a word. Check brand, size and valid UPC matches before comparing equivalent products.
- Use the same tracking name for successive checks, and different names for independent histories. Only delivered products enter the history.

### Use it through the API

**Python**

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("niches/regional-grocery-prices").call(run_input={"searches": ["milk", "eggs"], "zipCodes": ["15222", "07030"], "chains": ["giant-eagle", "hannaford", "schnucks", "shoprite", "stop-and-shop", "giant-food"], "maxProductsPerChain": 10, "onlyRelated": true, "trackPrices": true})
for row in client.dataset(run.default_dataset_id).iterate_items():
    print(row)
```

**JavaScript**

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

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('niches/regional-grocery-prices').call({"searches": ["milk", "eggs"], "zipCodes": ["15222", "07030"], "chains": ["giant-eagle", "hannaford", "schnucks", "shoprite", "stop-and-shop", "giant-food"], "maxProductsPerChain": 10, "onlyRelated": true, "trackPrices": true});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

**HTTP (one call, results back)**

```bash
curl -X POST 'https://api.apify.com/v2/acts/niches~regional-grocery-prices/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{"searches": ["milk", "eggs"], "zipCodes": ["15222", "07030"], "chains": ["giant-eagle", "hannaford", "schnucks", "shoprite", "stop-and-shop", "giant-food"], "maxProductsPerChain": 10, "onlyRelated": true, "trackPrices": true}'
```

### Integrations and schedules

- **Schedules:** run it every hour, day or week from the Apify Console (Schedules) and keep a history of results.
- **Make, Zapier, n8n, Google Sheets, Slack, Airtable:** connect it through Apify's integrations, or send each finished run to a **webhook**.
- **Datasets:** results stay in the run's dataset; export them or read them by API whenever you need them.

### Use it with AI agents (MCP)

Add Apify's MCP server with this Actor already pinned (`https://mcp.apify.com?tools=niches/regional-grocery-prices`) to Claude, ChatGPT, Cursor, VS Code or any MCP client. The agent can find this Actor and run it for you: ask it for "milk and egg prices at Giant Eagle, ShopRite and Stop & Shop in Pittsburgh and Hoboken, with a free comparison". AI agents can also pay for runs directly through Apify's agentic payments.

### Limits

- Prices reflect the Instacart shop, location, time and fulfillment. Taxes, delivery charges, memberships, coupons and basket fees are excluded.
- A unit price is preserved with its source denominator. Published unit prices can conflict with displayed sizes, so verify critical comparisons. Units, brands and package sizes are not converted into equivalent products.
- The source supplies a finite visible search-result set. The cap is an upper bound and does not promise 500 products or complete catalog pagination.
- The source often omits UPCs, regular prices and stock labels. Null means unknown, not zero or out of stock. Product IDs are never presented as UPCs.
- Only equal checksum-valid GTIN-8, UPC-12, EAN-13 or GTIN-14 values are grouped as UPC matches. Codes are normalized to 14 digits, and a match must span at least two chains.
- Cheapest and median values describe delivered results, which can differ in product and size. USD and CAD are never ranked together; no exchange conversion is applied.
- Unavailable shops and refused sources are explained in SUMMARY. A login wall stops that source; no login or human check is solved.
- Concurrent runs using the same history may overlap. Run them sequentially for a clear prior-run baseline.

### FAQ

**Do I need a grocery or Instacart account?**

No. The Actor reads the signed-out storefront prices and asks for no retailer login.

**Why are some selected chains empty?**

The chain may not have an Instacart shop serving your ZIP, the query may have no priced related products, or the source may refuse the run. SUMMARY records the reason per location.

**Does onlyRelated mean the same product?**

No. It means at least one whole search word appears in the name or brand, ignoring case and accents. All-words matches are stricter text matches. Equal valid UPC values provide stronger product-identity evidence.

**How is the best match chosen?**

Among results sharing a search word, higher word coverage wins, then lower source rank, then lower price. It is a deterministic text ranking, not a model recommendation.

**Why are there no UPC matches?**

The source may not publish UPCs, or no valid matching code may span multiple chains. No code is inferred from product names or source IDs.

**How do Canadian comparisons work?**

Select Loblaws and provide a Canadian postal code. Its prices and comparisons use CAD. US chains use USD and US ZIP codes, with separate comparison records.

**Which Price Chopper is included?**

Both Market 32 / Price Chopper in the Northeast and Price Chopper in Kansas City. Each banner is checked only for a shop serving the requested ZIP, and product rows name the actual banner.

**How does price tracking work?**

A small key-value history in your account stores delivered products by chain, location, shop, fulfillment and source product ID. Repeat a run with the same tracking name for the previous price and change. Tracking adds no charge.

**Are comparison records charged?**

No. Only priced product rows delivered under the product event are charged. Comparisons remain available when the spending limit stops paid products.

### Support

Questions, a site that changed, or a field you need? Open an issue on this Actor's **Issues** tab: we answer there, usually within a day.

***

Also found as: regional grocery prices, Giant Eagle prices, Hannaford prices, Schnucks prices, ShopRite prices by ZIP, Stop and Shop grocery prices, regional supermarket comparison, Instacart grocery price monitoring.

# Actor input Schema

## `searches` (type: `array`):

One product search per line, such as milk, eggs or jasmine rice. Up to 20 searches, sent to each selected chain at each location.

## `zipCodes` (type: `array`):

Up to 10 five-digit US ZIP codes. For Loblaws use Canadian postal codes such as M5V 2T6. Missing coverage is reported; a distant shop is never substituted. USD and CAD comparisons stay separate.

## `chains` (type: `array`):

Select one or more chains. Price Chopper includes Market 32 and the Kansas City chain. Loblaws is optional, uses Instacart Canada, and needs a Canadian postal code.

## `maxProductsPerChain` (type: `integer`):

Maximum delivered products per chain for each search and location, across its banners. Default 10, maximum 500. The visible source results may be fewer; this is not a full catalog export.

## `onlyRelated` (type: `boolean`):

Skip and do not charge products whose name and brand contain none of the search words. Case and accents are ignored. This is word overlap, not a guarantee of the same product or size.

## `trackPrices` (type: `boolean`):

Compare each delivered product with the last completed history for its chain, shop, location and fulfillment. Previous price, change and price-drop flags are free.

## `trackingName` (type: `string`):

Use a short name such as weekly-groceries for a separate price history. Leave blank for the default history. Run one job at a time per history.

## Actor input object example

```json
{
  "searches": [
    "milk",
    "eggs"
  ],
  "zipCodes": [
    "15222",
    "07030"
  ],
  "chains": [
    "giant-eagle",
    "hannaford",
    "schnucks",
    "shoprite",
    "stop-and-shop",
    "giant-food"
  ],
  "maxProductsPerChain": 10,
  "onlyRelated": true,
  "trackPrices": true
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset: the results.

## `summary` (type: `string`):

What each input returned, and notes.

## `comparisons` (type: `string`):

Comparison records grouped by search and currency.

# 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 = {
    "searches": [
        "milk",
        "eggs"
    ],
    "zipCodes": [
        "15222",
        "07030"
    ],
    "chains": [
        "giant-eagle",
        "hannaford",
        "schnucks",
        "shoprite",
        "stop-and-shop",
        "giant-food"
    ],
    "maxProductsPerChain": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("niches/regional-grocery-prices").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 = {
    "searches": [
        "milk",
        "eggs",
    ],
    "zipCodes": [
        "15222",
        "07030",
    ],
    "chains": [
        "giant-eagle",
        "hannaford",
        "schnucks",
        "shoprite",
        "stop-and-shop",
        "giant-food",
    ],
    "maxProductsPerChain": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("niches/regional-grocery-prices").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 '{
  "searches": [
    "milk",
    "eggs"
  ],
  "zipCodes": [
    "15222",
    "07030"
  ],
  "chains": [
    "giant-eagle",
    "hannaford",
    "schnucks",
    "shoprite",
    "stop-and-shop",
    "giant-food"
  ],
  "maxProductsPerChain": 10
}' |
apify call niches/regional-grocery-prices --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,niches/regional-grocery-prices"
        }
    }
}
```

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/2f9b54XyJ7a0fr518/builds/8ZjTuG9flWpQbepB1/openapi.json
