# GrabFood Restaurant Scraper: Menus, Ratings & Delivery Data (`abotapi/grabfood-restaurants-scraper`) Actor Scrape GrabFood restaurants across Southeast Asia, including SG, MY, TH, VN, PH, ID, KH, and MM. Search by keyword or URL and extract 45+ fields: restaurant name, address, GPS, cuisine, ratings, reviews, promos, delivery time, fees, opening hours, and full menus with item prices and images. - **URL**: https://apify.com/abotapi/grabfood-restaurants-scraper.md - **Developed by:** [Abot API](https://apify.com/abotapi) (community) - **Categories:** E-commerce, Developer tools, Automation - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 restaurant results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 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 ## GrabFood Restaurants Scraper Pull restaurants and full menus from GrabFood across Southeast Asia. Returns 45+ fields per restaurant: name, chain, address, GPS, cuisine tags, star rating and review count, promotions, delivery time and fee, opening hours, price tier, and the complete menu (categories, items, descriptions, prices, discounted/takeaway prices, images, modifier counts). Search by keyword in any of 8 countries, or paste GrabFood URLs (single restaurant or a listing page). ### Why this scraper - 45+ fields per restaurant, including the full menu — vs the ~20 flat fields in the older GrabFood scraper on the Store - Full menu surface: categories, items, descriptions, original and discounted prices, takeaway prices, item images, and modifier-group counts - Delivery detail: estimated delivery time and range, delivery fee (with discounted fee), delivery options (delivery / takeaway / dine-in), price tier - Promotions captured as structured labels (e.g. "S$5.00 off"), not just a boolean flag - Full address block from the restaurant page: street, suburb, postcode, city, country - Rating and review count on every card, with the review count populated from GrabFood's own data - 8 regions: Singapore, Malaysia, Thailand, Vietnam, Philippines, Indonesia, Cambodia, Myanmar - Two modes: search by keyword or paste URLs, plus filters for cuisine, minimum rating, and minimum review count, and 5 sort options ### Ratings and reviews Every restaurant record carries GrabFood's aggregate **`rating`** (star score) and **`voteCount`** (the number of ratings the restaurant has received). These are the rating signals GrabFood exposes on its public web listings. GrabFood's public web surface does **not** expose individual written customer reviews (author, date, review text) — the restaurant page returns only the aggregate score and the total number of ratings. We verified this with a live check of the restaurant detail data on food.grab.com: the merchant payload contains `rating` and `voteCount` but no per-review comment, author, or body objects. Written review text is only available inside the logged-in Grab mobile app, which is not part of the public site. This scraper therefore captures the rating and review-count data that exists, and does not fabricate review text that the site does not provide. ### Data you get > Sample shape, values are illustrative placeholders, not from a live listing. | Field | Example | |---|---| | id | `SGDD00000` | | name | `Sample Burger Place` | | chainName | `Sample Burger` | | branchName | `Downtown` | | cuisine | `["Burger", "Fast Food", "Halal"]` | | address | `Sample Burger Place - Downtown` | | fullAddress | `1 Sample Street, #01-01` | | street | `Sample Street` | | suburb | `Downtown` | | postcode | `000000` | | city | `Singapore` | | countryCode | `SG` | | latitude / longitude | `1.2880` / `103.8520` | | rating | `4.3` | | voteCount | `1200` | | priceTag | `2` | | isOpen | `true` | | estimatedDeliveryTime | `35` | | estimatedDeliveryTimeRange | `From 35 mins` | | distanceInKm | `1.34` | | hasPromo | `true` | | promoLabels | `["S$5.00 off"]` | | deliveryOptions | `DELIVERY_TAKEAWAY_DINEIN` | | deliveryFee | `{ currencyCode, currencySymbol, price, priceDisplay, discountedPrice, hasDiscountedPrice }` | | currency | `{ code: "SGD", symbol: "S$", exponent: 2 }` | | openHours | `{ mon, tue, ..., displayedHours }` | | photoHref / smallPhotoHref / iconHref | image URLs | | grabUrl | `https://food.grab.com/sg/en/restaurant/sample-burger-place/SGDD00000` | | menuCategoryCount / menuItemCount | `12` / `86` | | menu | array of `{ name, available, itemCount, items: [{ id, name, description, price, discountedPrice, takeawayPrice, imageUrl, modifierGroupCount }] }` | | orderValueLimit | `15000` | | announcements | `["Public holiday hours apply"]` | | region | `SG` | | scrapedAt | ISO timestamp | ### Input - **mode** — `search` (keyword queries) or `url` (paste GrabFood links). - **region** — the GrabFood country: SG, MY, TH, VN, PH, ID, KH, MM. - **searchQueries** — keywords to search in the region. Leave empty to browse the region's recommended restaurants. - **startUrls** — GrabFood restaurant pages or listing pages (URL mode). - **cuisineFilter** — keep only restaurants whose cuisine tags contain any of these terms. - **minRating** / **minReviews** — drop restaurants below a rating or review-count threshold. - **sortBy** — default (GrabFood ranking), rating, review count, distance, or delivery time. - **fetchMenu** — enrich each restaurant with the full menu and full address (on by default). - **includeRatings** — populate rating and review count (on by default). - **maxItems** — the main cap: total restaurants per run (default 20). Leave 0 for unlimited. - **maxPages** — no page limit by default; the run stops at Max restaurants. Set only to also cap listing pages walked. - **proxyConfiguration** — a residential connection is required; the exit country is aligned to the region automatically. ### Output One record per restaurant, pushed to the dataset. Enable **fetchMenu** for the full menu and full address block; disable it for faster listing-only runs. ### Send results into your apps (MCP connectors) Optionally pipe results into the apps you already use via Model Context Protocol (MCP) connectors. Authorize a connector once under **Apify → Settings → Integrations**, then select it in the **mcpConnectors** input. Each connector receives a condensed, human-readable summary per item (title + key fields) — the full record always stays in the dataset. Supported: Notion, Linear, Airtable, and Apify. For Notion, also set **notionParentPageUrl**. ### Plan Requirement Runs on any Apify plan. ### Notes - Use a residential connection for reliable listing loads. Datacenter connections may be rejected by the site. - Prices are in the region's currency and are returned in minor units (e.g. cents) alongside a formatted display string where GrabFood provides one. # Actor input Schema ## `mode` (type: `string`): Pick how to find restaurants. Search runs keyword queries in one region. URL mode pastes ready-made GrabFood links (a single restaurant page or a restaurants listing page). ## `region` (type: `string`): GrabFood country to search. Results and prices are for that country's stores. ## `searchQueries` (type: `array`): Keywords to search within the selected region (e.g. "ramen", "pizza", "bubble tea"). Leave empty to browse the region's recommended restaurants instead. Only applies in Search mode. ## `startUrls` (type: `array`): Ready-made GrabFood URLs. Both a single restaurant page (https://food.grab.com///restaurant//) and a restaurants listing page (https://food.grab.com///restaurants?search=) are accepted. Only applies in URL mode. ## `cuisineFilter` (type: `array`): Keep only restaurants whose cuisine tags contain any of these terms (e.g. burger, sushi, halal, western, vegetarian). Case-insensitive substring match. Leave empty to include all. ## `minRating` (type: `integer`): Minimum star rating (0-5). Restaurants below this are skipped. Leave empty for no minimum. ## `minReviews` (type: `integer`): Minimum number of ratings a restaurant must have to be included. Leave empty or 0 for no minimum. ## `sortBy` (type: `string`): Order of restaurants in the output. Default keeps GrabFood's own ranking; the other options re-order the collected results client-side. ## `fetchMenu` (type: `boolean`): When ON, each restaurant is enriched with its full menu (categories, items, prices, images) and full address. Turn off for faster listing-only runs. ## `includeRatings` (type: `boolean`): When ON, the rating score and review count are populated on every record. Turn off if you don't need any rating data. ## `maxItems` (type: `integer`): Hard cap on total restaurants for the whole run. This is the main limit. Leave empty or 0 for unlimited (the run then stops at Max pages). ## `maxPages` (type: `integer`): No page limit by default — the run stops at Max restaurants. Set a number only to also cap how many listing pages are walked per search. ## `proxyConfiguration` (type: `object`): A residential connection is required for reliable listing loads. The exit country is aligned to the selected region automatically. ## `mcpConnectors` (type: `array`): Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON — the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com). ## `notionParentPageUrl` (type: `string`): URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors. ## `maxNotifyListings` (type: `integer`): Cap on items written to each connector per run. Does not affect the dataset. ## Actor input object example ```json { "mode": "search", "region": "SG", "searchQueries": [ "ramen" ], "startUrls": [ "https://food.grab.com/sg/en/restaurants?search=sushi" ], "minReviews": 0, "sortBy": "default", "fetchMenu": true, "includeRatings": true, "maxItems": 20, "maxPages": 0, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxNotifyListings": 50 } ```` # Actor output Schema ## `overview` (type: `string`): No description # 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 = { "searchQueries": [ "ramen" ], "startUrls": [ "https://food.grab.com/sg/en/restaurants?search=sushi" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/grabfood-restaurants-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 = { "searchQueries": ["ramen"], "startUrls": ["https://food.grab.com/sg/en/restaurants?search=sushi"], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/grabfood-restaurants-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 '{ "searchQueries": [ "ramen" ], "startUrls": [ "https://food.grab.com/sg/en/restaurants?search=sushi" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call abotapi/grabfood-restaurants-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/grabfood-restaurants-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "GrabFood Restaurant Scraper: Menus, Ratings & Delivery Data", "description": "Scrape GrabFood restaurants across Southeast Asia, including SG, MY, TH, VN, PH, ID, KH, and MM. Search by keyword or URL and extract 45+ fields: restaurant name, address, GPS, cuisine, ratings, reviews, promos, delivery time, fees, opening hours, and full menus with item prices and images.", "version": "1.0", "x-build-id": "qSDYdtKn41eJ5vchV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~grabfood-restaurants-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-grabfood-restaurants-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/abotapi~grabfood-restaurants-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-grabfood-restaurants-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/abotapi~grabfood-restaurants-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-grabfood-restaurants-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": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "Pick how to find restaurants. Search runs keyword queries in one region. URL mode pastes ready-made GrabFood links (a single restaurant page or a restaurants listing page).", "default": "search" }, "region": { "title": "Region", "enum": [ "SG", "MY", "TH", "VN", "PH", "ID", "KH", "MM" ], "type": "string", "description": "GrabFood country to search. Results and prices are for that country's stores.", "default": "SG" }, "searchQueries": { "title": "Search keywords", "uniqueItems": true, "type": "array", "description": "Keywords to search within the selected region (e.g. \"ramen\", \"pizza\", \"bubble tea\"). Leave empty to browse the region's recommended restaurants instead. Only applies in Search mode.", "items": { "type": "string" } }, "startUrls": { "title": "GrabFood URLs", "uniqueItems": true, "type": "array", "description": "Ready-made GrabFood URLs. Both a single restaurant page (https://food.grab.com///restaurant//) and a restaurants listing page (https://food.grab.com///restaurants?search=) are accepted. Only applies in URL mode.", "items": { "type": "string" } }, "cuisineFilter": { "title": "Cuisine filter", "uniqueItems": true, "type": "array", "description": "Keep only restaurants whose cuisine tags contain any of these terms (e.g. burger, sushi, halal, western, vegetarian). Case-insensitive substring match. Leave empty to include all.", "items": { "type": "string" } }, "minRating": { "title": "Min rating", "minimum": 0, "maximum": 5, "type": "integer", "description": "Minimum star rating (0-5). Restaurants below this are skipped. Leave empty for no minimum." }, "minReviews": { "title": "Min review count", "minimum": 0, "type": "integer", "description": "Minimum number of ratings a restaurant must have to be included. Leave empty or 0 for no minimum.", "default": 0 }, "sortBy": { "title": "Sort results by", "enum": [ "default", "rating", "reviews", "distance", "delivery-time" ], "type": "string", "description": "Order of restaurants in the output. Default keeps GrabFood's own ranking; the other options re-order the collected results client-side.", "default": "default" }, "fetchMenu": { "title": "Fetch full menu", "type": "boolean", "description": "When ON, each restaurant is enriched with its full menu (categories, items, prices, images) and full address. Turn off for faster listing-only runs.", "default": true }, "includeRatings": { "title": "Include rating fields", "type": "boolean", "description": "When ON, the rating score and review count are populated on every record. Turn off if you don't need any rating data.", "default": true }, "maxItems": { "title": "Max restaurants", "minimum": 0, "type": "integer", "description": "Hard cap on total restaurants for the whole run. This is the main limit. Leave empty or 0 for unlimited (the run then stops at Max pages).", "default": 20 }, "maxPages": { "title": "Max pages", "minimum": 0, "type": "integer", "description": "No page limit by default — the run stops at Max restaurants. Set a number only to also cap how many listing pages are walked per search.", "default": 0 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "A residential connection is required for reliable listing loads. The exit country is aligned to the selected region automatically.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON — the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } } } } } } } } } ```