{ "openapi": "3.0.1", "info": { "title": "iFood Scraper — Anti-Block: Menus, Prices & Reviews", "description": "iFood scraper with URL enrichment and Google SERP discovery. Extract restaurants, menus with prices, reviews and ratings. Pass URLs directly OR search by city. Start FREE.", "version": "0.0", "x-build-id": "Sz3eU6rjkUWWvSpa3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapepilot~ifood-scraper-anti-block-menus-prices-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapepilot-ifood-scraper-anti-block-menus-prices-reviews", "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/scrapepilot~ifood-scraper-anti-block-menus-prices-reviews/runs": { "post": { "operationId": "runs-sync-scrapepilot-ifood-scraper-anti-block-menus-prices-reviews", "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/scrapepilot~ifood-scraper-anti-block-menus-prices-reviews/run-sync": { "post": { "operationId": "run-sync-scrapepilot-ifood-scraper-anti-block-menus-prices-reviews", "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": "Extraction Mode", "enum": [ "direct_urls", "google_serp", "both" ], "type": "string", "description": "Select Direct URL scraping, Keyword Discovery via Google SERP, or BOTH to run direct URLs and discover additional restaurants.", "default": "both" }, "restaurantUrls": { "title": "Restaurant URLs (Direct / Both Mode)", "type": "array", "description": "List of iFood restaurant URLs to enrich directly. Format: https://www.ifood.com.br/delivery/{city}/{slug}/{uuid}", "default": [ "https://www.ifood.com.br/delivery/sao-paulo-sp/bubblekill-patio-paulista-bela-vista/5024be82-d729-41b9-a64f-d44ba306f232" ], "items": { "type": "string" } }, "city": { "title": "City Slug", "type": "string", "description": "City slug to search for restaurants (e.g. 'sao-paulo-sp', 'rio-de-janeiro-rj', 'belo-horizonte-mg').", "default": "sao-paulo-sp" }, "address": { "title": "Delivery Address", "type": "string", "description": "Full delivery address to set location context (e.g. 'Av Paulista 1000'). Required for iFood delivery and distance calculation.", "default": "Av Paulista 1000" }, "query": { "title": "Search Keyword / Cuisine Filter", "type": "string", "description": "Keyword to find restaurants on Google SERP or filter results (e.g. 'sucos', 'pizza', 'sushi', 'hamburguer').", "default": "" }, "maxRestaurants": { "title": "Max Restaurants", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of restaurants to extract (1-200). On Apify Free plan, this is automatically capped to 2 with a notification.", "default": 3 }, "includeMenu": { "title": "Include Menu", "type": "boolean", "description": "Whether to extract menu items with prices for each restaurant. Inspect the output coverage metadata for completeness status.", "default": true }, "includeReviews": { "title": "Include Customer Reviews", "type": "boolean", "description": "Whether to extract customer ratings and comments for each restaurant when available.", "default": false }, "menuMode": { "title": "Menu Coverage Mode", "enum": [ "limited", "all" ], "type": "string", "description": "Choose 'limited' to return at most maxMenuItems per restaurant, or 'all' to remove the local Actor cap. Beta safety gate: 'all' cannot be combined with downloadImages=true.", "default": "limited" }, "maxMenuItems": { "title": "Max Menu Items per Restaurant (Limited Mode)", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of menu items returned per restaurant when menuMode='limited'. Ignored when menuMode='all'.", "default": 50 }, "downloadImages": { "title": "Download Menu Item Images", "type": "boolean", "description": "Download menu item photos and save them to the Key-Value Store with imageDownloadUrl. Supported only with menuMode='limited'.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify Proxy settings. Automatic rotation: uses Google SERP proxy for Google discovery and Brazilian Residential proxy for iFood scraping.", "default": { "useApifyProxy": true } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }