# Ifood Supermarket Scraper (`yasmany.casanova/ifood-supermarket-scraper`) Actor Extract supermarket data from iFood Brazil: store listings by location, detailed store information, and full product catalogs with prices, EAN codes, packaging, and unit information. Ideal for price intelligence, market research, and e-commerce data. - **URL**: https://apify.com/yasmany.casanova/ifood-supermarket-scraper.md - **Developed by:** [Yasmany Grijalba Casanova](https://apify.com/yasmany.casanova) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $35.00 / 1,000 results 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 Supermarket Scraper Extract comprehensive supermarket data from **iFood** — the largest food delivery and grocery platform in Latin America. Get store listings, detailed profiles, category trees, and full product catalogs with prices, EAN codes, packaging and units. [![Apify Actor](https://img.shields.io/badge/Apify-Actor-blue?logo=apify)](https://apify.com) [![Residential Proxy](https://img.shields.io/badge/Proxy-Residential-orange)](https://apify.com/proxy) [![Brazil](https://img.shields.io/badge/Region-Brazil-green)](https://www.ifood.com.br) --- > ℹ️ **Residential Proxy Required** > This Actor requires a residential proxy for reliable data extraction. You have two options: > > 1. **Apify Residential Proxy** — available on Apify paid plans. See [apify.com/pricing](https://apify.com/pricing). > 2. **Your own residential proxy** — provide it via the `customProxyUrl` input field (works on any Apify plan, including Free). > > Runs without a residential proxy will stop immediately with a clear message, so you are not charged for unnecessary compute time. --- ### Table of Contents - [Quick Start](#quick-start) - [Features](#features) - [Use Cases](#use-cases) - [How It Works](#how-it-works) - [Input Parameters](#input-parameters) - [Operation Modes](#operation-modes) - [Output Examples](#output-examples) - [Data Fields](#data-fields) - [Integrations](#integrations) - [How to Get Coordinates](#how-to-get-coordinates) - [Important Notes](#important-notes) - [FAQ](#faq) - [Support](#support) --- ### Quick Start Get started in four simple steps: #### Step 1: Find supermarkets in São Paulo ```json { "mode": "stores", "latitude": "-23.6051", "longitude": "-46.6367" } ```` #### Step 2: Get supermarket details ```json { "mode": "store_info", "latitude": "-23.6051", "longitude": "-46.6367", "store_id": "ee4559e2-6c68-429c-9dad-89796c13315e" } ``` #### Step 3: List the store's categories ```json { "mode": "categories", "latitude": "-23.6051", "longitude": "-46.6367", "store_id": "ee4559e2-6c68-429c-9dad-89796c13315e" } ``` #### Step 4: Extract the product catalog for ONE category ```json { "mode": "assortments", "latitude": "-23.6051", "longitude": "-46.6367", "store_id": "ee4559e2-6c68-429c-9dad-89796c13315e", "category_id": "85ddf3de-93ab-4542-bfb4-a31f14061d0f" } ``` > **Tip**: To cover a full catalog, list categories first then dispatch one `assortments` run per `category_id` — runs can be parallelized for speed. *** ### Features | Feature | Description | |---------|-------------| | **100+ Supermarkets per Request** | Cursor-paginated listing — typical locations return 100–200 stores | | **Complete Store Profiles** | Address, delivery info, rating, price range, minimum order | | **Full Product Catalogs** | Every SKU with price, EAN-13 barcode, packaging, unit | | **Discount Detection** | Original price + discount percent when items are on sale | | **Category Discovery** | Full department/aisle tree (UUIDs ready for `assortments`) | | **Incremental Dataset Writes** | Products are saved as they are scraped — partial results survive crashes | | **Structured JSON Output** | Clean, schema-validated data ready for analysis | *** ### Use Cases
Price Intelligence Match products by **EAN-13 barcode** across supermarkets to track price differences, promotions, and competitive positioning in real time.
Market Research Map supermarket density, delivery coverage, and category assortment across Brazilian cities and neighborhoods.
Competitor Analysis Compare stores by pricing, promotion depth, SKU breadth, and delivery terms to gain competitive insights.
Demand Planning Track which brands and SKUs are listed, how they are packaged (unit size, multiplier), and at what price tier to inform procurement.
E-Commerce Enrichment Enrich your product catalog with real iFood pricing, availability, and imagery — tie it to your own SKUs via the `ean` field.
Location Analysis Understand supermarket footprint and product availability by geographic area — delivery time, fee, and distance per store.
*** ### How It Works ``` +------------------+ +------------------+ +------------------+ +------------------+ | STEP 1 | | STEP 2 | | STEP 3 | | STEP 4 | | Stores |--->| Store Info |--->| Categories |--->| Assortments | | (location) | | (profile) | | (tree) | | (one category) | +------------------+ +------------------+ +------------------+ +------------------+ | | | | v v v v 100-200 Complete store Department All SKUs with supermarkets profile + address UUIDs EAN, price, unit ``` #### Step 1: Find Supermarkets List supermarkets delivering to any Brazilian coordinates: ```json { "mode": "stores", "latitude": "-23.6051", "longitude": "-46.6367" } ``` **Returns**: A cursor-paginated list (20 stores per page) with `store_id`, name, rating, delivery fee, delivery time, and distance. #### Step 2: Get Supermarket Details Pick a `store_id` from Step 1 and fetch its full profile: ```json { "mode": "store_info", "latitude": "-23.6051", "longitude": "-46.6367", "store_id": "ee4559e2-6c68-429c-9dad-89796c13315e" } ``` **Returns**: Full address (street, city, district, state, ZIP), delivery fee in BRL, price range, minimum order, rating, and more. #### Step 3: List Categories Discover the store's departments. Each category has a UUID used in Step 4: ```json { "mode": "categories", "latitude": "-23.6051", "longitude": "-46.6367", "store_id": "ee4559e2-6c68-429c-9dad-89796c13315e" } ``` **Returns**: Array of `{code, name}` pairs — e.g. `Bebidas`, `Mercearia`, `Limpeza`, `Higiene`. #### Step 4: Extract a Category's Products Extract every SKU of **one** category (paginated, 50 items per page): ```json { "mode": "assortments", "latitude": "-23.6051", "longitude": "-46.6367", "store_id": "ee4559e2-6c68-429c-9dad-89796c13315e", "category_id": "85ddf3de-93ab-4542-bfb4-a31f14061d0f" } ``` **Returns**: Products with `ean`, `price`, `price_original`, `discount_percent`, `packaging`, `unit`, `quantity`, image URL. > **Pro tip**: Run multiple `assortments` jobs in parallel (one per `category_id`) to extract a full catalog faster. *** ### Input Parameters #### Required Parameters | Parameter | Type | Description | |-----------|------|-------------| | `mode` | string | Operation mode: `stores`, `store_info`, `categories`, or `assortments` | | `latitude` | string | Location latitude (e.g., "-23.6051") | | `longitude` | string | Location longitude (e.g., "-46.6367") | #### Mode-Specific Parameters | Parameter | Type | Required For | Description | |-----------|------|--------------|-------------| | `store_id` | string | `store_info`, `categories`, `assortments` | Supermarket UUID from `stores` mode | | `category_id` | string | `assortments` | Category UUID from `categories` mode | #### Optional Parameters | Parameter | Default | Description | |-----------|---------|-------------| | `maxPages` | `200` | Safety cap on paginated requests (stores: 20/page, assortments: 50/page) | | `pageDelay` | `1` | Seconds between paginated requests to avoid rate limits | | `maxRetries` | `3` | Retry attempts for failed requests | | `timeout` | `30` | Request timeout in seconds | #### Proxy Configuration > **⚠️ Proxy Required** — This Actor requires **Apify Residential Proxy** to work. Make sure your Apify plan includes Residential Proxy access. Proxy usage is billed separately to your Apify account. | Parameter | Default | Description | |-----------|---------|-------------| | `useApifyProxy` | `true` | Enable Apify Proxy (required) | | `proxyGroups` | `["RESIDENTIAL"]` | Proxy group — RESIDENTIAL is required | | `proxyCountry` | `BR` | Proxy country code (BR recommended) | | `customProxyUrl` | — | Your own residential proxy URL (overrides Apify Proxy) | *** ### Operation Modes | Mode | Description | Required Parameters | Output | |------|-------------|---------------------|--------| | `stores` | List supermarkets by location | `latitude`, `longitude` | 100–200 stores per location | | `store_info` | Get supermarket details | `latitude`, `longitude`, `store_id` | Complete store profile | | `categories` | List a store's departments | `latitude`, `longitude`, `store_id` | Array of `{code, name}` pairs | | `assortments` | Extract products of ONE category | `latitude`, `longitude`, `store_id`, `category_id` | Full paginated SKU list | *** ### Output Examples #### Stores Mode ```json { "mode": "stores", "data": [ { "name": "CARREFOUR HIPER - IMIGRANTES", "segment": "MERCADO", "store_id": "ee4559e2-6c68-429c-9dad-89796c13315e", "store_slug": "carrefour-hiper---imigrantes-bosque-da-saude", "available": "S", "distance": 1.8, "user_rating": 4.8, "fee": 1149, "time_min_minutes": 90, "time_max_minutes": 128, "is_ifood_delivery": true, "alias": "SUPERMARKETS" } ], "metadata": { "items_count": 163, "scraped_at": "2026-04-23T13:00:47.261914+00:00" } } ``` #### Store Info Mode ```json { "mode": "store_info", "data": { "store_id": "ee4559e2-6c68-429c-9dad-89796c13315e", "name": "Carrefour Hiper - Imigrantes", "main_category": "Mercado", "store_type": "MARKET", "city": "SAO PAULO", "state": "SP", "district": "Bosque da Saúde", "street_name": "Av Ribeiro Lacerda", "street_number": "940", "zip_code": "04150900", "price_range": "CHEAPEST", "delivery_fee": 11.49, "type_delivery_fee": "FIXED", "delivery_time": 128, "minimum_order_value": 60, "user_rating": 4.8, "user_rating_count": 3629 } } ``` #### Categories Mode ```json { "mode": "categories", "data": { "store_id": "ee4559e2-6c68-429c-9dad-89796c13315e", "total_categories": 28, "categories": [ {"code": "85ddf3de-93ab-4542-bfb4-a31f14061d0f", "name": "Bebidas"}, {"code": "1582c639-44ac-4899-a924-ddc9b3e15409", "name": "Alimentos Básicos"}, {"code": "0e573da8-043d-4ddb-93c9-9ebd88e1454b", "name": "Limpeza"}, {"code": "c8a59ef6-7847-4dd0-bd7f-20db9d046421", "name": "Farmácia"}, {"code": "9374c988-39f3-498c-85de-69f836cec349", "name": "Frios e Laticínios"} ] } } ``` #### Assortments Mode Each product is pushed to the dataset as its own record (incremental), followed by a single summary record at the end. **Product record:** ```json { "mode": "assortments", "item": { "id": "09c8158e-c8fb-4e86-8df8-e7397db3ac09", "description": "Amaciante Concentrado Ypê Essencial 1 Litro", "ean": "7896098901847", "price": 24.79, "price_original": null, "has_discount": false, "discount_percent": null, "availability": "AVAILABLE", "enabled": true, "unit": null, "packaging": null, "quantity": null, "category_id": "0e573da8-043d-4ddb-93c9-9ebd88e1454b", "category_name": "Limpeza", "store_id": "ee4559e2-6c68-429c-9dad-89796c13315e", "logo_url": "https://static-images.ifood.com.br/image/upload/..." } } ``` **Summary record (at end of run):** ```json { "mode": "assortments", "kind": "summary", "data": { "store_id": "ee4559e2-6c68-429c-9dad-89796c13315e", "category_id": "0e573da8-043d-4ddb-93c9-9ebd88e1454b", "category_name": "Limpeza", "total_items": 100, "pagination_total_items": 100, "pages_fetched": 2, "pages_failed": 0 } } ``` *** ### Data Fields #### Stores Mode | Field | Type | Description | |-------|------|-------------| | `name` | string | Supermarket name (uppercased) | | `segment` | string | Category (usually "MERCADO") | | `store_id` | string | Unique supermarket identifier (UUID) | | `store_slug` | string | URL slug derived from the store name | | `available` | string | `"S"` = delivering now, `"N"` = closed/out of range | | `distance` | number | Distance from the input coordinates (km) | | `user_rating` | number | Average rating (0–5 stars) | | `fee` | number | Delivery fee **in cents** (1149 = R$11.49) | | `time_min_minutes` | number | Minimum delivery time (minutes) | | `time_max_minutes` | number | Maximum delivery time (minutes) | | `is_ifood_delivery` | boolean | iFood delivery vs. store delivery | | `delivery_mode` | string | `"DEFAULT"`, `"SCHEDULE"`, `"PICKUP"` | | `image_url` | string | Store logo URL (absolute, fetchable) | | `alias` | string | Always `"SUPERMARKETS"` | #### Store Info Mode | Field | Type | Description | |-------|------|-------------| | `store_id` | string | Supermarket UUID | | `name` | string | Store display name | | `main_category` | string | Friendly category name (e.g. "Mercado") | | `store_type` | string | Merchant type code (e.g. "MARKET") | | `city`, `state`, `district` | string | Location components | | `street_name`, `street_number` | string | Physical address | | `zip_code` | string | Brazilian CEP (no dash) | | `latitude`, `longitude` | string | Store's own coordinates | | `price_range` | string | `"CHEAPEST"`, `"CHEAP"`, `"MODERATE"`, `"EXPENSIVE"` | | `delivery_fee` | number | Delivery fee in BRL | | `type_delivery_fee` | string | `"FIXED"`, `"FREE"`, `"DISTANCE"` | | `delivery_time` | number | Expected delivery time (minutes) | | `minimum_order_value` | number | Minimum order amount (BRL) | | `user_rating` | number | Average rating (0–5) | | `user_rating_count` | number | Total reviews | | `available` | boolean | Currently accepting orders | #### Categories Mode | Field | Type | Description | |-------|------|-------------| | `code` | string | Category UUID — **use as `category_id` in assortments mode** | | `name` | string | Human-readable category name (e.g. "Bebidas") | #### Assortments Mode (per product) | Field | Type | Description | |-------|------|-------------| | `id` | string | iFood's internal product UUID | | `description` | string | Product name | | `ean` | string | EAN-13 barcode — key for price-matching | | `price` | number | Current price in BRL | | `price_original` | number | null | Pre-discount price (null if no promo) | | `has_discount` | boolean | `true` when on promotion | | `discount_percent` | number | null | Percent off (0–100) | | `availability` | string | `"AVAILABLE"`, `"UNAVAILABLE"`, `"OUT_OF_STOCK"` | | `enabled` | boolean | Store-side enabled flag | | `unit` | string | null | `"ML"`, `"KG"`, `"UN"`, etc. | | `packaging` | string | null | `"PACOTE"`, `"GARRAFA"`, `"LATA"`, etc. | | `quantity` | number | null | Pack size (e.g. 500 for 500ml) | | `minimum_quantity` | number | Minimum order quantity | | `incremental_quantity` | number | Step increment | | `available_units` | string | Comma-separated unit types (`"UNIT,KG"`) | | `category_id`, `category_name` | string | Parent category | | `store_id` | string | Parent store UUID | | `logo_url` | string | null | Product image URL | | `external_code` | string | null | Merchant's internal SKU reference | | `product_tags` | array | null | Taxonomy tags (e.g. alcohol restriction) | > For the **complete field-by-field reference** — every field, type, nullability, and real example — see [OUTPUT\_SCHEMA.md](../../OUTPUT_SCHEMA.md) at the repo root. *** ### Integrations Use the **API** tab on the Actor page to get ready-to-use code examples in **Python**, **JavaScript**, and **cURL**. The examples are auto-generated with the correct parameters for immediate integration. The dataset ships with pre-configured views for the Apify Console: | View | Shows | Fields | |------|-------|--------| | **Overview** | All records | mode, items\_count, scraped\_at, proxy\_used | | **Supermarkets** | `stores` mode | name, id, segment, rating, distance, fee, availability | | **Store Details** | `store_info` mode | name, category, location, delivery fee, rating | | **Categories** | `categories` mode | code, name | | **Products** | `assortments` mode | description, EAN, price, discount %, unit, packaging, category | Each view exports to CSV, JSON, XML, or Excel directly from the console. *** ### How to Get Coordinates #### Option 1: Google Maps 1. Open [Google Maps](https://maps.google.com) 2. Right-click on any location in Brazil 3. Click the coordinates shown to copy them 4. Use the first number as `latitude` and the second as `longitude` #### Option 2: Use Common City Coordinates | City | Latitude | Longitude | |------|----------|-----------| | São Paulo (Centro) | -23.5608786 | -46.6570743 | | Rio de Janeiro | -22.9068467 | -43.1728965 | | Belo Horizonte | -19.9166813 | -43.9344931 | | Brasília | -15.7942287 | -47.8821658 | | Curitiba | -25.4289541 | -49.2671340 | | Salvador | -12.9714 | -38.5124 | | Fortaleza | -3.7172 | -38.5433 | | Recife | -8.0476 | -34.8770 | | Porto Alegre | -30.0346 | -51.2177 | | Manaus | -3.1190 | -60.0217 | *** ### Important Notes | Topic | Details | |-------|---------| | **Region** | Brazil only — iFood operates exclusively in Brazil | | **Proxy** | **Required** — Apify Residential Proxy (or a custom residential proxy via `customProxyUrl`) | | **Store ID** | Use UUIDs from `stores` mode — not store names or URLs | | **Category ID** | Use UUIDs from `categories` mode — these are **per-store** | | **One Category Per Run** | `assortments` extracts one category at a time — parallelize runs for a full catalog | | **Incremental Writes** | Each product is pushed to the dataset as soon as it is processed | | **Coordinates** | Required for all modes — must be Brazilian | *** ### FAQ
Why am I getting no results? - Make sure **Residential Proxy** is enabled (`useApifyProxy: true`, `proxyGroups: ["RESIDENTIAL"]`) or a `customProxyUrl` is set - Verify your coordinates are within Brazil - Check that the location has iFood supermarket coverage (not all neighborhoods do) - Try coordinates from a major city (São Paulo, Rio de Janeiro)
Why does my assortments run return 0 products? - The coordinates are likely **outside the store's delivery radius** — try coordinates closer to the store's physical address - The `category_id` must come from a `categories` run **for the same store** — category UUIDs are not shared across stores - The category may genuinely be empty in that store
Why is my store_id invalid? - Store IDs are UUIDs in the format: `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` - Use the exact ID from `stores` mode output - Do not include the store name or URL
Why is store_info returning HTTP 500? iFood returns 500 when the input coordinates are outside the store's delivery radius. Use coordinates close to the store's physical address (from a previous `stores` run).
How do I extract a full catalog? 1. Run `categories` once to list every department (≈20–30 categories per store) 2. For each returned `code`, dispatch one `assortments` run with that `category_id` 3. Runs can execute in parallel — products are written incrementally so partial results are safe
What is the EAN field used for? `ean` is the EAN-13 barcode — the universal product identifier. Use it to join iFood products with your own SKU database or match the same product across different supermarkets for price comparison.
Why are unit and packaging sometimes null? iFood exposes these as structured fields but many merchants leave them empty, keeping packaging info in the free-text `details` field instead. Always code defensively — fall back to `details` / `additional_info` when the structured fields are null.
How often is the data updated? Data is extracted live from iFood on each run — prices, availability, and promotions reflect the state at execution time.
Can I scrape supermarkets outside Brazil? No. iFood operates exclusively in Brazil and this actor is configured for the Brazilian market.
*** ### Support Having issues? Here is how to get help: 1. **Check the FAQ** above for common solutions 2. **Review your input** parameters to ensure they match the required format 3. **Test with the default São Paulo coordinates** to verify the actor is working 4. **Contact support** through [Apify](https://apify.com) for additional assistance # Actor input Schema ## `mode` (type: `string`): Type of data to extract. Typical workflow: stores → categories → assortments (one run per category). Run store\_info to validate a store before extracting its catalog. ## `latitude` (type: `string`): Location latitude in Brazil. Use Google Maps to find coordinates: right-click any location and copy the first number. ## `longitude` (type: `string`): Location longitude in Brazil. Use Google Maps to find coordinates: right-click any location and copy the second number. ## `store_id` (type: `string`): Supermarket UUID. Required for store\_info, categories, and assortments modes. Get this ID from stores mode first. ## `category_id` (type: `string`): REQUIRED for assortments mode. A category UUID returned by 'categories' mode. Each run extracts ONE category — dispatch parallel runs to cover the full catalog. ## `maxPages` (type: `integer`): Safety cap on pages fetched in paginated modes. In 'assortments' each page has 50 products (default 200 = up to 10,000). In 'stores' each page has 20 supermarkets. ## `pageDelay` (type: `integer`): Delay between paginated requests to avoid rate limiting. ## `useApifyProxy` (type: `boolean`): Enable Apify Residential Proxy for reliable data extraction. Requires an Apify paid plan. Free-plan users can provide their own residential proxy via 'customProxyUrl' below. ## `proxyGroups` (type: `array`): Must be set to \['RESIDENTIAL'] for this Actor. ## `proxyCountry` (type: `string`): Country code for proxy (ISO 3166-1 alpha-2). BR is recommended. ## `customProxyUrl` (type: `string`): Provide your own residential proxy instead of using Apify Proxy. Format: http://user:pass@host:port. If set, this overrides the Apify Proxy settings above. ## `maxRetries` (type: `integer`): Maximum retry attempts for failed requests. ## `timeout` (type: `integer`): Request timeout in seconds. ## Actor input object example ```json { "mode": "stores", "latitude": "-23.5608786", "longitude": "-46.6570743", "store_id": "ada76d64-b645-4c5f-af08-be98e5b68f10", "category_id": "85ddf3de-93ab-4542-bfb4-a31f14061d0f", "maxPages": 200, "pageDelay": 1, "useApifyProxy": true, "proxyGroups": [ "RESIDENTIAL" ], "proxyCountry": "BR", "customProxyUrl": "http://user:pass@proxy.example.com:8000", "maxRetries": 3, "timeout": 30 } ``` # Actor output Schema ## `supermarkets` (type: `string`): Extracted supermarket data — stores list, store info, or product catalog depending on the mode used ## `storesView` (type: `string`): View of supermarket list data (stores mode) ## `storeInfoView` (type: `string`): View of detailed supermarket information (store\_info mode) ## `categoriesView` (type: `string`): View of store categories (categories mode). Use these codes to run assortments for each category. ## `assortmentsView` (type: `string`): View of product catalog with prices, EAN, and packaging (assortments mode) # 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 = { "mode": "stores", "latitude": "-23.5608786", "longitude": "-46.6570743", "maxPages": 200, "pageDelay": 1, "useApifyProxy": true, "proxyGroups": [ "RESIDENTIAL" ], "proxyCountry": "BR", "maxRetries": 3, "timeout": 30 }; // Run the Actor and wait for it to finish const run = await client.actor("yasmany.casanova/ifood-supermarket-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 = { "mode": "stores", "latitude": "-23.5608786", "longitude": "-46.6570743", "maxPages": 200, "pageDelay": 1, "useApifyProxy": True, "proxyGroups": ["RESIDENTIAL"], "proxyCountry": "BR", "maxRetries": 3, "timeout": 30, } # Run the Actor and wait for it to finish run = client.actor("yasmany.casanova/ifood-supermarket-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 '{ "mode": "stores", "latitude": "-23.5608786", "longitude": "-46.6570743", "maxPages": 200, "pageDelay": 1, "useApifyProxy": true, "proxyGroups": [ "RESIDENTIAL" ], "proxyCountry": "BR", "maxRetries": 3, "timeout": 30 }' | apify call yasmany.casanova/ifood-supermarket-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=yasmany.casanova/ifood-supermarket-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Ifood Supermarket Scraper", "description": "Extract supermarket data from iFood Brazil: store listings by location, detailed store information, and full product catalogs with prices, EAN codes, packaging, and unit information. Ideal for price intelligence, market research, and e-commerce data.", "version": "1.0", "x-build-id": "jntqlmwPhFDawPrz8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yasmany.casanova~ifood-supermarket-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yasmany.casanova-ifood-supermarket-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/yasmany.casanova~ifood-supermarket-scraper/runs": { "post": { "operationId": "runs-sync-yasmany.casanova-ifood-supermarket-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/yasmany.casanova~ifood-supermarket-scraper/run-sync": { "post": { "operationId": "run-sync-yasmany.casanova-ifood-supermarket-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", "latitude", "longitude" ], "properties": { "mode": { "title": "Operation Mode", "enum": [ "stores", "store_info", "categories", "assortments" ], "type": "string", "description": "Type of data to extract. Typical workflow: stores → categories → assortments (one run per category). Run store_info to validate a store before extracting its catalog.", "default": "stores" }, "latitude": { "title": "Latitude", "type": "string", "description": "Location latitude in Brazil. Use Google Maps to find coordinates: right-click any location and copy the first number.", "default": "-23.5608786" }, "longitude": { "title": "Longitude", "type": "string", "description": "Location longitude in Brazil. Use Google Maps to find coordinates: right-click any location and copy the second number.", "default": "-46.6570743" }, "store_id": { "title": "Store ID", "type": "string", "description": "Supermarket UUID. Required for store_info, categories, and assortments modes. Get this ID from stores mode first." }, "category_id": { "title": "Category ID", "type": "string", "description": "REQUIRED for assortments mode. A category UUID returned by 'categories' mode. Each run extracts ONE category — dispatch parallel runs to cover the full catalog." }, "maxPages": { "title": "Max Pages", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Safety cap on pages fetched in paginated modes. In 'assortments' each page has 50 products (default 200 = up to 10,000). In 'stores' each page has 20 supermarkets.", "default": 200 }, "pageDelay": { "title": "Delay Between Pages (seconds)", "minimum": 0, "maximum": 30, "type": "integer", "description": "Delay between paginated requests to avoid rate limiting.", "default": 1 }, "useApifyProxy": { "title": "Use Apify Residential Proxy", "type": "boolean", "description": "Enable Apify Residential Proxy for reliable data extraction. Requires an Apify paid plan. Free-plan users can provide their own residential proxy via 'customProxyUrl' below.", "default": true }, "proxyGroups": { "title": "Proxy Groups", "type": "array", "description": "Must be set to ['RESIDENTIAL'] for this Actor.", "items": { "type": "string" }, "default": [ "RESIDENTIAL" ] }, "proxyCountry": { "title": "Proxy Country", "pattern": "^[A-Z]{2}$", "type": "string", "description": "Country code for proxy (ISO 3166-1 alpha-2). BR is recommended.", "default": "BR" }, "customProxyUrl": { "title": "Custom Residential Proxy URL (optional)", "type": "string", "description": "Provide your own residential proxy instead of using Apify Proxy. Format: http://user:pass@host:port. If set, this overrides the Apify Proxy settings above." }, "maxRetries": { "title": "Max Retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum retry attempts for failed requests.", "default": 3 }, "timeout": { "title": "Timeout (seconds)", "minimum": 10, "maximum": 120, "type": "integer", "description": "Request timeout in seconds.", "default": 30 } } }, "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 } } } } } } } } } } ```