Skip to main content
POST
/
api
/
justeat
/
restaurants
/
search
/justeat/restaurants/search
curl --request POST \
  --url https://api.anysite.io/api/justeat/restaurants/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "postcode": "<string>",
  "count": 2,
  "timeout": 300,
  "service_type": "delivery",
  "cuisines": [],
  "open_now": false,
  "free_delivery": false,
  "has_deals": false,
  "new_only": false,
  "min_rating": 2.5,
  "sort": "recommended"
}
'
[
  {
    "id": "<string>",
    "@type": "JusteatSearchRestaurant",
    "name": "<string>",
    "alias": "<string>",
    "menu_url": "<string>",
    "image": "<string>",
    "address": {
      "@type": "JusteatAddress",
      "street": "<string>",
      "city": "<string>",
      "postcode": "<string>",
      "latitude": 123,
      "longitude": 123,
      "country": "<string>"
    },
    "rating": 123,
    "review_count": 123,
    "cuisines": [],
    "distance_meters": 123,
    "eta_minutes": 123,
    "eta_lower": 123,
    "eta_upper": 123,
    "delivery_cost": 123,
    "minimum_delivery_value": 123,
    "is_delivery": false,
    "is_collection": false,
    "is_open_now_delivery": false,
    "is_open_now_collection": false,
    "is_open_now_preorder": false,
    "is_temporarily_offline": false,
    "is_new": false,
    "is_premier": false,
    "next_opening_at": "<string>",
    "deals": []
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
postcode
string
required

UK delivery postcode

Minimum string length: 1
Examples:

"EC1A 1BB"

"SW1A1AA"

count
integer
required

Max number of restaurants to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
service_type
enum<string>
default:delivery

Delivery or collection

Available options:
delivery,
collection
cuisines
enum<string>[]

Filter by cuisine/category (a restaurant must match all selected)

Available options:
deals,
stampcard-restaurants,
halal,
burgers,
chicken,
breakfast,
groceries,
pizza,
indian,
italian,
coffee,
alcohol,
lunch,
asian,
american,
freebies,
kebabs,
sandwiches,
japanese,
chinese,
desserts,
sushi,
curry,
healthy,
convenience,
thai,
pasta,
mediterranean,
turkish,
greek,
mexican,
cafe,
lebanese,
grill,
shops,
korean,
bubble-tea,
noodles,
caribbean,
vietnamese,
fish-and-chips,
middle-eastern,
pharmacy,
burritos,
african,
health-and-beauty,
streetfood,
wraps,
bagels,
bakery,
british,
cakes,
european,
salads,
ethiopian,
bangladeshi,
brunch,
poke,
dinner,
icecream,
malaysian,
smoothies,
electronics,
italianpizza,
jamaican,
peri-peri,
pies,
southamerican,
biryani,
doughnuts,
milkshakes,
nepalese,
pakistani,
seafood,
drinks,
fusion,
hot-dogs,
oriental,
pubfood,
english,
south-indian,
tapas,
waffles,
afghanistani,
authentic-pizza,
bbq,
brazilian-food,
cantonese,
indo-chinese-fusion,
steak,
dim-sum,
glutenfree,
gourmet,
jerk,
pan-asian,
persian,
spanish,
eastern-european,
fastfood,
filipino,
frozenyogurt,
Moroccan,
nigerian,
portuguese,
venezuelan,
argentinian,
crepes,
english-breakfast,
flowers,
french,
ghanaian,
indonesian,
iranian,
latinamerican,
pancakes,
sichuan,
sri-lankan,
allnightalcohol,
beauty,
business-lunch,
columbian,
deli,
german,
gifts,
gourmetburgers,
iraqi,
kurdish,
peruvian,
polish,
roast-dinners,
singapore,
southafrican,
specialty,
syrian,
taiwanese,
ukrainian,
west-african,
meal_deal,
local-legends,
arabic,
baguettes,
balti,
carvery,
continental,
cuban,
egyptian,
georgian,
household,
hungarian,
paninis,
parmesans,
pet-supplies,
picknmix,
punjabi,
romanian,
rotisserie,
scottish,
smoke-house,
soup,
southindian,
subways,
supermarkets,
sweets,
tex-mex,
8off,
favouritespersonalised,
new
open_now
boolean
default:false

Only restaurants open now for the chosen service type

free_delivery
boolean
default:false

Only restaurants with free delivery

has_deals
boolean
default:false

Only restaurants with active deals/offers

new_only
boolean
default:false

Only newly added restaurants

min_rating
number | null

Only restaurants with at least this average rating

Required range: 0 <= x <= 5
sort
enum<string>
default:recommended

Result ordering

Available options:
recommended,
rating,
distance,
delivery_cost,
fastest

Response

Successful Response

id
string
required
@type
string
default:JusteatSearchRestaurant
name
string | null
alias
string | null
menu_url
string | null
image
string | null
address
object
rating
number | null
review_count
integer | null
cuisines
string[]
distance_meters
number | null
eta_minutes
number | null
eta_lower
number | null
eta_upper
number | null
delivery_cost
number | null
minimum_delivery_value
number | null
is_delivery
boolean
default:false
is_collection
boolean
default:false
is_open_now_delivery
boolean
default:false
is_open_now_collection
boolean
default:false
is_open_now_preorder
boolean
default:false
is_temporarily_offline
boolean
default:false
is_new
boolean
default:false
is_premier
boolean
default:false
next_opening_at
string | null
deals
object[]