# iFood Scraper | Brazil Restaurants Menus Reviews (`lentic_clockss/ifood-scraper`) Actor

Scrape iFood Brazil (ifood.com.br): restaurants, mercado, full menus with prices, ratings, delivery fees, and reviews. Search by city, CEP, cuisine, chain, or merchant URL across all 27 UFs. Export CSV/Excel/JSON. Unofficial — not affiliated with iFood.

- **URL**: https://apify.com/lentic\_clockss/ifood-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

## iFood Scraper | Brazil Restaurants, Menus & Reviews

Scrape **[iFood](https://www.ifood.com.br)** — Brazil’s largest food-delivery marketplace — for **restaurants, mercado stores, full menus with prices, ratings, delivery fees, and customer reviews**.

Search by **city slug**, **CEP**, **GPS**, **cuisine**, **chain**, or paste merchant URLs. Export clean tables to **CSV, Excel, JSON, or JSONL**.

Built for price monitoring, lead gen, menu intelligence, and market research across all **27 Brazilian states (UFs)**.

**Unofficial** — not affiliated with iFood.com Agência de Restaurantes Online S.A.

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

***

### Why this iFood scraper?

Store competitors often cover only menu-by-UUID or a single city search. This Actor is built for **full product coverage on iFood Brazil**:

| Capability | What you get |
| --- | --- |
| Geo search | City slug · CEP (ViaCEP) · address · lat/lng · `nearMe` |
| Verticals | Restaurants · **mercado** · farmacia · bebidas · pet · shopping · conveniencia |
| Merchant detail | Name, rating, category, distance, delivery fee, tags, chain |
| Full menus | Catalog items with price, description, category (SKU-aware for mercado) |
| Dish detail | Single item / `prato` deep-link |
| Reviews | Paginated customer evaluations |
| Discovery | `discoverCities` · `discoverCategories` · `discoverVerticals` |
| Enrich | Optional `enrichMenus` / `enrichDetails` (GraphQL delivery + address) |
| Pagination | Cardstack `loadMoreRounds` for larger city lists |

***

### What you can do with it

#### 1. List restaurants in a Brazilian city

**You give:** `mode=city` + `citySlug` (e.g. `sao-paulo-sp`, `rio-de-janeiro-rj`).

**You get:** merchant rows with UUID, name, rating, category, distance, delivery fee, URL.

```json
{
  "mode": "city",
  "citySlug": "sao-paulo-sp",
  "searchTerm": "pizza",
  "maxResults": 20,
  "loadMoreRounds": 2
}
```

#### 2. Filter by cuisine or mercado

```json
{
  "mode": "category",
  "citySlug": "curitiba-pr",
  "categorySlug": "japonesa",
  "maxResults": 25
}
```

```json
{
  "mode": "mercado",
  "citySlug": "porto-alegre-rs",
  "maxResults": 15
}
```

#### 3. Search near a CEP or address

```json
{
  "mode": "nearMe",
  "cep": "01310-100",
  "searchTerm": "hamburguer",
  "maxResults": 15
}
```

#### 4. Pull a full merchant menu

```json
{
  "mode": "menu",
  "merchantUrl": "https://www.ifood.com.br/delivery/sao-paulo-sp/212-burger-pinheiros-pinheiros/d468b0b0-a18f-4ecc-9631-6faf2aa8eeb0",
  "includeMenuItems": true,
  "maxResults": 200
}
```

#### 5. Collect reviews

```json
{
  "mode": "reviews",
  "merchantUrl": "https://www.ifood.com.br/delivery/sao-paulo-sp/212-burger-pinheiros-pinheiros/d468b0b0-a18f-4ecc-9631-6faf2aa8eeb0",
  "loadMoreRounds": 2,
  "maxResults": 50
}
```

#### 6. Discover cities & verticals

```json
{ "mode": "discoverCities", "maxResults": 80 }
```

```json
{ "mode": "discoverVerticals", "maxResults": 20 }
```

#### 7. Chain / brand filter & start URLs

- `mode=chain` + `chainName` (e.g. `Burger King`, `McDonald`)
- `mode=startUrls` + `startUrls[]` for any `ifood.com.br` delivery / search URL
- `mode=home` for the restaurants home feed (geo required)
- `mode=dish` + `itemId` / `dishUuid` for a single dish detail

***

### Features

- **Brazil-wide coverage** — all 27 UFs via `{city}-{uf}` slugs + seed coordinates
- **Cloudflare-aware** — managed stealth browser + BR residential egress (no proxy setup in the Actor)
- **Structured output** — `merchantUuid`, ratings, menu prices, reviews ready for BI
- **Pay per event** — from **$3.00 / 1,000** results (lower on higher Store tiers)
- **Standby Live View** — lightweight health for integrations
- **Free-tier friendly** — 10 runs / 200 results for free Apify plans (developer policy)

***

### More Actors like this

Need food-delivery or travel data **outside iFood Brazil**, or another vertical? Prefer a **dedicated Actor** for structured fields. Use this Actor for **iFood.com.br**.

#### Similar food-delivery, local & travel 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)
- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)
- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [Traveloka Scraper](https://apify.com/lentic_clockss/traveloka-scraper)
- [Despegar Scraper](https://apify.com/lentic_clockss/despegar-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)
- [MercadoLibre Scraper](https://apify.com/lentic_clockss/mercadolibre-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)
- [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 iFood (no code required)

1. Create a free [Apify](https://apify.com/) account
2. Open [iFood Scraper](https://apify.com/lentic_clockss/ifood-scraper)
3. Choose a **mode** (table below)
4. Fill geo (`citySlug`, `cep`, or lat/lng) or a merchant URL
5. 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 |
| --- | --- |
| `city` | `citySlug` (or CEP / lat-lng) |
| `category` | `citySlug` + `categorySlug` or `searchTerm` |
| `mercado` | `citySlug` (or CEP / lat-lng) |
| `chain` | `citySlug` + `chainName` |
| `nearMe` | `cep` / `address` / lat-lng |
| `home` | `citySlug` or CEP / lat-lng |
| `browse` | `pageId` + geo |
| `merchant` / `menu` / `reviews` / `dish` | `merchantUrl` or `merchantUuid` (+ `itemId` for dish) |
| `discoverCities` / `discoverCategories` / `discoverVerticals` | optional `maxResults` |
| `startUrls` | `startUrls[]` |

***

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

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) |

| 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 |

\*Apify Free plan users also have a **developer-enforced** cap: **10 runs** and **200 results** per run on this Actor. Platform usage is paid by the Actor developer (you do **not** pay Apify platform usage on top of PPE for this Actor).

***

### Input example

```json
{
  "mode": "city",
  "citySlug": "belo-horizonte-mg",
  "searchTerm": "pizza",
  "maxResults": 15,
  "loadMoreRounds": 1,
  "includeDishes": false,
  "enrichDetails": false
}
```

***

### Output example

Merchant list row:

```json
{
  "itemType": "merchant",
  "country": "br",
  "citySlug": "sao-paulo-sp",
  "merchantUuid": "848caf9a-5594-467b-b80b-9229df163609",
  "name": "Example Restaurante",
  "evaluationAverage": 4.6,
  "mainCategory": "Pizza",
  "distance": 1.2,
  "deliveryFee": 5.99,
  "url": "https://www.ifood.com.br/delivery/sao-paulo-sp/example/848caf9a-5594-467b-b80b-9229df163609",
  "source": "cardstack.search",
  "scrapedAt": "2026-08-02T12:00:00Z"
}
```

Menu item row (`mode=menu`):

```json
{
  "itemType": "menu_item",
  "merchantUuid": "d468b0b0-a18f-4ecc-9631-6faf2aa8eeb0",
  "productId": "…",
  "name": "Smash Burger",
  "price": 32.9,
  "category": "Burgers",
  "source": "site-api.catalog"
}
```

***

### FAQ

**Is this affiliated with iFood?**\
No. Unofficial community Actor for public marketplace data.

**Why empty results / blocked?**\
iFood uses Cloudflare and PerimeterX. This Actor routes through a managed stealth browser with Brazilian residential egress. Retry, lower `maxResults`, or use a known-good `citySlug` / CEP.

**SEO city pages return 404?**\
Correct — `/delivery/{city}` SEO list pages are often 404 in 2026. This Actor uses **geo cardstack search** with city coordinates instead.

**Mercado / grocery?**\
Use `mode=mercado` or `categorySlug=mercado`. Menu enrich uses SKU-oriented item typing.

**Do I need to configure proxies?**\
No. Egress is owned by the scrape backend (`WORKER_PROVIDES_PROXY`). Optional `proxyCountry` defaults to `br`.

**Free plan limits?**\
Set by the Actor developer (not Apify Console): **10 runs** and **200 results** per run. Paying Apify users are not capped by that run quota (schema `maxResults` still applies).

***

### Tips for best results

1. Prefer `citySlug` values from `discoverCities` (format `{city}-{uf}`).
2. Use CEP (`01310-100`) when you care about a neighborhood delivery radius.
3. Enable `enrichMenus` / `enrichDetails` only when you need full menus or GraphQL delivery fields from list runs (slower / costlier).
4. Keep first runs at `maxResults: 5–15` to check data quality before scaling.
5. For chain monitoring, use `mode=chain` + exact brand spelling.

***

### Technical notes

| Setting | Value |
| --- | --- |
| Default memory | **1024 MB** |
| Timeout default | **3600 s** |
| Standby | Enabled (lightweight Live View) |
| Country | **Brazil (`br`) only** |
| Free plan caps | **10 runs** / **200 results** per run |

**Keywords:** iFood scraper, iFood API, iFood Brazil scraper, iFood restaurant scraper, iFood menu scraper, iFood reviews, iFood mercado, cardápio iFood, raspagem iFood, food delivery Brazil, São Paulo restaurants, CEP delivery search, pay per event

***

### 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`):

city | category | mercado | chain | nearMe | home | browse | merchant | menu | dish | reviews | discoverCities | discoverCategories | discoverVerticals | startUrls

## `citySlug` (type: `string`):

SEO city slug with UF, e.g. sao-paulo-sp, rio-de-janeiro-rj

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

Category term for category mode (pizza, mercado, japonesa, …)

## `searchTerm` (type: `string`):

Override search term for cardstack modes

## `chainName` (type: `string`):

Brand/chain filter (chain mode) or soft name match

## `pageId` (type: `string`):

Cardstack pageId for browse mode

## `merchantUrl` (type: `string`):

Full merchant URL: /delivery/{city}/{slug}/{uuid}

## `merchantUuid` (type: `string`):

Merchant UUID

## `merchantSlug` (type: `string`):

Merchant slug

## `dishUuid` (type: `string`):

Dish UUID (prato query)

## `itemId` (type: `string`):

Catalog item id for dish mode

## `cep` (type: `string`):

Brazilian postal code → ViaCEP city + seed coords

## `address` (type: `string`):

Free-text address geocoded via Nominatim

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

Optional delivery latitude (defaults from citySlug seed map)

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

Optional delivery longitude (defaults from citySlug seed map)

## `includeMenuItems` (type: `boolean`):

Include menu items

## `includeReviews` (type: `boolean`):

Include reviews

## `includeDishes` (type: `boolean`):

Extract CATALOG\_ITEM cards from cardstack

## `enrichMenus` (type: `boolean`):

Enrich menus from list

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

Fetch delivery fee / address / chain via GraphQL

## `maxEnrich` (type: `integer`):

Max merchants to enrich

## `loadMoreRounds` (type: `integer`):

Additional search pages beyond the first

## `reviewPage` (type: `integer`):

Reviews start page

## `reviewPageSize` (type: `integer`):

Reviews page size

## `sortBy` (type: `string`):

Optional cardstack sort parameter

## `mainCategoryFilter` (type: `string`):

Keep merchants whose mainCategory contains this text

## `includeVerticals` (type: `array`):

Filter merchants by vertical keywords (mercado, farmacia, …)

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

Free Apify plan users are capped at 200 results/run (Actor developer limit).

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

ifood.com.br URLs for startUrls mode

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

Hint for worker egress (default br)

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

Optional HTTPS allowlisted Cloud Run URL override

## Actor input object example

```json
{
  "mode": "city",
  "includeMenuItems": true,
  "includeReviews": true,
  "includeDishes": false,
  "enrichMenus": false,
  "enrichDetails": false,
  "maxEnrich": 5,
  "loadMoreRounds": 3,
  "reviewPage": 1,
  "reviewPageSize": 30,
  "maxResults": 50,
  "proxyCountry": "br"
}
```

# Actor output Schema

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

Normalized iFood 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/ifood-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/ifood-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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/ifood-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=lentic_clockss/ifood-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/smMJXiLAFYuwGK3Ph/builds/QAouASo069lbNpf4e/openapi.json