# Just Eat Scraper Spain — Restaurants, Menus & Fees (`rastriq/just-eat-spain-scraper`) Actor

Scrape Just Eat Spain by postal code: every restaurant with rating, deals, minimum order, delivery fees and ETA, plus the full menu and price per product for the chains you choose. No login.

- **URL**: https://apify.com/rastriq/just-eat-spain-scraper.md
- **Developed by:** [Rastriq — Structured data from the world](https://apify.com/rastriq) (community)
- **Categories:** E-commerce, Business, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.05 / 1,000 restaurant or products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Just Eat Scraper Spain — Restaurants, Menu Prices & Delivery Fees

**Just Eat Spain Scraper** lists every restaurant that Just Eat Spain (just-eat.es) shows for the postal codes you choose. For each one you get its rating, deals, delivery fees, minimum order and delivery time. For the restaurant chains you pick, it also reads the full menu with the price of each product. Use it to monitor food-delivery prices, compare chains street by street, or map the delivery offer in a city.

### 🍔 What is Just Eat Spain Scraper?

Just Eat is one of the three big food-delivery platforms in Spain. Its pages show which restaurants deliver to an address, at what fee, and at what menu price. That is exactly what a franchise chain, a competitor or an analyst wants to track, but the website only shows one address at a time.

Just Eat Spain Scraper turns that into a dataset:

- 📍 **By postal code**: give `28013` or a whole prefix (`280` = all of Madrid) and get the union of restaurants, de-duplicated.
- 🏷️ **By chain**: keep only McDonald's, Burger King, KFC, Goiko, VIPS… (29 chains recognised by name) and read their menus.
- 🔗 **By Just Eat slug**: read the menus of specific restaurants, e.g. the Just Eat links that chain store locators publish.

It uses plain HTTP requests to the public pages, with no login and no browser. It goes out direct and switches to a residential proxy in Spain only if Just Eat starts blocking.

### 📊 What data does Just Eat Spain Scraper extract?

Two record types share one dataset (`recordType`).

**Store records** (one per restaurant and run):

| Field | Example |
|---|---|
| 🆔 `restaurantId`, `uniqueName` | `17230`, `kfcatocha` |
| 🏪 `name`, `chain`, `brandName` | KFC Atocha, `kfc` |
| 📍 `address`, `postalCode`, `city`, `latitude`, `longitude` | Atocha, 118 · 28012 Madrid |
| ⭐ `ratingStars`, `ratingCount` | 4.2 · 1,530 |
| 🎁 `deals` | `Percent` — "Ahorra un 20% • A partir de 40 €" |
| 🚚 `minOrderEur`, `deliveryFeeLowestEur`, `deliveryFeeAtMinOrderEur` | 10.00 · 3.49 · 4.49 |
| ⏱️ `etaMinutesMin`, `etaMinutesMax` | 35–50 |
| 🔌 `isTemporarilyOffline`, `isOpenNowForDelivery`, `isNew` | |
| 🗺️ `seenInPostalCodes` | postal codes whose listing included it |

**Product records** (one per restaurant and product variation):

| Field | Example |
|---|---|
| 🆔 `productId`, `variationId` | Just Eat UUIDs, shared across stores of a chain |
| 🍟 `productName`, `variationName`, `description` | La Coronel + Patatas + Tira |
| 📂 `categories`, `productType` | PROMOCIONES · `deal` |
| 💶 `priceEur` | 15.37 |
| 🧾 `menuVersion` | changes when the restaurant edits its menu |

Because `productId` is shared across the stores of a chain, you can compare the price of the same product in every store.

### 🚀 How to use Just Eat Spain Scraper

1. Open Just Eat Spain Scraper in Apify Console.
2. Enter postal codes (`28013`) or prefixes (`280` for Madrid, `080` for Barcelona).
3. Optionally pick chains. Only those restaurants are kept and their menus are read.
4. Click **Start**. Madrid's 63 postal codes take about a minute for the listing; each menu takes about one second.
5. Download the dataset as JSON, CSV or Excel, and read the `SUMMARY` record for per-postal-code status.

### ⚙️ Input parameters

| Parameter | Type | Description |
|---|---|---|
| `postalCodes` | array | 5-digit postal codes |
| `postalCodePrefixes` | array | Every postal code starting with these digits |
| `chains` | array | Keep only these chains and read their menus |
| `uniqueNames` | array | Read these restaurants' menus directly |
| `fetchMenus` | boolean | Default: on when chains or slugs are given |
| `emitAllStores` | boolean | With a chain filter, still emit every restaurant |
| `maxMenus` | integer | Cap for tests |
| `requestIntervalSecs` | number | Pacing, default 1 s |

### 📦 Output example

```json
{
  "recordType": "product",
  "uid": "justeat:product:17230:11b5faca-6393-50e8-96d1-9ae771999672",
  "snapshotDate": "2026-11-15",
  "restaurantId": "17230",
  "restaurantName": "KFC Atocha",
  "chain": "kfc",
  "productName": "La Coronel + Patatas + Tira",
  "categories": ["PROMOCIONES"],
  "productType": "deal",
  "priceEur": 15.37
}
```

### 💰 How much does it cost to scrape Just Eat Spain?

Just Eat Spain Scraper uses **pay-per-event pricing**: you pay per result, and compute and proxy traffic are included.

| Event | Price |
|---|---|
| Actor start | $0.005 per run |
| Result (restaurant or product record) | **$1.50 per 1,000** (Free plan) · $1.35 Bronze · $1.20 Silver · $1.00 Gold and above |

Examples: the 3,820 restaurants delivering in Madrid cost about $5.70; adding the menus of five chains (~21,000 products) adds about $31. Set **Max cost per run** in the run options to cap any run.

Timing, measured on 2026-11-15:

- Madrid listing (63 postal codes, 3,820 restaurants): about 65 seconds and 26 MB.
- Menus of 174 chain restaurants in Madrid (about 21,000 products): about 3 minutes and 52 MB.

A city with a few chains is a run of minutes on the smallest memory setting.

### 🔗 Related Actors

- [Glovo Scraper Spain](https://apify.com/rastriq/glovo-spain-scraper) — the same chains on Glovo, with the price of each product per store.
- [Restaurant Chain Locations Spain](https://apify.com/rastriq/spain-restaurant-chain-locations) — the official store network of 25 chains. KFC publishes each store's Just Eat link, which joins exactly with `uniqueName`.
- [Spain Franchise Database](https://apify.com/rastriq/spain-franchise-database) — franchise terms of the same brands.
- [Spain Trademark Monitor](https://apify.com/rastriq/spain-trademark-monitor) — new restaurant brands filed at the OEPM.

### ❓ FAQ

**Is it legal to scrape Just Eat?** The scraper reads public pages that any visitor sees, at a polite pace (one request per second), without login. It collects business data only: no customer reviews, names or phone numbers. Check Just Eat's terms of use for your use case.

**Why do neighbouring postal codes return the same restaurants?** A listing includes every restaurant that delivers to that code. The scraper merges them; `seenInPostalCodes` tells you where each one appeared.

**Why do some products have `priceEur: null`?** Just Eat shows them at 0 € because the price comes from the options you pick. Combo components that can't be bought on their own are not emitted.

**What if a postal code returns nothing?** Just Eat answers an unknown code with an empty page. The run reports that code as failed in `SUMMARY` instead of treating it as "no restaurants".

***

### 🇪🇸 Versión en español

#### ¿Qué es Just Eat Spain Scraper?

Extrae de Just Eat España todos los restaurantes de los códigos postales que elijas, con su valoración, ofertas, coste de envío, pedido mínimo y tiempo de entrega. Para las cadenas que indiques, lee además la carta completa con el precio de cada producto.

#### ¿Qué datos extrae?

Un registro de local (id, nombre, cadena, dirección, valoración, ofertas, envío) y un registro de producto (id, nombre, categorías, precio). El id de producto es común a los locales de una cadena, así que permite comparar precios entre locales.

#### ¿Cómo se usa?

Indica códigos postales o prefijos (`280` = Madrid), elige cadenas si quieres las cartas y pulsa **Start**.

#### ¿Cuánto cuesta?

Pago por resultado: 1,50 $ por cada 1.000 registros (restaurante o producto) en el plan Free, menos en los planes superiores, y 0,005 $ por ejecución. El listado de Madrid tarda en torno a un minuto y cada carta en torno a un segundo.

# Changelog

This Actor's version history is a separate document: https://apify.com/rastriq/just-eat-spain-scraper/changelog.md

# Actor input Schema

## `postalCodes` (type: `array`):

5-digit postal codes. The listing of a code includes every restaurant delivering there, so neighbouring codes overlap.

## `postalCodePrefixes` (type: `array`):

Every postal code starting with these digits (GeoNames table): 280 = Madrid municipality, 080 = Barcelona. Codes Just Eat does not know answer with 0 restaurants and are reported as failed in SUMMARY.

## `chains` (type: `array`):

Keep only these chains (matched by name) and read their menus. Empty = all restaurants, no menus unless 'Read menus' is on.

## `uniqueNames` (type: `array`):

Read these menus directly, e.g. kfcatocha (from https://www.just-eat.es/restaurants-kfcatocha). Useful with the Just Eat links that chain locators publish.

## `fetchMenus` (type: `boolean`):

Default: on when chains or slugs are given, off otherwise. With no chain filter it reads every listed restaurant's menu (thousands of pages for a city).

## `emitAllStores` (type: `boolean`):

With a chain filter, still emit every listed restaurant (menus only for the chains).

## `maxMenus` (type: `integer`):

Cap on menus read. 0 or empty = no cap.

## `requestIntervalSecs` (type: `number`):

Polite pacing to just-eat.es. 1 s measured without any 429 (2026-11-15).

## `egressMode` (type: `string`):

Used when no proxy is set below. Just Eat answered from an Apify datacenter IP (2026-11-15); if Cloudflare starts blocking, the actor switches to its secret JUSTEAT_PROXY_URL.

## `proxyConfiguration` (type: `object`):

Optional. Your own proxy replaces the actor's built-in egress (direct first, residential proxy in Spain on a block, included in the price).

## Actor input object example

```json
{
  "postalCodes": [
    "28013"
  ],
  "emitAllStores": false,
  "requestIntervalSecs": 1,
  "egressMode": "auto"
}
```

# Actor output Schema

## `records` (type: `string`):

Stores and products.

## `summary` (type: `string`):

Per postal code and per menu status, volumes and timings.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "postalCodes": [
        "28013"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("rastriq/just-eat-spain-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "postalCodes": ["28013"] }

# Run the Actor and wait for it to finish
run = client.actor("rastriq/just-eat-spain-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "postalCodes": [
    "28013"
  ]
}' |
apify call rastriq/just-eat-spain-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rastriq/just-eat-spain-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/KZeUYRoHX05A1a0Vg/builds/BLv7Op8afOkexYVkQ/openapi.json
