# Instacart Scraper | Grocery Prices US CA (`lentic_clockss/instacart-scraper`) Actor

Scrape Instacart grocery shops, products, collections, hubs, SEO categories, ETA & search across US and Canada. Extract shopId, retailerSlug, productId, guest prices, availability. Export Excel/CSV/JSON. Unofficial — not affiliated with Instacart.

- **URL**: https://apify.com/lentic\_clockss/instacart-scraper.md
- **Developed by:** [kane liu](https://apify.com/lentic_clockss) (community)
- **Categories:** E-commerce, Travel, Automation
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.20 / 1,000 results

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

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Instacart Scraper | Grocery Products Prices US & CA

**Scrape Instacart grocery shops, storefronts, collections, product details, hubs, SEO categories, delivery ETA, and keyword search across the United States and Canada — then download structured data as Excel, CSV, or JSON.**

Use this Actor as a practical **Instacart grocery data API** for price monitoring, retailer assortment research, and competitive tracking. Choose a market (`us` / `ca`), pick a mode, set limits, and get Dataset rows with `shopId`, `retailerSlug`, `productId`, guest preview prices, availability, and product URLs.

- Scrape **nearby Instacart retailers**, **storefront shelves**, **collections** (produce, beverages, frozen…), **DiscoverNav catalogs**, **hubs** (deals, alcohol, pharmacy…), **SEO categories**, **product detail / batch enrich**, **delivery ETA**, and **keyword search**
- Cover **Instacart.com (US)** and **Instacart.ca (Canada)** including optional **French (fr-CA)** language for Quebec
- Extract **shopId · retailerId · retailerLocationId · productId · priceString · availability · ETA · collectionSlug · product URL**
- Optional **PDP enrich** (`enrichDetails` / `mode=enrich`) and **collection pagination** (`maxPages`)
- Export to **Excel / CSV / JSON**, or connect Make, n8n, Zapier, Python, or the Apify API
- **Pay per event** — Actor start + each Dataset result; **platform usage is included** (you do not pay separate Apify compute on top)

> **Unofficial tool.** This Actor is not affiliated with, endorsed by, or sponsored by Instacart. It collects publicly reachable guest shopping surfaces and does **not** access Instacart+ / member login pricing, place orders, add items to cart, or checkout.

Free Apify-plan users (developer policy): **10 runs** / **200 results** per run.

***

### What does the Instacart Scraper do?

Instacart Scraper lets you **extract structured grocery retailer and product data from Instacart** without running your own anti-bot browser fleet. Give it a ZIP/postal + city preset, a retailer slug (e.g. Costco, Sprouts), a collection / hub / category, a product URL, or a search keyword, then start a run.

Under the hood, the Actor:

1. Validates your input (market, mode, retailer / collection / product / query)
2. Enforces free-tier caps when you are on a free Apify plan
3. Calls a managed scrape backend that opens Instacart with residential egress + stealth browser
4. Reads session GraphQL / JSON-LD / DOM product cards (guest preview prices)
5. Pushes Dataset rows ready for Excel / CSV / JSON export
6. Writes `INPUT_ECHO`, `RUN_SUMMARY` (and `ERROR_SUMMARY` on failure) to the key-value store

You run it like any other Apify Actor — schedule it, call it from the API, or plug it into automations.

***

### What Instacart data can I extract?

| Data | nearMe / retailers | Storefront | Collection | Search | Product / enrich | Hub / category | ETA |
| --- | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
| shopId / retailerSlug | ✅ | ✅ | ✅\* | ✅\* | ✅\* | ✅\* | ✅ |
| Product name / productId | — | ✅ | ✅ | ✅ | ✅ | ✅\* | — |
| Guest price (`priceString`) | — | ✅\* | ✅\* | ✅\* | ✅\* | ✅\* | — |
| Availability / image | — | ✅\* | ✅\* | ✅\* | ✅\* | ✅\* | — |
| Collection / hub slug | — | ✅\* | ✅ | — | — | ✅ | — |
| Delivery ETA | ✅\* | — | — | — | — | — | ✅\* |
| Product URL | — | ✅ | ✅ | ✅ | ✅ | ✅\* | — |

\*When present on the page or after GraphQL / `enrichDetails`. ETA depends on Instacart returning accurate retailer ETAs for the postal code.

***

### Why scrape Instacart?

Instacart aggregates major grocery retailers (Costco, Kroger banners, Walmart, Sprouts, and many local chains) with location-aware prices and availability. Teams scrape Instacart for:

- **Grocery price monitoring** across ZIP codes and metros (SF, NYC, Toronto, Montreal…)
- **Retailer assortment** research by collection (produce, dairy, frozen, alcohol…)
- **Competitive tracking** vs warehouse clubs and supermarket banners
- **Delivery ETA** snapshots for ops / marketplace analytics
- Feeding BI dashboards, pricing tools, or AI agents with structured Instacart rows

Compared with keyword-only or storefront-only Instacart Actors on the Store, this Actor covers **nearby shops + storefront + collections + discoverCollections + hubs + SEO categories + product enrich + search + ETA** across **US and Canada** in one input surface.

***

### Features

| Capability | What it means for you |
| --- | --- |
| Multi-market coverage | US (`instacart.com`) · CA (`instacart.ca`) · optional `language=fr` |
| City presets | `sf` `nyc` `la` `chicago` `seattle` `austin` `miami` `denver` · `toronto` `vancouver` `montreal` `calgary` `ottawa` |
| Retailer discovery | `nearMe` / `discoverRetailers` nearby shops for a postal code |
| Collections & nav | `collection` pagination + `discoverCollections` (DiscoverNav / known slugs) |
| Hubs & SEO categories | `/store/hub/{slug}` · `/categories/{id}-{slug}` |
| Product detail & batch | `product` · `enrich` · optional `enrichDetails` on listings |
| Search | Store or cross-retailer keyword search |
| ETA | `includeEta` or `mode=eta` when Instacart exposes accurate ETAs |
| Free-tier friendly | 10 runs / 200 results for free Apify plans (developer policy) |
| Standby Live View | Lightweight health + OpenAPI; full scrapes still use normal runs |

**Out of scope:** Instacart+ / member login pricing · add-to-cart · checkout.

***

### Example inputs

#### Nearby grocery shops

```json
{
  "mode": "nearMe",
  "city": "nyc",
  "maxResults": 20,
  "includeEta": true
}
```

#### Costco produce collection (US)

```json
{
  "mode": "collection",
  "country": "us",
  "city": "seattle",
  "retailerSlug": "costco",
  "collectionSlug": "produce",
  "maxResults": 40,
  "maxPages": 3
}
```

#### Discover store collections

```json
{
  "mode": "discoverCollections",
  "city": "chicago",
  "retailerSlug": "costco",
  "maxResults": 30
}
```

#### Keyword search inside a retailer

```json
{
  "mode": "search",
  "city": "austin",
  "retailerSlug": "costco",
  "query": "organic milk",
  "maxResults": 25
}
```

#### Canada collection (Vancouver)

```json
{
  "mode": "collection",
  "city": "vancouver",
  "retailerSlug": "save-on-foods",
  "collectionSlug": "produce",
  "maxResults": 20,
  "maxPages": 2
}
```

***

### More Actors like this

Need grocery, food-delivery, club-retail, or general ecommerce data outside Instacart? Use a **dedicated Actor** below for structured fields. Use this Actor for **Instacart** shops, products, collections, hubs, and search.

#### Similar grocery, retail & food-delivery scrapers

- [DoorDash Scraper](https://apify.com/lentic_clockss/doordash-scraper)
- [Uber Eats Scraper](https://apify.com/lentic_clockss/ubereats-scraper)
- [Deliveroo Scraper](https://apify.com/lentic_clockss/deliveroo-scraper)
- [Wolt Scraper](https://apify.com/lentic_clockss/wolt-scraper)
- [Foodpanda Scraper](https://apify.com/lentic_clockss/foodpanda-scraper)
- [Grab Scraper](https://apify.com/lentic_clockss/grab-scraper)
- [iFood Scraper](https://apify.com/lentic_clockss/ifood-scraper)
- [Costco Product Scraper](https://apify.com/lentic_clockss/costco-scraper)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)

#### Prefer another specialized scraper?

If your target has a specialized Actor below, use that first — usually cheaper and more structured than a generic scrape.

**Jobs & Freelance**

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)

**Real Estate**

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [Apartments.com Rental Scraper](https://apify.com/lentic_clockss/apartments-com-rental-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)

**E-commerce**

- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Costco Product Scraper](https://apify.com/lentic_clockss/costco-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)

**Social & Content**

- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)

**Ads Intelligence**

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

**General Tools**

- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)
- [Phone Number Intelligence](https://apify.com/lentic_clockss/phone-number-intelligence)

→ See the full catalog in [Related Actors](#related-actors) below, or browse [apify.com/lentic\_clockss](https://apify.com/lentic_clockss).

***

### How to scrape Instacart (no code required)

1. Create a free [Apify](https://apify.com/) account
2. Open [Instacart Scraper](https://apify.com/lentic_clockss/instacart-scraper)
3. Choose a **mode** (see table below)
4. Choose a **country** (`us` / `ca`) or a **city** preset
5. Fill retailer / collection / product / query fields for that mode
6. Click **Start** and download the Dataset as JSON, CSV, Excel, or JSONL

Start with `maxResults: 5–15` to verify the query, then scale up.

| Mode | Required inputs |
| --- | --- |
| `nearMe` / `discoverRetailers` | Optional `city` / `postalCode` · optional `includeEta` |
| `storefront` | `retailerSlug` |
| `collection` | `retailerSlug` + `collectionSlug` · optional `maxPages` |
| `discoverCollections` | `retailerSlug` |
| `product` | `productId` or `productUrl` |
| `enrich` | `productIds` / `startUrls` / `productUrl` |
| `search` | `query` · optional `retailerSlug` |
| `hub` | `hubSlug` (e.g. `deals_tab`, `alcohol`) |
| `category` | `categoryId` · optional `categorySlug` |
| `eta` | Optional `city` / `postalCode` |
| `startUrls` | Instacart storefront / collection / hub / category / product / search URLs |

***

### How much does it cost to scrape Instacart?

This Actor uses **pay-per-event** pricing. You are charged for:

| Event | Price |
| --- | --- |
| Actor Start (`apify-actor-start`) | **$0.005** per start |
| Result (`apify-default-dataset-item`) | **$3.00 / 1,000** results (**$0.003** each on FREE/BRONZE) |

**Platform usage costs are included** — you do **not** pay separate Apify compute/proxy usage for this Actor on top of the event prices above (**User pays platform usage costs = No**).

#### Discount tiers (per result)

| Tier | $/1,000 | per result |
| --- | ---: | ---: |
| FREE\* | $3.00 | $0.003 |
| BRONZE | $3.00 | $0.003 |
| SILVER | $2.60 | $0.0026 |
| GOLD | $2.20 | $0.0022 |
| PLATINUM | $2.00 | $0.002 |
| DIAMOND | $1.60 | $0.0016 |

\*Free Apify-plan users are also capped by the developer policy: **10 runs** / **200 results** per run.

#### Example cost estimates

| Results collected | Approx. event cost\* |
| --- | ---: |
| 100 | ~$0.31 |
| 1,000 | ~$3.01 |
| 10,000 | ~$30.01 |

\*Assumes one Actor start at default memory billing for start events, plus `$0.003` per Dataset item. Exact start billing can scale with allocated memory (one start event per GB, minimum one).

***

### Input

See the **Input** tab for the full schema. Common fields: `mode`, `country`, `city`, `postalCode`, `retailerSlug`, `collectionSlug`, `hubSlug`, `categoryId`, `productId` / `productUrl` / `productIds`, `query`, `startUrls`, `enrichDetails`, `enrichLimit`, `includeEta`, `maxPages`, `maxResults`.

***

### Output

Each Dataset item is a shop, product, collection, hub, category, suggestion, or ETA row. Typical product fields: `itemType`, `productId`, `name`, `priceString`, `available`, `url`, `shopId`, `retailerSlug`, `collectionSlug`, `country`, `acquisition`.

Key-value store (no internal backend URLs):

| Key | When |
| --- | --- |
| `INPUT_ECHO` | Always — sanitized input + free-tier / proxy source flags |
| `RUN_SUMMARY` | Success or free-tier limit — counts, mode, warnings |
| `ERROR_SUMMARY` | Failure — safe error type + message |

***

### Tips for better results

- Prefer a **city preset** or accurate **postalCode** — Instacart prices and shops are location-aware
- Start with a known retailer (`costco`, `sprouts`, banner slugs) before broad nearMe crawls
- Use `discoverCollections` to list nav slugs, then run `collection` with `maxPages`
- Set `enrichDetails` sparingly — each PDP costs time/results budget
- Canada: use `city=montreal` + `language=fr` when you need French UI context

***

### FAQ

#### Is this an official Instacart API?

No. It is an unofficial scraper for publicly reachable guest shopping pages.

#### Do you scrape Instacart+ member prices?

No. Member / login pricing and cart/checkout are out of scope.

#### Which countries are supported?

**US** and **Canada** only (Instacart’s public grocery markets for this product surface).

#### Can I schedule recurring price monitors?

Yes — use Apify Schedules or the API with a fixed `postalCode` / `retailerSlug` / `collectionSlug`.

***

### Legal & ethics

Use responsibly and comply with Instacart’s terms and applicable laws. Do not use this Actor for fraud, account takeover, or high-volume abuse. Data is provided as collected from public pages and may change without notice.

### Related Actors

All **77** public Actors from \[[lentic\_clockss](https://apify.com/lentic_clockss)]. Click a name to open the Store detail page.

#### Jobs & Freelance

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Freelancer.com Scraper](https://apify.com/lentic_clockss/freelancer-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Himalayas Jobs Scraper](https://apify.com/lentic_clockss/himalayas-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Jobicy Remote Jobs Scraper](https://apify.com/lentic_clockss/jobicy-remote-jobs-scraper)
- [RemoteOK Jobs Scraper](https://apify.com/lentic_clockss/remoteok-all-jobs-scraper)
- [SEEK Jobs Scraper](https://apify.com/lentic_clockss/seek-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)

#### Real Estate

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [99.co Scraper](https://apify.com/lentic_clockss/ninetynine-co-sg-scraper)
- [Realtor.com Agents Scraper](https://apify.com/lentic_clockss/realtor-com-agents-scraper)
- [Apartments.com Rental Scraper](https://apify.com/lentic_clockss/apartments-com-rental-scraper)
- [Bayut Scraper](https://apify.com/lentic_clockss/bayut-uae-scraper)
- [Craigslist Housing Scraper](https://apify.com/lentic_clockss/craigslist-housing-scraper)
- [Daft.ie Scraper](https://apify.com/lentic_clockss/daft-property-scraper)
- [Dot Property Scraper](https://apify.com/lentic_clockss/dot-property-th-scraper)
- [FINN.no Scraper](https://apify.com/lentic_clockss/finn-scraper)
- [Funda Scraper](https://apify.com/lentic_clockss/funda-scraper)
- [Hepsiemlak Scraper](https://apify.com/lentic_clockss/hepsiemlak-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [Immobiliare.it Scraper](https://apify.com/lentic_clockss/immobiliare-property-scraper)
- [ImmoScout24 Scraper](https://apify.com/lentic_clockss/immobilienscout24-scraper)
- [Naver Land Scraper](https://apify.com/lentic_clockss/naver-land-scraper)
- [OpenSooq Scraper](https://apify.com/lentic_clockss/opensooq-real-estate-scraper)
- [Otodom Scraper](https://apify.com/lentic_clockss/otodom-scraper)
- [Property Finder Scraper](https://apify.com/lentic_clockss/property-finder-uae-scraper)
- [PropertyGuru Scraper](https://apify.com/lentic_clockss/propertyguru-sg-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)
- [Realtor.ca Scraper](https://apify.com/lentic_clockss/realtor-ca-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [SeLoger Scraper](https://apify.com/lentic_clockss/seloger-property-scraper)
- [SUUMO Scraper](https://apify.com/lentic_clockss/suumo-property-scraper)
- [Zillow Group Scraper](https://apify.com/lentic_clockss/zillow-group-scraper)

#### E-commerce

- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [E-commerce Scraper](https://apify.com/lentic_clockss/ecommerce-scraper)
- [1688 Global Product Search Scraper](https://apify.com/lentic_clockss/1688-global-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)
- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [ASOS Product Scraper](https://apify.com/lentic_clockss/asos-scraper)
- [Cdiscount Product Scraper](https://apify.com/lentic_clockss/cdiscount-scraper)
- [Costco Product Scraper](https://apify.com/lentic_clockss/costco-scraper)
- [Coupang Product Scraper](https://apify.com/lentic_clockss/coupang-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [Lazada Scraper](https://apify.com/lentic_clockss/lazada-ph-search-results-collector)
- [MercadoLibre Scraper](https://apify.com/lentic_clockss/mercadolibre-scraper)
- [Mercari Japan Scraper](https://apify.com/lentic_clockss/mercari-scraper)
- [Rakuten Japan Scraper](https://apify.com/lentic_clockss/rakuten-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)

#### Travel & Stays

- [Booking.com & Airbnb Scraper](https://apify.com/lentic_clockss/booking-airbnb-scraper)
- [Agoda Scraper](https://apify.com/lentic_clockss/agoda-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Despegar Scraper](https://apify.com/lentic_clockss/despegar-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [Traveloka Scraper](https://apify.com/lentic_clockss/traveloka-scraper)
- [Travelstart Flights Scraper](https://apify.com/lentic_clockss/travelstart-scraper)
- [Trip.com Scraper](https://apify.com/lentic_clockss/trip-com-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)

#### Social & Content

- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)
- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [Hacker News Scraper](https://apify.com/lentic_clockss/hacker-news-scraper)

#### Ads Intelligence

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [Google Ads Transparency VN](https://apify.com/lentic_clockss/google-ads-transparency-center-vn)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

#### Local & Maps

- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

#### General Tools

- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)
- [Phone Number Intelligence](https://apify.com/lentic_clockss/phone-number-intelligence)

→ Browse the full profile: [apify.com/lentic\_clockss](https://apify.com/lentic_clockss)

# Actor input Schema

## `mode` (type: `string`):

nearMe | discoverRetailers | storefront | collection | discoverCollections | product | enrich | search | hub | category | eta | startUrls

## `country` (type: `string`):

Instacart market us (.com) or ca (.ca)

## `locale` (type: `string`):

Alias of country (us or ca)

## `language` (type: `string`):

Optional UI language (fr / fr-CA for Quebec)

## `city` (type: `string`):

sf, nyc, la, chicago, seattle, austin, miami, denver, toronto, vancouver, montreal, calgary, ottawa

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

Delivery postal code (defaults by country / city if empty)

## `latitude` (type: `number`):

Optional map latitude

## `longitude` (type: `number`):

Optional map longitude

## `retailerSlug` (type: `string`):

e.g. costco, sprouts, walmart

## `collectionSlug` (type: `string`):

e.g. produce — any DiscoverNav / collections slug

## `hubSlug` (type: `string`):

Required for mode=hub — deals\_tab, alcohol, convenience, pharmacy, pet, baby

## `categoryId` (type: `string`):

Required for mode=category — numeric id in /categories/{id}-{slug}

## `categorySlug` (type: `string`):

Optional slug segment for SEO category URL

## `productId` (type: `string`):

Numeric Instacart productId for mode=product / enrich

## `productUrl` (type: `string`):

Full /products/{id}-{slug} URL

## `productIds` (type: `array`):

Batch productIds for mode=enrich

## `shopId` (type: `string`):

Optional; resolved from storefront when omitted

## `zoneId` (type: `string`):

Optional delivery zoneId

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

Required for mode=search

## `startUrls` (type: `array`):

Instacart storefront / collection / hub / category / product / search URLs

## `enrichDetails` (type: `boolean`):

After listing modes, open PDP for up to enrichLimit products

## `enrichLimit` (type: `integer`):

Max products to open for PDP enrichment (0–50)

## `includeEta` (type: `boolean`):

Attach GetAccurateRetailerEtas when available

## `maxPages` (type: `integer`):

CollectionProducts pagination budget

## `maxResults` (type: `integer`):

1–500 (free plan capped at 200)

## `proxyCountry` (type: `string`):

Usually US or CA; worker-owned proxy by default

## `workerBaseUrl` (type: `string`):

Optional HTTPS Cloud Run override (allowlisted hosts only)

## Actor input object example

```json
{
  "mode": "nearMe",
  "country": "us",
  "locale": "us",
  "enrichDetails": false,
  "enrichLimit": 10,
  "includeEta": false,
  "maxPages": 10,
  "maxResults": 50
}
```

# Actor output Schema

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

Normalized DoorDash store / menu / cuisine / sitemap rows from the default dataset.

## `runSummary` (type: `string`):

Structured summary record stored in the default key-value store.

## `inputEcho` (type: `string`):

Sanitized normalized input saved at run start.

## `errorSummary` (type: `string`):

Present when a failed run stores structured terminal error information.

# 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("lentic_clockss/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 = {}

# Run the Actor and wait for it to finish
run = client.actor("lentic_clockss/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 '{}' |
apify call lentic_clockss/instacart-scraper --silent --output-dataset

```

## MCP server setup

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