# GrabFood Restaurants API Documentation

<p><strong>GrabFood Restaurants API Documentation</strong> Search public GrabFood restaurants near a point. Send the market as country (SG or PH) and a latitude and longitude. Add a query to search by restaurant or dish name. The answer has the restaurant id the restaurant endpoint accepts unchanged, the name, chain and branch, cuisines, rating and review count as numbers, delivery time in minutes, delivery fee as a number with its currency, promotions, a full-size image and coordinates. Cuisine facets and offset paging ship in the answer. Filters and sort are applied in Scrappa before return, because the source ignores them. Cost: 1 credit per successful request. Failed requests are not billed. Filters and sort are applied to the fetched page; a page can hold fewer rows than the page size while more pages remain.</p>

- **Documentation:** [https://scrappa.co/docs/grabfood-api/grabfood_restaurants](https://scrappa.co/docs/grabfood-api/grabfood_restaurants)
- **API group:** GrabFood API
- **Endpoint:** `GET https://scrappa.co/api/grabfood/restaurants`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `country` | string | Yes | Market: SG or PH. Required. |
| `lat` | number | Yes | Latitude of the delivery point, for example 1.3521. Required. |
| `lng` | number | Yes | Longitude of the delivery point, for example 103.8198. Required. |
| `query` | string | No | Restaurant or dish name. Leave out for nearby browse. |
| `category` | string | No | Cuisine name from a previous answer. |
| `page` | integer | No | 1-based page number, default 1. |
| `limit` | integer | No | Restaurants per page, default 20, maximum 50. |
| `sort` | string | No | recommended, rating, delivery_time or distance. |
| `min_rating` | number | No | Only restaurants with at least this rating, from 1 to 5. |

## Example response

```json
{
    "data": {
        "page": 1,
        "count": 1,
        "facets": [
            {
                "id": "pizza",
                "name": "Pizza"
            }
        ],
        "currency": "SGD",
        "has_more": true,
        "next_page": 2,
        "restaurants": [
            {
                "id": "abc123",
                "name": "Example Pizza",
                "image": "https://food.grab.com/example.jpg",
                "offers": [
                    {
                        "title": "Free delivery"
                    }
                ],
                "rating": 4.5,
                "cuisines": [
                    "Pizza"
                ],
                "latitude": 1.3521,
                "longitude": 103.8198,
                "eta_minutes": 30,
                "delivery_fee": {
                    "amount": 2.5,
                    "currency": "SGD"
                },
                "review_count": 210
            }
        ]
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "restaurants"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 502 | Upstream Unavailable | The site did not answer or sent data Scrappa cannot read. This response is not billable. Retry in a moment. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
