# iFood Restaurant & Menu Scraper - Brazil (`analytics_tupiniquim/ifood-restaurant-scraper`) Actor Extract restaurants, full menus, prices, ratings, delivery fees and categories from iFood Brazil. Search by city, coordinates, category or store ID. - **URL**: https://apify.com/analytics\_tupiniquim/ifood-restaurant-scraper.md - **Developed by:** [Guilherme Teixeira](https://apify.com/analytics_tupiniquim) (community) - **Categories:** E-commerce, Lead generation - **Stats:** 2 total users, 1 monthly users, 85.7% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 restaurant scrapeds 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 Restaurant & Menu Scraper - Brazil 🇧🇷 Extract **restaurants, full menus, prices, ratings, delivery fees and categories** from **iFood** — Brazil's largest food‑delivery platform. Search by city, GPS coordinates, category, or a specific restaurant URL, and export clean, flat data to **CSV, Excel, JSON or Google Sheets**. Perfect for **market research, lead generation, price monitoring, and delivery analytics**. ### What this Actor does - 🏪 **List restaurants** near any Brazilian city or coordinate - 📋 **Scrape full menus** — categories, item names, descriptions, prices and images - ⭐ **Collect ratings**, price range, delivery fee, ETA and distance - 🏷️ **Filter by category** (Pizza, Japonesa, Açaí, Lanches, …) - 📤 **Clean flat output**, ready for spreadsheets and BI tools ### How to use 1. Click **Try for free** / **Start**. 2. Choose a **mode**: - **Stores** — list restaurants for the cities or coordinates you provide. - **Store info** — details for specific restaurant URLs or IDs. - **Menu** — the full menu of specific restaurants. 3. Fill in cities (or coordinates / restaurant URLs). 4. (Recommended) Keep **Brazilian residential proxy** enabled — iFood uses anti‑bot protection. 5. Run and export the results. ### Example input ```json { "mode": "stores", "cities": ["São Paulo", "Campinas"], "category": "Pizza", "maxRestaurants": 100, "includeMenu": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "BR" } } ```` Scrape the full menu of one restaurant: ```json { "mode": "menu", "startUrls": [ "https://www.ifood.com.br/delivery/franca-sp/perola-panificadora-ii/acd7840c-3988-4368-bb0d-875e07005ed2" ] } ``` ### Example output Restaurant (stores / store\_info mode): ```json { "storeId": "acd7840c-3988-4368-bb0d-875e07005ed2", "name": "Perola Panificadora II", "mainCategory": "Padaria", "userRating": 4.7, "priceRange": "CHEAPEST", "deliveryFee": 5.99, "deliveryTimeMinMinutes": 30, "deliveryTimeMaxMinutes": 40, "distanceKm": 1.2, "available": true, "city": "Franca", "currency": "BRL" } ``` Menu item (menu mode): ```json { "storeId": "acd7840c-3988-4368-bb0d-875e07005ed2", "storeName": "Perola Panificadora II", "category": "Kit Festa", "itemName": "Kit Festa Aniversário", "itemDescription": "Serve 20 pessoas", "price": 109.99, "available": true, "imageUrl": "https://static.ifood-static.com.br/image/upload/..." } ``` ### Output fields | Field | Description | |-------|-------------| | `storeId` | Unique iFood restaurant UUID | | `name` | Restaurant name | | `mainCategory` | Primary segment (Pizza, Japonesa, …) | | `userRating` | Average rating | | `priceRange` | Relative price band | | `deliveryFee` | Delivery fee in BRL | | `deliveryTimeMinMinutes` / `deliveryTimeMaxMinutes` | Estimated delivery window | | `distanceKm` | Distance from the search point | | `available` | Whether the store is currently open | | `itemName`, `itemDescription`, `price`, `imageUrl` | Menu item fields (menu mode) | ### Pricing This Actor uses **pay‑per‑result** style events: - **Store scraped** — per restaurant returned - **Menu scraped** — per restaurant menu returned You only pay for the data you actually get. ### FAQ **Is scraping iFood legal?** This tool collects publicly available information. You are responsible for complying with iFood's Terms and applicable laws (LGPD/GDPR). Do not collect personal data. **Why do I need a proxy?** iFood uses PerimeterX anti‑bot protection. Brazilian residential proxies are strongly recommended for reliable results. **Can I scrape a whole city?** Yes — use `stores` mode with a city. Increase `maxRestaurants` to collect more. **Can I get menus in bulk?** Use `stores` mode with `includeMenu: true`, or `menu` mode with a list of restaurant URLs. **What format can I export?** CSV, Excel, JSON, XML, and Google Sheets via the Apify platform. ### Disclaimer This Actor is not affiliated with, endorsed by, or connected to iFood. It extracts publicly accessible data for legitimate research and analytics purposes. Use responsibly and in accordance with all applicable laws and the platform's Terms of Service. # Actor input Schema ## `mode` (type: `string`): What to extract. 'stores' lists restaurants for a location; 'store\_info' gets details for specific restaurants; 'menu' gets the full menu for specific restaurants. ## `cities` (type: `array`): Cities to search restaurants in. Used in 'stores' mode. Pick from the built-in list of major Brazilian cities. ## `coordinates` (type: `array`): Alternative to cities: exact points to search around. Each item is an object like {"lat": -23.5505, "lng": -46.6333}. Used in 'stores' mode. ## `startUrls` (type: `array`): iFood restaurant page URLs (e.g. https://www.ifood.com.br/delivery/cidade-uf/slug/UUID). Used in 'store\_info' and 'menu' modes. ## `storeIds` (type: `array`): iFood restaurant UUIDs, alternative to Restaurant URLs. Used in 'store\_info' and 'menu' modes. ## `category` (type: `string`): Optional. Only keep restaurants whose main category matches this text (e.g. 'Pizza', 'Japonesa', 'Açaí'). Applied in 'stores' mode. ## `maxRestaurants` (type: `integer`): Limit of restaurants collected per city/coordinate in 'stores' mode. ## `includeMenu` (type: `boolean`): When enabled in 'stores' mode, each restaurant found will also have its full menu scraped. Increases run time and cost. ## `proxyConfiguration` (type: `object`): iFood uses anti-bot protection (PerimeterX). Brazilian residential proxies are strongly recommended for reliable results. ## Actor input object example ```json { "mode": "stores", "cities": [ "São Paulo" ], "coordinates": [], "startUrls": [], "storeIds": [], "maxRestaurants": 100, "includeMenu": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "BR" } } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "coordinates": [], "startUrls": [], "storeIds": [], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "BR" } }; // Run the Actor and wait for it to finish const run = await client.actor("analytics_tupiniquim/ifood-restaurant-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "coordinates": [], "startUrls": [], "storeIds": [], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "BR", }, } # Run the Actor and wait for it to finish run = client.actor("analytics_tupiniquim/ifood-restaurant-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 '{ "coordinates": [], "startUrls": [], "storeIds": [], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "BR" } }' | apify call analytics_tupiniquim/ifood-restaurant-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=analytics_tupiniquim/ifood-restaurant-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "iFood Restaurant & Menu Scraper - Brazil", "description": "Extract restaurants, full menus, prices, ratings, delivery fees and categories from iFood Brazil. Search by city, coordinates, category or store ID.", "version": "1.0", "x-build-id": "6FnsdeeH6LwXa68Lp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/analytics_tupiniquim~ifood-restaurant-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-analytics_tupiniquim-ifood-restaurant-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/analytics_tupiniquim~ifood-restaurant-scraper/runs": { "post": { "operationId": "runs-sync-analytics_tupiniquim-ifood-restaurant-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/analytics_tupiniquim~ifood-restaurant-scraper/run-sync": { "post": { "operationId": "run-sync-analytics_tupiniquim-ifood-restaurant-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "Scraping mode", "enum": [ "stores", "store_info", "menu" ], "type": "string", "description": "What to extract. 'stores' lists restaurants for a location; 'store_info' gets details for specific restaurants; 'menu' gets the full menu for specific restaurants.", "default": "stores" }, "cities": { "title": "Cities (Brazil)", "type": "array", "description": "Cities to search restaurants in. Used in 'stores' mode. Pick from the built-in list of major Brazilian cities.", "items": { "type": "string", "enum": [ "São Paulo", "Rio de Janeiro", "Brasília", "Salvador", "Fortaleza", "Belo Horizonte", "Manaus", "Curitiba", "Recife", "Goiânia", "Belém", "Porto Alegre", "São Luís", "Maceió", "Campo Grande", "Natal", "Teresina", "João Pessoa", "Aracaju", "Cuiabá", "Florianópolis", "Vitória", "Porto Velho", "Macapá", "Rio Branco", "Boa Vista", "Palmas", "Guarulhos", "Campinas", "São Gonçalo", "Duque de Caxias", "Nova Iguaçu", "Niterói", "São Bernardo do Campo", "Santo André", "Osasco", "Sorocaba", "Ribeirão Preto", "São José dos Campos", "Santos", "Jundiaí", "Piracicaba", "Bauru", "São José do Rio Preto", "Franca", "Uberlândia", "Contagem", "Juiz de Fora", "Betim", "Montes Claros", "Londrina", "Maringá", "Cascavel", "Joinville", "Blumenau", "Caxias do Sul", "Pelotas", "Canoas", "Feira de Santana", "Jaboatão dos Guararapes", "Caruaru", "Petrolina", "Aparecida de Goiânia", "Anápolis", "Ananindeua", "Vila Velha", "Serra" ] }, "default": [ "São Paulo" ] }, "coordinates": { "title": "Custom coordinates", "type": "array", "description": "Alternative to cities: exact points to search around. Each item is an object like {\"lat\": -23.5505, \"lng\": -46.6333}. Used in 'stores' mode." }, "startUrls": { "title": "Restaurant URLs", "type": "array", "description": "iFood restaurant page URLs (e.g. https://www.ifood.com.br/delivery/cidade-uf/slug/UUID). Used in 'store_info' and 'menu' modes.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "storeIds": { "title": "Store IDs (UUID)", "type": "array", "description": "iFood restaurant UUIDs, alternative to Restaurant URLs. Used in 'store_info' and 'menu' modes.", "items": { "type": "string" } }, "category": { "title": "Category filter", "type": "string", "description": "Optional. Only keep restaurants whose main category matches this text (e.g. 'Pizza', 'Japonesa', 'Açaí'). Applied in 'stores' mode." }, "maxRestaurants": { "title": "Max restaurants per location", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Limit of restaurants collected per city/coordinate in 'stores' mode.", "default": 100 }, "includeMenu": { "title": "Also scrape full menu (stores mode)", "type": "boolean", "description": "When enabled in 'stores' mode, each restaurant found will also have its full menu scraped. Increases run time and cost.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "iFood uses anti-bot protection (PerimeterX). Brazilian residential proxies are strongly recommended for reliable results." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```