# Instacart Scraper — US Supermarket Prices & Promotions (`rbbscrap/instacart-scraper`) Actor

Extract live grocery prices, multi-buy promos (BOGO), discounts, unit sizes, aisle categories, and stock status across Kroger, Publix, Safeway, Aldi, and Sprouts via Instacart. Zero-browser 256MB RAM.

- **URL**: https://apify.com/rbbscrap/instacart-scraper.md
- **Developed by:** [Hector](https://apify.com/rbbscrap) (community)
- **Categories:** E-commerce, Business
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.35 / 1,000 scraped instacart grocery items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

<p align="center">
  <img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/j3LwUg3Ig5cGGFUme-actor-xDXlanYQLAqIh5pcK-757lRovaEB-Screenshot_2026-09-30_at_12.47.47_am.png" alt="Instacart official logo" width="72" height="72" />
</p>

## Instacart Scraper — US Supermarket Prices & Promotions

> **Pay-Per-Event Pricing ($0.35 / 1,000 items — 5x–10x cheaper than #1, 1st Run 100% Free!)** · Built for **Zero-Browser 256MB RAM** execution on Apify Cloud · Export to **JSON, CSV, Excel, Make, n8n, Zapier & MCP**.

**Related US Scrapers**: [Costco Scraper](https://apify.com/rbbscrap/costco-scraper) · [DoorDash Scraper](https://apify.com/rbbscrap/doordash-scraper) · [Home Depot Scraper](https://apify.com/rbbscrap/homedepot-scraper) · [Amazon Scraper](https://apify.com/rbbscrap/amazon-scraper)

***

### What does Instacart Scraper do?

US Supermarket Prices & Promotions extractor built for speed, reliability, and ultra-low compute cost. Run a **1-Click Run** immediately using prefilled US defaults or pass your own keywords, filters, and direct URLs.

#### Beyond the Official API

Instead of maintaining separate scrapers for Kroger, Publix, Safeway, Aldi, Sprouts, and Costco, Instacart aggregates virtually every US supermarket chain in one unified storefront. This actor parses live server-rendered product cards without launching a browser, delivering supermarket pricing & BOGO promotions on 256MB RAM.

***

### What data can you scrape?

| Category | Extracted Fields & Capabilities |
| :--- | :--- |
| **Multi-Supermarket Coverage** | Retailer Slug (`kroger`, `safeway`, `publix`, `aldi`, `sprouts`) |
| **Pricing & Unit Economics** | Current Price, Original Price, Discount % & Unit Price |
| **Promotions & BOGO** | Multi-Buy Deals (`Buy 2 for $5.39`), Loyalty Card & Badges |
| **Inventory & Sizing** | Package Size (`64 fl oz`, `1 gal`), Stock Status & Brand |
| **Aisle Taxonomy** | Auto-Categorized Shelf Aisle (`Dairy & Eggs`, `Beverages`, `Produce`) |
| **Direct Product Links** | Full Instacart Product URL with Retailer Attribution |

***

### Why scrape Instacart? (Typical Use Cases)

- **CPG & Food Brands**: Audit regional shelf prices, out-of-stock rates, and promotional discounts across US grocery banners.
- **Inflation & CPI Research Teams**: Track basket pricing trends daily for milk, eggs, coffee, meat, and organic staples.
- **Retail & Grocery Price Intelligence**: Compare private-label prices (Kroger, O Organics, Kirkland) against national brands.
- **Consumer Deal & Meal Planning Apps**: Build real-time BOGO and loyalty deal feeds per ZIP code.

***

### How to scrape Instacart data (4 Simple Steps)

1. Enter a **Grocery Search Keyword** (e.g. `organic milk`, `coffee`) and choose your target **Retailer Slugs** (`kroger`, `safeway`, `publix`).
2. Optionally enable `onlyOnSale`, set a `maxPrice`, or filter by `aisleFilter`.
3. Click **Start** — your **1st run is 100% free** (`$0.00` billed).
4. Download structured supermarket pricing data as JSON, CSV, or Excel.

***

### Input Configuration & Examples

| Parameter | Type | Description | Default |
| :--- | :--- | :--- | :--- |
| `searchQuery` | `string` | Grocery product or CPG brand to search across Instacart retailers (e.g. 'organic milk', 'olive oil', 'coffee', 'energy drink'). | `"organic milk"` |
| `retailerSlugs` | `array` | List of Instacart supermarket slugs to pull live storefronts from (e.g. 'kroger', 'safeway', 'publix', 'aldi', 'sprouts'). | `["kroger","safeway","publix"]` |
| `storeUrls` | `array` | Optional direct instacart.com/store/... URLs to scrape. | `[]` |
| `zipCode` | `string` | 5-digit US ZIP code context for regional CPG pricing. | `"94107"` |
| `maxItems` | `integer` | Maximum number of grocery product records to return (1–500). | `25` |
| `onlyOnSale` | `boolean` | Keep only products with an active discount, loyalty price, or BOGO/multi-buy deal. | `false` |
| `onlyInStock` | `boolean` | Skip items flagged as Out of stock. | `true` |
| `maxPrice` | `number` | Optional price ceiling in USD (set 0 for no maximum). | `0` |
| `aisleFilter` | `string` | Optional keyword filter (e.g. 'Dairy', 'Beverages', 'Bakery', 'Produce'). | `""` |
| `proxyConfiguration` | `object` | Optional Apify Proxy configuration. | `{"useApifyProxy":false}` |

#### Example Inputs

##### Multi-Chain Organic Milk Price Check (Default 1-Click)

```json
{
  "searchQuery": "organic milk",
  "retailerSlugs": [
    "kroger",
    "safeway",
    "publix"
  ],
  "zipCode": "94107",
  "maxItems": 25
}
```

##### Only Supermarket Deals & Loyalty Promos

```json
{
  "searchQuery": "coffee",
  "retailerSlugs": [
    "kroger",
    "safeway"
  ],
  "onlyOnSale": true,
  "onlyInStock": true,
  "maxItems": 40
}
```

***

### Output Example (Table View, JSON & Output Fields Reference)

```json
{
  "productId": "20142088",
  "retailer": "kroger",
  "productName": "Kroger 100% Apple Juice",
  "brand": "Kroger",
  "currentPrice": 2.79,
  "originalPrice": 3.29,
  "discountPercent": 15,
  "promoText": "Buy 2 for $5.39 | Loyalty Card Deal",
  "sizeUnit": "64 fl oz",
  "unitPriceText": "$0.04 / fl oz",
  "stockStatus": "Many in stock",
  "aisleCategory": "Beverages",
  "zipCode": "94107",
  "currency": "USD",
  "productUrl": "https://www.instacart.com/products/20142088-kroger-100-apple-juice-64-fl-oz?retailerSlug=kroger",
  "scrapedAt": "2026-11-13T09:15:00.000Z"
}
```

#### Output Fields Reference

| Field | Description |
| :--- | :--- |
| `productId / retailer` | Instacart numeric product ID and supermarket banner slug |
| `productName / brand` | Full item name and extracted brand |
| `currentPrice / originalPrice` | Sale/current price and regular shelf price in USD |
| `discountPercent / promoText` | Calculated % discount plus BOGO / loyalty deal text |
| `sizeUnit / unitPriceText` | Extracted package size and computed per-unit price |
| `stockStatus / aisleCategory` | Live inventory status and inferred grocery aisle |
| `productUrl` | Direct Instacart product link with retailer attribution |

***

### Related & Dedicated Scrapers

| Scraper | Niche | Why Combine It? |
| :--- | :--- | :--- |
| **[Costco Scraper](https://apify.com/rbbscrap/costco-scraper)** | US Market Data | Track Costco Wholesale warehouse club pricing & .97 deals |
| **[DoorDash Scraper](https://apify.com/rbbscrap/doordash-scraper)** | US Market Data | Extract restaurant & convenience store delivery menus |
| **[Home Depot Scraper](https://apify.com/rbbscrap/homedepot-scraper)** | US Market Data | Monitor hardware, lumber & Pro Xtra store pricing |
| **[Amazon Scraper](https://apify.com/rbbscrap/amazon-scraper)** | US Market Data | Benchmark Amazon Fresh & Pantry CPG prices |

***

### Error Items & Resilience Reference

- **Anti-Bot & Timeout Protection**: Strict request timeouts (12–15s) and global 75s safety exit guarantee zero runaway compute charges.
- **Zero-Null Guarantee**: Every normalized field defaults cleanly without `null` or `undefined` gaps breaking downstream Make/n8n/Zapier parsers.
- **No Unwanted Compute Drain**: Zero headless browser overhead — runs cleanly at `256 MB` RAM.

***

### Frequently Asked Questions (FAQ)

#### 1. How much does it cost, and is the first run really free?

This scraper uses **Pay-Per-Event** pricing at **$0.00035 per record** (**$0.35 / 1,000 items**), roughly **5x–10x cheaper** than leading competitors. Your **very first run is 100% free** (`$0.00` event charges waived automatically via our developer trial registry).

#### 2. Can I connect this scraper to Make, n8n, or Zapier?

Yes. Every dataset item is flat, strongly typed JSON ready for **Make (Integromat)**, **n8n**, **Zapier**, Google Sheets, Airtable, and webhooks.

#### 3. How do I call this actor via Python or Node.js API?

Use `apify-client` in Python or Node.js by passing your `APIFY_TOKEN` and actor slug `rbbscrap/instacart-scraper`, then read `client.dataset(run["defaultDatasetId"]).iterate_items()`.

#### 4. Does it work with Claude Desktop, Cursor, or AI Agents (MCP)?

Yes. Connect the official **Apify MCP Server** and invoke `rbbscrap/instacart-scraper` directly as a tool inside Claude, Cursor, or Windsurf.

#### 5. Do I need residential proxies or cookies?

No cookies are required. Default runs work immediately without paid proxies; an optional `proxyConfiguration` input is available for localized or high-volume direct URL runs.

#### 6. Is scraping public data legal (GDPR / US compliance)?

This actor only reads publicly accessible web pages and public APIs without bypassing login gates or paywalls, and does not harvest private personal data under **EU Regulation 2016/679 (GDPR)**. Ensure your downstream usage complies with applicable local laws and target site terms.

#### 7. Where can I report an issue or request a new field?

Open an issue directly on our Apify Actor page: [Report an Issue / Request Feature](https://apify.com/rbbscrap/instacart-scraper/issues/open).

# Actor input Schema

## `searchQuery` (type: `string`):

Grocery product or CPG brand to search across Instacart retailers (e.g. 'organic milk', 'olive oil', 'coffee', 'energy drink').

## `retailerSlugs` (type: `array`):

List of Instacart supermarket slugs to pull live storefronts from (e.g. 'kroger', 'safeway', 'publix', 'aldi', 'sprouts').

## `storeUrls` (type: `array`):

Optional direct instacart.com/store/... URLs to scrape.

## `zipCode` (type: `string`):

5-digit US ZIP code context for regional CPG pricing.

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

Maximum number of grocery product records to return (1–500).

## `onlyOnSale` (type: `boolean`):

Keep only products with an active discount, loyalty price, or BOGO/multi-buy deal.

## `onlyInStock` (type: `boolean`):

Skip items flagged as Out of stock.

## `maxPrice` (type: `number`):

Optional price ceiling in USD (set 0 for no maximum).

## `aisleFilter` (type: `string`):

Optional keyword filter (e.g. 'Dairy', 'Beverages', 'Bakery', 'Produce').

## `proxyConfiguration` (type: `object`):

Optional Apify Proxy configuration.

## Actor input object example

```json
{
  "searchQuery": "organic milk",
  "retailerSlugs": [
    "kroger",
    "safeway",
    "publix"
  ],
  "storeUrls": [],
  "zipCode": "94107",
  "maxItems": 25,
  "onlyOnSale": false,
  "onlyInStock": true,
  "maxPrice": 0,
  "aisleFilter": "",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

No description

# 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 = {
    "searchQuery": "organic milk",
    "retailerSlugs": [
        "kroger",
        "safeway",
        "publix"
    ],
    "storeUrls": [],
    "zipCode": "94107",
    "maxItems": 25,
    "onlyOnSale": false,
    "onlyInStock": true,
    "maxPrice": 0,
    "aisleFilter": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("rbbscrap/instacart-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 = {
    "searchQuery": "organic milk",
    "retailerSlugs": [
        "kroger",
        "safeway",
        "publix",
    ],
    "storeUrls": [],
    "zipCode": "94107",
    "maxItems": 25,
    "onlyOnSale": False,
    "onlyInStock": True,
    "maxPrice": 0,
    "aisleFilter": "",
}

# Run the Actor and wait for it to finish
run = client.actor("rbbscrap/instacart-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 '{
  "searchQuery": "organic milk",
  "retailerSlugs": [
    "kroger",
    "safeway",
    "publix"
  ],
  "storeUrls": [],
  "zipCode": "94107",
  "maxItems": 25,
  "onlyOnSale": false,
  "onlyInStock": true,
  "maxPrice": 0,
  "aisleFilter": ""
}' |
apify call rbbscrap/instacart-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rbbscrap/instacart-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/k2lWPgbXmvzNRdqPo/builds/VPXZG2XUeDCziXmoh/openapi.json
