# Just Eat Takeaway Restaurants API Documentation

<p><strong>Just Eat Takeaway Restaurants API Documentation</strong> Search restaurants that deliver to a point or a postcode on Lieferando, Thuisbezorgd, Just Eat and other Takeaway brands. Each restaurant has id, slug, address, position, rating with review count (scale 5), cuisines, delivery fee, fee bands, minimum order, delivery time range, open status, pickup flags and deals. Prices are numbers with a currency code. Countries: de, nl, it, be, at, ch, es, pl and uk. Send lat and lon, or a postcode; lat and lon are the safer input, because some postcode formats find nothing. Filter with cuisine (a slug from available_cuisines), query (name or cuisine text) and open_now. Sort by relevance, rating, delivery_fee, eta, distance or minimum_order. Page N holds page N; a page past the end is an empty list. Use id and slug for the other endpoints. Cost: 1 credit per successful request.</p>

- **Documentation:** [https://scrappa.co/docs/justeat-api/justeat_restaurants](https://scrappa.co/docs/justeat-api/justeat_restaurants)
- **API group:** Just Eat Takeaway API
- **Endpoint:** `GET https://scrappa.co/api/justeat/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 | Country code: de, nl, it, be, at, ch, es, pl or uk. |
| `lat` | number | No | Latitude of the delivery point. Send it with lon, or send a postcode. |
| `lon` | number | No | Longitude of the delivery point. Send it with lat, or send a postcode. |
| `postcode` | string | No | Postcode of the delivery area, for example 80331. Send it, or lat and lon. |
| `query` | string | No | Only restaurants whose name or cuisine contains this text. |
| `cuisine` | string | No | Cuisine slug from available_cuisines, for example pizza. |
| `sort` | string | No | One of relevance, rating, delivery_fee, eta, distance, minimum_order. Default relevance. |
| `open_now` | boolean | No | Send true to get only restaurants that deliver now. |
| `page` | integer | No | One-based page number (default 1). |
| `per_page` | integer | No | Restaurants per page, 1 to 100 (default 20). |

## Example response

```json
{
    "data": {
        "area": {
            "lat": 52.52,
            "lon": 13.405,
            "name": "Berlin Mitte",
            "postal_code": "10178"
        },
        "sort": "relevance",
        "brand": "Lieferando",
        "count": 1,
        "query": null,
        "country": "de",
        "cuisine": "burger",
        "currency": "EUR",
        "open_now": false,
        "pagination": {
            "page": 1,
            "total": 186,
            "per_page": 20,
            "total_pages": 10
        },
        "restaurants": [
            {
                "id": "10614123",
                "name": "The Mood Burger",
                "slug": "the-mood-burger-mitte",
                "tags": [],
                "is_new": false,
                "pickup": {
                    "open_now": true,
                    "available": true
                },
                "rating": {
                    "count": 2232,
                    "scale": 5,
                    "average": 3.8
                },
                "address": {
                    "lat": 52.523914,
                    "lon": 13.399642,
                    "city": "Berlin",
                    "line": "Gro\u00dfe Hamburger Stra\u00dfe 23",
                    "postal_code": "10115"
                },
                "country": "de",
                "cuisines": [
                    {
                        "name": "Burger",
                        "slug": "burger"
                    }
                ],
                "delivery": {
                    "fee": {
                        "amount": 0.99,
                        "currency": "EUR"
                    },
                    "open_now": true,
                    "available": true,
                    "fee_bands": [
                        {
                            "fee": {
                                "amount": 0.99,
                                "currency": "EUR"
                            },
                            "from_order_value": {
                                "amount": 0,
                                "currency": "EUR"
                            }
                        }
                    ],
                    "distance_m": 567,
                    "minimum_order": {
                        "amount": 10,
                        "currency": "EUR"
                    },
                    "eta_max_minutes": 50,
                    "eta_min_minutes": 35,
                    "next_open_local": "2026-11-09T11:00:00"
                },
                "logo_url": "https://res.cloudinary.com/example/logo.png",
                "is_premier": false,
                "promotions": [
                    {
                        "type": "ItemLevelDiscount",
                        "description": "50 % Rabatt auf ausgew\u00e4hlte Produkte"
                    }
                ]
            }
        ],
        "available_cuisines": [
            {
                "name": "Burger",
                "slug": "burger",
                "count": 244
            }
        ]
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "justeat_restaurants"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required parameter or a value is invalid. This response is not billable. |
| 404 | Not Found | No such restaurant, product or page exists. Use the ids and slugs from the restaurants endpoint. This response is not billable. |
| 503 | Service Unavailable | Just Eat Takeaway could not be reached or is busy. Retry in a few seconds. This response is not billable. |
| 502 | Bad Gateway | Just Eat Takeaway answered in a form this API does not know. This response is not billable. |

## 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)