# Just Eat UK Restaurant Scraper (`scrapeworks/justeat-restaurant-scraper`) Actor Scrape restaurant and takeaway listings from Just Eat UK (just-eat.co.uk) by postcode. Get name, address, geo, star rating, reviews, cuisines, delivery fee, minimum order, delivery ETA, open status and deals - 1,000+ takeaways per big-city postcode. Bulk postcode lists, no login. - **URL**: https://apify.com/scrapeworks/justeat-restaurant-scraper.md - **Developed by:** [Nicolas van Arkens](https://apify.com/scrapeworks) (community) - **Categories:** Lead generation, Business, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Just Eat UK Restaurant Scraper Scrape **restaurant and takeaway listings from Just Eat UK (just-eat.co.uk)** by postcode — in bulk, with no login, no API key and no browser. Enter a list of UK postcodes and get back every restaurant Just Eat lists for those areas: name, address, geo coordinates, star rating and review count, cuisines, delivery fee, minimum order value, delivery time estimate, open/closed status and current deals. A single big-city postcode returns **1,000–2,000+ restaurants in one call**. A handful of postcode districts covers a whole city's food-delivery market. ### What data do you get? One clean JSON row per restaurant: | Field | Description | |---|---| | `id`, `name`, `justEatUrl` | Just Eat restaurant id, display name, direct menu URL | | `addressFirstLine`, `city`, `postalCode` | Street address of the restaurant | | `latitude`, `longitude` | Exact geo coordinates | | `driveDistanceMeters` | Driving distance from the searched postcode | | `ratingStars`, `ratingCount` | Star rating (0–5) and number of customer reviews | | `isNew`, `isPremier` | New-on-platform flag, Premier partner flag | | `cuisines` | Cuisine list, e.g. `["Pizza", "Italian", "Halal"]` | | `deals`, `dealCount` | Active offers, e.g. "20% off selected items" with offer type | | `deliveryCost` | Delivery fee in GBP | | `minimumDeliveryValue` | Minimum order value in GBP | | `deliveryEtaMinutes` / `Lower` / `Upper` | Estimated delivery time range (present while the restaurant is open) | | `isDelivery`, `isCollection` | Which channels the restaurant offers | | `isOpenNowForDelivery`, `isOpenNowForCollection`, `isOpenNowForPreorder`, `isTemporarilyOffline` | Live status | | `openingTimeLocal`, `deliveryOpeningTimeLocal` | Next/current opening times | | `logoUrl` | Restaurant logo image | | `searchPostcode`, `resolvedArea`, `scrapedAt` | Which postcode found this row, the area Just Eat resolved it to, timestamp | ### Input example ```json { "postcodes": ["EC4M", "M1 1AD", "LS1 4DY"], "cuisines": ["pizza", "indian"], "openNowOnly": false, "maxResultsPerPostcode": 5000 } ```` - **`postcodes`** — full postcodes (`"SW1A 1AA"`) or district outcodes (`"EC4M"`, `"M1"`) both work. This is the bulk axis: one deep pull per postcode, merged and de-duplicated by restaurant. - **`cuisines`** *(optional)* — case-insensitive filter, e.g. `pizza`, `indian`, `chinese`, `halal`, `burgers`, `sushi`, `kebab`, `breakfast`, `groceries`. Leave empty for everything. - **`openNowOnly`** *(optional)* — only return restaurants currently open for delivery or collection. - **`maxResultsPerPostcode` / `maxResults`** — per-postcode and overall caps on billed rows. ### Output sample (real data) ```json { "id": "433025", "name": "Popeyes Louisiana Chicken - London Bridge", "justEatUrl": "https://www.just-eat.co.uk/restaurants-popeyes-louisiana-chicken---london-bridge-southwark-se1/menu", "addressFirstLine": "Unit SU88, London Bridge Station", "city": "London", "postalCode": "SE1 3QX", "latitude": 51.505664, "longitude": -0.086358, "driveDistanceMeters": 1289, "ratingStars": 5, "ratingCount": 15, "isNew": false, "isPremier": false, "cuisines": ["Chicken", "Burgers", "Halal", "Deals"], "deals": [ { "description": "20% off selected items", "offerType": "ItemLevelDiscount" } ], "dealCount": 3, "deliveryCost": 1.99, "minimumDeliveryValue": 0, "deliveryEtaMinutes": 30, "deliveryEtaLower": 20, "deliveryEtaUpper": 35, "isDelivery": true, "isCollection": false, "isOpenNowForDelivery": true, "isTemporarilyOffline": false, "openingTimeLocal": "2026-07-26T14:00:00", "logoUrl": "https://d30v2pzvrfyzpo.cloudfront.net/uk/images/restaurants/433025.gif", "searchPostcode": "EC4M", "resolvedArea": "London", "scrapedAt": "2026-07-26T12:00:00+00:00" } ``` ### Use cases - **Market research & competitor analysis** — map every takeaway in a city: cuisines, ratings, delivery fees, minimum orders and active discounts. Compare markets postcode by postcode. - **Lead generation** — build a list of independent restaurants (name, address, geo, rating) for POS systems, packaging suppliers, delivery services, insurance or marketing agencies selling to the hospitality sector. - **Pricing & promotions monitoring** — track delivery fees, minimum order values and running deals across areas over time; re-run daily and diff. - **Location intelligence** — restaurant density, cuisine mix and rating distribution per postcode for site-selection and investment analysis. ### FAQ **Which postcodes work?** Any UK postcode Just Eat delivers to — full postcodes and district outcodes both work. An unknown postcode simply returns 0 rows for that entry; the run continues with the rest. **How many restaurants can I expect?** Central London districts return ~2,000 per postcode, large cities ~800–1,500, small towns fewer. Nearby postcodes overlap heavily — results are automatically de-duplicated across your whole list, and you are only billed for unique rows. **Why is `deliveryEtaMinutes` sometimes empty?** Just Eat only publishes a delivery estimate while the restaurant is open for delivery. Closed restaurants still return all their static data (address, rating, cuisines, fees, opening times). **Does it include menus and dish prices?** No — this actor returns the restaurant directory data shown on Just Eat search pages (one row per restaurant), which is what fee/rating/lead analysis needs. **Is this legal?** The actor only collects publicly available business information that anyone can see on just-eat.co.uk. No personal accounts, no login, no personal data. ### Pricing Pay per result: you are charged a small fixed amount **per restaurant row** actually delivered. Failed requests, blocked pages and duplicate restaurants cost nothing. # Actor input Schema ## `postcodes` (type: `array`): One or more UK postcodes to scrape restaurants for. Both full postcodes ("SW1A 1AA") and postcode districts / outcodes ("EC4M", "M1", "LS1") work. This is the BULK axis: the actor pulls the FULL restaurant list for each postcode (often 1,000-2,000+ takeaways per big-city postcode) and merges everything, de-duplicated by restaurant. A list of district outcodes covering a city returns the whole city's delivery market in one run. ## `cuisines` (type: `array`): Only keep restaurants matching at least one of these cuisines or tags, e.g. "pizza", "indian", "chinese", "halal", "burgers", "sushi", "kebab", "breakfast", "groceries", "vegan". Matching is case-insensitive against each restaurant's cuisine list. Leave empty to return every restaurant. ## `openNowOnly` (type: `boolean`): If enabled, only restaurants that are currently open for delivery or collection are returned. Leave off (default) to get the complete directory including currently-closed places - their opening times are still in the data. ## `maxResultsPerPostcode` (type: `integer`): Maximum restaurants to return for EACH postcode. Big-city postcodes carry 1,000-2,000+ restaurants; the default of 5000 returns everything Just Eat lists for the area. Lower it to sample. Every restaurant returned is billed once. ## `maxResults` (type: `integer`): Optional overall cap across ALL postcodes combined (after de-duplication). Leave empty for no overall cap - each postcode is still bounded by Max results per postcode. Useful to cap the total billed rows for a run. ## `proxyConfiguration` (type: `object`): Fallback proxy for reaching Just Eat's listing API. The actor sends requests DIRECTLY first and only routes through this proxy - rotating exits - if a request is blocked or rate-limited. The default (Apify Residential, GB) is a safe fallback; leave it in place. ## Actor input object example ```json { "postcodes": [ "EC4M", "M1 1AD", "LS1 4DY", "B1 1AA" ], "cuisines": [ "pizza", "indian" ], "openNowOnly": false, "maxResultsPerPostcode": 5000, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "postcodes": [ "EC4M", "M1 1AD" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapeworks/justeat-restaurant-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "postcodes": [ "EC4M", "M1 1AD", ], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "GB", }, } # Run the Actor and wait for it to finish run = client.actor("scrapeworks/justeat-restaurant-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "postcodes": [ "EC4M", "M1 1AD" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } }' | apify call scrapeworks/justeat-restaurant-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapeworks/justeat-restaurant-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Just Eat UK Restaurant Scraper", "description": "Scrape restaurant and takeaway listings from Just Eat UK (just-eat.co.uk) by postcode. Get name, address, geo, star rating, reviews, cuisines, delivery fee, minimum order, delivery ETA, open status and deals - 1,000+ takeaways per big-city postcode. Bulk postcode lists, no login.", "version": "0.1", "x-build-id": "FxCN3nkxw8Vj2lBL8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeworks~justeat-restaurant-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeworks-justeat-restaurant-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapeworks~justeat-restaurant-scraper/runs": { "post": { "operationId": "runs-sync-scrapeworks-justeat-restaurant-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapeworks~justeat-restaurant-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeworks-justeat-restaurant-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "postcodes" ], "properties": { "postcodes": { "title": "UK postcodes", "uniqueItems": true, "type": "array", "description": "One or more UK postcodes to scrape restaurants for. Both full postcodes (\"SW1A 1AA\") and postcode districts / outcodes (\"EC4M\", \"M1\", \"LS1\") work. This is the BULK axis: the actor pulls the FULL restaurant list for each postcode (often 1,000-2,000+ takeaways per big-city postcode) and merges everything, de-duplicated by restaurant. A list of district outcodes covering a city returns the whole city's delivery market in one run.", "items": { "type": "string" } }, "cuisines": { "title": "Cuisine filter (optional)", "uniqueItems": true, "type": "array", "description": "Only keep restaurants matching at least one of these cuisines or tags, e.g. \"pizza\", \"indian\", \"chinese\", \"halal\", \"burgers\", \"sushi\", \"kebab\", \"breakfast\", \"groceries\", \"vegan\". Matching is case-insensitive against each restaurant's cuisine list. Leave empty to return every restaurant.", "items": { "type": "string" } }, "openNowOnly": { "title": "Only restaurants open now", "type": "boolean", "description": "If enabled, only restaurants that are currently open for delivery or collection are returned. Leave off (default) to get the complete directory including currently-closed places - their opening times are still in the data.", "default": false }, "maxResultsPerPostcode": { "title": "Max results per postcode", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum restaurants to return for EACH postcode. Big-city postcodes carry 1,000-2,000+ restaurants; the default of 5000 returns everything Just Eat lists for the area. Lower it to sample. Every restaurant returned is billed once.", "default": 5000 }, "maxResults": { "title": "Max results overall (optional)", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Optional overall cap across ALL postcodes combined (after de-duplication). Leave empty for no overall cap - each postcode is still bounded by Max results per postcode. Useful to cap the total billed rows for a run." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Fallback proxy for reaching Just Eat's listing API. The actor sends requests DIRECTLY first and only routes through this proxy - rotating exits - if a request is blocked or rate-limited. The default (Apify Residential, GB) is a safe fallback; leave it in place.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```