# Foodpanda Restaurants API Documentation

<p><strong>Foodpanda Restaurants API Documentation</strong> Search public Foodpanda restaurants near a point. Send the market as country (sg or ph) and a latitude and longitude. Add a query to use the keyword search, or a cuisine id from a previous answer. The answer has the restaurant code the reviews endpoint accepts unchanged, the name, cuisines, rating and exact review count, delivery time in minutes, delivery fee as a number with its currency, offers, a full-size image and coordinates. Cuisine facets and limit/offset paging ship in the same answer. Filters and sort are applied before return. 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/foodpanda-api/foodpanda_restaurants](https://scrappa.co/docs/foodpanda-api/foodpanda_restaurants)
- **API group:** Foodpanda API
- **Endpoint:** `GET https://scrappa.co/api/foodpanda/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 | Cuisine, dish or restaurant name. Uses the keyword search. |
| `cuisine` | string | No | Cuisine id or title from a previous answer. |
| `page` | integer | No | 1-based page number, default 1. |
| `limit` | integer | No | Restaurants per page, default 20, maximum 100. |
| `sort` | string | No | recommended, rating, delivery_time or distance. |
| `min_rating` | number | No | Only restaurants with at least this rating, from 1 to 5. |
| `open_now` | boolean | No | Set to 1 to keep only restaurants open now. |

## Example response

```json
{
    "data": {
        "page": 1,
        "count": 1,
        "total": 231,
        "cuisines": [
            {
                "id": "pizza",
                "name": "Pizza",
                "count": 57
            }
        ],
        "currency": "SGD",
        "has_more": true,
        "next_page": 2,
        "restaurants": [
            {
                "id": "xjer",
                "name": "Example Pizza",
                "image": "https://img.foodpanda.sg/example.jpg",
                "offers": [
                    {
                        "title": "20% off"
                    }
                ],
                "rating": 4.5,
                "cuisines": [
                    "Pizza",
                    "Italian"
                ],
                "latitude": 1.3521,
                "longitude": 103.8198,
                "eta_minutes": 30,
                "delivery_fee": {
                    "amount": 2.99,
                    "currency": "SGD"
                },
                "review_count": 320
            }
        ]
    },
    "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)
