# Glovo Scraper Spain — Menu Prices, Fees & Stores (`rastriq/glovo-spain-scraper`) Actor

Scrape Glovo Spain: every store of the restaurant chains you choose in Madrid or Barcelona, with delivery fee, service fee, rating, promotions and the price of each menu product per store. No login.

- **URL**: https://apify.com/rastriq/glovo-spain-scraper.md
- **Developed by:** [Rastriq — Structured data from the world](https://apify.com/rastriq) (community)
- **Categories:** E-commerce, 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 store 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

## Glovo Scraper Spain — Menu Prices, Delivery Fees & Stores of Restaurant Chains

**Glovo Spain Scraper** finds every Glovo store of the restaurant chains you choose in Madrid or Barcelona. For each store it returns the address, rating, delivery fee, service fee and promotions, plus the full menu with the price of each product. Glovo prices can differ from one store of a chain to another. In one Burger King sweep of Madrid, 119 of 227 products had more than one price across stores. This scraper measures that difference store by store.

### 🛵 What is Glovo Spain Scraper?

Glovo shows one store per brand for each delivery address, the one it picks for that point. There is no list of a chain's stores. Glovo Spain Scraper sweeps a grid of delivery points over the city, asks which store of the chain serves each point, and keeps every distinct store (`addressId`). Then it reads each store's menu.

- 🗺️ **Adaptive grid**: a coarse pass (2 km) over the whole city, then a fine pass (0.5 km) only where the chain delivers.
- 🏪 **One record per physical store**, with the grid points it serves.
- 💶 **One record per product and store**, with list price, promotional price, stock and option surcharges.
- 🔗 **Chain keys shared with Restaurant Locators Spain**, so you can compare Glovo's stores with the chain's official network.

It uses plain HTTP requests to Glovo's public web API, with no login and no browser. Glovo blocks datacenter IPs after about a minute, so the scraper starts direct and switches to a residential proxy in Spain on the first block.

### 📊 What data does Glovo Spain Scraper extract?

**Store records**

| Field | Example |
|---|---|
| 🆔 `storeId`, `addressId`, `slug` | 323 · 5639 · goiko-madrid |
| 📍 `address`, `postalCode` | Av. del General Perón, 16, 28020 Madrid |
| ⭐ `ratingPct`, `ratingCount` | 94 % · 270 |
| 🚚 `deliveryFeeEur`, `serviceFeeEur` | 1.99 · 1.99 |
| 🎁 `promotions` | PERCENTAGE_DISCOUNT -30 % |
| 🟢 `open`, `gridPointsServed` | true · 12 |

**Product records**

| Field | Example |
|---|---|
| 🆔 `storeProductId`, `externalId` (chain SKU) | 6eaa5482-… · 4343 |
| 🍔 `productName`, `sections` | Menú Kevin Costner · Menús GOIKO |
| 💶 `priceEur`, `promoPriceEur` | 20.90 · — |
| 📦 `outOfStock`, `restricted` | false · false |
| ➕ `modifierGroups`, `maxModifierPriceEur` | 5 · 3.50 |

`externalId` is the chain's own product code, the same in every store, so you can compare one product's price across stores.

### 🚀 How to use Glovo Spain Scraper

1. Open Glovo Spain Scraper in Apify Console.
2. Pick the city (Madrid or Barcelona) and the chains.
3. Keep the default grid (2 km coarse, 0.5 km fine) or make it coarser for a quick look.
4. Click **Start**. Set the run timeout to fit the grid: through the residential proxy each point takes about 1.2 s, so a full Madrid sweep of one chain needs about 50 minutes.
5. Download stores and products from the dataset; `SUMMARY` has the per-chain counters.

### ⚙️ Input parameters

| Parameter | Type | Description |
|---|---|---|
| `cities` | array | MAD, BCN |
| `chains` | array | Chains from the built-in slug table |
| `extraSlugs` | array | More Glovo stores as `CITY:slug` |
| `coarseStepKm`, `fineStepKm` | number | Grid steps (2 and 0.5 km) |
| `fetchMenus`, `maxMenus` | boolean, integer | Menus on/off, cap for tests |
| `requestIntervalSecs`, `menuIntervalSecs` | number | Pacing: 0.5 s and 1.5 s |

### 📦 Output example

```json
{
  "recordType": "product",
  "uid": "glovo:product:5639:6eaa5482-13bf-4473-a417-77bcfa05af22",
  "storeId": 323,
  "addressId": 5639,
  "chain": "goiko",
  "externalId": "4343",
  "productName": "Menú Kevin Costner",
  "sections": ["Menús GOIKO - NEW!"],
  "priceEur": 20.9,
  "promoPriceEur": null,
  "outOfStock": false
}
```

### 💰 How much does it cost to scrape Glovo?

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

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

Examples: one chain's 77 Madrid stores with their menus (~17,000 product records) cost about $25 on the Free plan; stores only (`fetchMenus: false`) cost about $0.13. Set **Max cost per run** in the run options to cap any run.

Timing measured on 2026-11-15 for Burger King in Madrid: 2,308 grid requests in 19 minutes, then 83 menus (16,941 products, 8.5 MB) in about 2 minutes. A coarser fine step (1 km) means fewer requests but can miss stores: in the survey, a full 1 km grid found 71 Burger King stores where 0.5 km found 77.

### 🔗 Related Actors

- [Restaurant Chain Locations Spain](https://apify.com/rastriq/spain-restaurant-chain-locations) — the official store network of 25 chains, with openings and closures (Goiko and KFC publish their Glovo links).
- [Just Eat Scraper Spain](https://apify.com/rastriq/just-eat-spain-scraper) — the same data from Just Eat, by postal code.
- [Spain Franchise Database](https://apify.com/rastriq/spain-franchise-database) — investment, royalty and network size of the same brands.
- [Spain Trademark Monitor](https://apify.com/rastriq/spain-trademark-monitor) — new restaurant brands filed at the OEPM, before they open.

### ❓ FAQ

**Does it find every store of a chain?** Not always. Glovo assigns one store to each point, the one it prefers. A store surrounded by others can stay hidden, and stores that do not sell on Glovo never appear. Use the chain's locator as the network of record. Glovo adds price, assortment, fees and rating.

**Why is the delivery fee different from what I see?** Fees depend on the address. The record keeps the fee at the first grid point that found the store (`foundAtLatitude`/`foundAtLongitude`). That point can change between runs when other stores open or close.

**Is scraping Glovo legal?** The scraper reads public store and menu data at a moderate pace, without login, and collects no personal data: no phone numbers and no reviews. Check Glovo's terms for your use case.

***

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

#### ¿Qué es Glovo Spain Scraper?

Localiza en Glovo los locales de las cadenas que elijas en Madrid o Barcelona, barriendo una rejilla de puntos de entrega. De cada local da la valoración, el envío y las promociones, y de cada producto, el precio en ese local. En Glovo el precio cambia de un local a otro de la misma cadena.

#### ¿Cómo se usa?

Elige la ciudad y las cadenas y pulsa **Start**. Burger King en Madrid tarda unos 19 minutos de barrido y 2 minutos de cartas.

#### ¿Cuánto cuesta?

Pago por resultado: 1,50 $ por cada 1.000 registros (local o producto) en el plan Free, menos en los planes superiores, y 0,01 $ por ejecución. El cómputo y el proxy residencial están incluidos. Puedes fijar un coste máximo por ejecución.

# Changelog

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

# Actor input Schema

## `cities` (type: `array`):

Cities with a verified Glovo city code and bounding box.

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

Chains to sweep, from the built-in slug table. Empty = every chain in the table for the city.

## `extraSlugs` (type: `array`):

More Glovo stores as CITY:slug, e.g. MAD:vips-desayunos-madrid (the slug is in the store URL glovoapp.com/es/es/madrid/{slug}/).

## `coarseStepKm` (type: `number`):

First pass over the whole city.

## `fineStepKm` (type: `number`):

Second pass, only in coarse cells served by the chain or next to one. 0 = coarse only.

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

Read the menu of each store found.

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

0 or empty = all. Prefilled at 1 for a quick sample run; clear it to read every store's menu.

## `maxPointsPerSlug` (type: `integer`):

0 or empty = no cap. A capped sweep is reported as capped. Prefilled at 50 for a quick sample run; clear it for the full city sweep.

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

Pacing to api.glovoapp.com.

## `menuIntervalSecs` (type: `number`):

Menus are throttled separately by Glovo: at 0.5 s, 429 errors started after about 25 menus.

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

Used when no proxy is set below. Glovo blocks datacenter IPs after about a minute, so by default the actor starts direct and switches to its own residential proxy in Spain (included in the price) on the first block.

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

Optional. Your own proxy replaces the actor's built-in residential proxy.

## Actor input object example

```json
{
  "cities": [
    "MAD"
  ],
  "chains": [
    "goiko"
  ],
  "coarseStepKm": 2,
  "fineStepKm": 0.5,
  "fetchMenus": true,
  "maxMenus": 1,
  "maxPointsPerSlug": 50,
  "requestIntervalSecs": 0.5,
  "menuIntervalSecs": 1.5,
  "egressMode": "auto"
}
```

# Actor output Schema

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

Stores and products.

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

Per slug sweep counters, menu status, app version.

# 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 = {
    "cities": [
        "MAD"
    ],
    "chains": [
        "goiko"
    ],
    "maxMenus": 1,
    "maxPointsPerSlug": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("rastriq/glovo-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 = {
    "cities": ["MAD"],
    "chains": ["goiko"],
    "maxMenus": 1,
    "maxPointsPerSlug": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("rastriq/glovo-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 '{
  "cities": [
    "MAD"
  ],
  "chains": [
    "goiko"
  ],
  "maxMenus": 1,
  "maxPointsPerSlug": 50
}' |
apify call rastriq/glovo-spain-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rastriq/glovo-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/scelIciFMekdadpzS/builds/GsMbXeOUJuc3yvmri/openapi.json
