Just Eat

Search Just Eat restaurants near a UK postcode

Returns Just Eat's full restaurant listing for a UK postcode -- every restaurant the site's own area page carries, ordered as Just Eat's default "best match" sort presents them (or by sort_by, if set), not a curated subset. Each restaurant carries its unique_name (the value the restaurant and menu endpoints take), name, image, rating, delivery time window, and open-now status. A postcode with no coverage returns an empty list rather than an error.

get/justeat/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/justeat/search
  • Auth: API key in header x-api-key

Query parameters

postcodestring required

UK postcode to search near

limitinteger

Restaurants to return, clamped to 100 (default 20)

filterstring[]

Repeatable. Just Eat's own area-page filter slugs (e.g. open_now, or a cuisine tile's slug), passed through as-is and OR'd together. Also reaches non-restaurant categories -- groceries, alcohol, pharmacy, electronics, and more -- via the same mechanism, e.g. filter=groceries. The valid slug set is specific to the postcode you are searching -- call /justeat/search/filters with the same postcode for the current, complete, location-scoped list with live result counts. An unrecognized slug narrows to a smaller or empty result rather than erroring.

sort_by'best_match' | 'review_rating' | 'distance' | 'delivery_time' | 'minimum_order_value' | 'delivery_fee'

Result order, matching the area page's own Sort by control. Default best_match.

Headers

x-api-keystring required

API key required

Response

OK

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Changes

No recorded changes to this operation across all 2 revisions of this API.