{ "openapi": "3.0.1", "info": { "title": "Grabfood Restaurant Scraper", "description": "Scrape GrabFood restaurants with full menus, prices, ratings, and delivery info across Vietnam, Singapore, Malaysia, Indonesia, Philippines, Cambodia, Myanmar. 97 city presets across 7 countries. Hex grid search for comprehensive city coverage. Export to JSON/CSV/Excel.", "version": "1.2", "x-build-id": "8pOiH1PU1JmbFx0P1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlsmith~grabfood-restaurant-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlsmith-grabfood-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/crawlsmith~grabfood-restaurant-scraper/runs": { "post": { "operationId": "runs-sync-crawlsmith-grabfood-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/crawlsmith~grabfood-restaurant-scraper/run-sync": { "post": { "operationId": "run-sync-crawlsmith-grabfood-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", "properties": { "country": { "title": "Country", "enum": [ "VN", "SG", "MY", "ID", "PH", "KH", "MM" ], "type": "string", "description": "GrabFood country. Thailand is not supported (different auth flow).", "default": "VN" }, "city": { "title": "City", "enum": [ "ho_chi_minh", "ha_noi", "da_nang", "hai_phong", "can_tho", "hue", "cao_bang", "tuyen_quang", "dien_bien", "lai_chau", "son_la", "lao_cai", "thai_nguyen", "lang_son", "quang_ninh", "bac_ninh", "phu_tho", "hung_yen", "ninh_binh", "thanh_hoa", "nghe_an", "ha_tinh", "quang_tri", "quang_ngai", "gia_lai", "khanh_hoa", "dak_lak", "lam_dong", "dong_nai", "tay_ninh", "dong_thap", "vinh_long", "an_giang", "ca_mau", "singapore", "kuala_lumpur", "george_town", "johor_bahru", "ipoh", "kota_kinabalu", "kuching", "malacca", "petaling_jaya", "shah_alam", "putrajaya", "seremban", "kuantan", "kota_bharu", "alor_setar", "miri", "jakarta", "surabaya", "bandung", "semarang", "yogyakarta", "malang", "solo", "bogor", "tangerang", "bekasi", "depok", "medan", "palembang", "pekanbaru", "batam", "padang", "lampung", "bali", "makassar", "manado", "balikpapan", "pontianak", "banjarmasin", "manila", "quezon_city", "makati", "taguig", "pasig", "paranaque", "cebu", "davao", "iloilo", "bacolod", "cagayan_de_oro", "baguio", "zamboanga", "angeles", "phnom_penh", "siem_reap", "battambang", "sihanoukville", "kampong_cham", "yangon", "mandalay", "nay_pyi_taw", "bago", "mawlamyine", "custom" ], "type": "string", "description": "City preset. Select a city matching your chosen country. VN: 34 provinces. MY: 15 cities. ID: 23 cities. PH: 14 cities. KH: 5 cities. MM: 5 cities. SG: 1. Use 'custom' for custom coordinates.", "default": "ho_chi_minh" }, "custom_latlng": { "title": "Custom Lat,Lng", "type": "string", "description": "Custom coordinates as 'lat,lng' (e.g. '10.7769,106.7009'). Only used when city is 'custom'.", "default": "" }, "use_grid": { "title": "Use Grid Search", "type": "boolean", "description": "Enable hex grid search for comprehensive city coverage. When disabled, searches from a single point only.", "default": false }, "grid_radius_km": { "title": "Grid Radius (km)", "minimum": 1, "maximum": 30, "type": "number", "description": "Coverage radius from city center in kilometers. Defaults to city preset value.", "default": 10 }, "grid_step_km": { "title": "Grid Step (km)", "minimum": 1, "maximum": 10, "type": "number", "description": "Distance between grid points in kilometers. Smaller = more thorough but slower.", "default": 3 }, "search_keyword": { "title": "Search Keyword", "type": "string", "description": "Optional keyword to filter restaurants (e.g. 'pizza', 'coffee', 'pho').", "default": "" }, "cuisine_filter": { "title": "Cuisine Filter", "type": "array", "description": "Filter by cuisine types. Leave empty for all cuisines.", "items": { "type": "string" }, "default": [] }, "max_restaurants": { "title": "Max Restaurants", "minimum": 0, "type": "integer", "description": "Maximum number of restaurants to scrape. Set to 0 for unlimited.", "default": 50 }, "include_menu": { "title": "Include Menu", "type": "boolean", "description": "Fetch full menu with prices for each restaurant. Disabling speeds up scraping significantly.", "default": true }, "requests_per_second": { "title": "Requests Per Second", "minimum": 0.5, "maximum": 10, "type": "number", "description": "Rate limit for API calls. Lower values are safer but slower.", "default": 2 }, "proxy_type": { "title": "Proxy Type", "enum": [ "none", "residential", "datacenter" ], "type": "string", "description": "Proxy configuration. GrabFood usually works without proxy from Vietnam.", "default": "none" }, "proxy_urls": { "title": "Custom Proxy URLs", "type": "array", "description": "Custom proxy list. Overrides proxy_type when provided.", "items": { "type": "string" }, "default": [] } } }, "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 } } } } } } } } } }