Just Eat Takeaway Restaurants API Documentation 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.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
9 optional filters available.
string
Required
Country code: de, nl, it, be, at, ch, es, pl or uk.
US
number
Optional
Latitude of the delivery point. Send it with lon, or send a postcode.
10
number
Optional
Longitude of the delivery point. Send it with lat, or send a postcode.
10
string
Optional
Postcode of the delivery area, for example 80331. Send it, or lat and lon.
example
string
Optional
Only restaurants whose name or cuisine contains this text.
coffee shops
string
Optional
Cuisine slug from available_cuisines, for example pizza.
example
string
Optional
One of relevance, rating, delivery_fee, eta, distance, minimum_order. Default relevance.
relevance
boolean
Optional
Send true to get only restaurants that deliver now.
true
integer
Optional
One-based page number (default 1).
1
integer
Optional
Restaurants per page, 1 to 100 (default 20).
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"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
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter or a value is invalid. This response is not billable.
{
"errors": {
"country": [
"The country is one of de, nl, it, be, at, ch, es, pl, uk."
]
},
"message": "The request validation failed"
}Not Found
No such restaurant, product or page exists. Use the ids and slugs from the restaurants endpoint. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false
},
"error": {
"code": "NOT_FOUND",
"message": "No such restaurant, product or page was found. Use the ids from the restaurants endpoint."
},
"success": false
}Service Unavailable
Just Eat Takeaway could not be reached or is busy. Retry in a few seconds. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Just Eat Takeaway API is temporarily unavailable. Please retry."
},
"success": false
}Bad Gateway
Just Eat Takeaway answered in a form this API does not know. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false
},
"error": {
"code": "PARSER_DRIFT",
"message": "Just Eat Takeaway rejected the request. Check the parameters and try again."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.