# Restaurant Chain Locations Spain — Openings Tracker (`rastriq/spain-restaurant-chain-locations`) Actor

Every store of 25 restaurant chains in Spain (Burger King, McDonald's, Telepizza, Domino's, KFC, Goiko…) from their official store locators, with coordinates, operator company and openings, changes and closures between runs.

- **URL**: https://apify.com/rastriq/spain-restaurant-chain-locations.md
- **Developed by:** [Rastriq — Structured data from the world](https://apify.com/rastriq) (community)
- **Categories:** Business, Real estate, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.80 / 1,000 stores

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

## Restaurant Chain Locations Spain — Store Locator Data & Openings Tracker

Get **every store of the main restaurant chains in Spain**, straight from each brand's official
store locator, in one clean format. Run it on a schedule and it tells you **which stores opened,
changed or closed** since the previous run.

Built for franchise development, retail real estate, competitive intelligence and delivery
analytics teams who need the real network of a chain, not a stale list.

### What you get

**25 chains**, about **5,050 stores**:

| Chain | Stores (Nov 2026) | Extra data |
|---|---:|---|
| Burger King | 991 | Franchise group per store, drive-thru, delivery, dark kitchens |
| McDonald's | 674 | **Operating company (CIF + legal name)**, company-operated vs franchise |
| Telepizza | 646 | Opening hours |
| Domino's Pizza | 409 | **Operating company (CIF + legal name)**, master franchisee vs franchisee |
| KFC | 312 | **Google rating and review count**, services, delivery links |
| La Tagliatella | 214 | Services, terrace, online booking |
| Foster's Hollywood | 202 | Store page and booking link |
| Santagloria | 200 | Store page |
| Popeyes | 196 | Franchise group per store |
| Starbucks | 190 | Mobile order |
| VIPS | 175 | Store page and booking link |
| Goiko | 114 | **Glovo / Uber Eats link per store** |
| Ginos | 114 | Store page and booking link |
| Papa John's | 96 | Pick-up hours per day |
| Pizzerías Carlos | 93 | **Operating company (CIF + legal name)**, company-operated vs franchise |
| Sibuya Urban Sushi Bar | 74 | Booking page |
| Manolo Bakes | 68 | Opening hours, delivery flag |
| Udon | 67 | Services (booking, terrace) |
| Subway | 51 | Weekly opening hours |
| Five Guys | 44 | Opening hours |
| Häagen-Dazs | 35 | Weekly opening hours, delivery / take-out / dine-in |
| Muerde la Pasta | 30 | Terrace, parking, TheFork booking link |
| Taberna del Volapié | 25 | Tavern page |
| Tony Roma's | 20 | Address with postal code (no coordinates published) |
| Pizza Hut | 14 | Store page |

Every store comes with: durable id, name, address, postal code, city, **province (INE code)**,
coordinates, phone, normalised services, source URL and extraction date.

### Openings, changes and closures

With **Track changes** on (default), each store is compared with the previous run of the same
stream:

| `_delta_status` | Meaning |
|---|---|
| `new` | Not in the previous run: a new opening (or `_reopened: true` if it had closed) |
| `updated` | Address, coordinates, phone, services or operator changed. `_changed_fields` and `_previous_values` say what |
| `unchanged` | Same as last time (only in *Full network* output) |
| `removed` | Gone from the brand's locator: a closure. Carries the last known data and `_removed_at` |

The first run of a stream is a **baseline**: every store comes as `new` with `_baseline: true`.

**No false closures.** A closure is only reported when the brand's sweep is trustworthy: it
succeeded, returned a normal number of stores, and returned at least 80 % of the previous run
(configurable). Otherwise the run says why in `SUMMARY` and keeps the previous stores.

### Google Maps check

The chain's locator says which stores the brand lists; Google Maps says whether a store is open.
With **Check stores on Google Maps** (default: changes only), each selected store gets a
`googleMaps` object with its status (`operational`, `temporarily_closed`, `permanently_closed`
or `not_found`), place id, link, rating and review count.

Stores reported as `removed` also get `_closure_check`:

- `confirmed`: Google says permanently closed;
- `temporary`: temporarily closed;
- `contradicted`: Google says it is still operating. The brand probably just unpublished it;
- `unverified`: no confident match.

Lookups use the Rastriq Google Maps actor and are capped per run (default 300 stores, closures
first).

### Input example

```json
{
  "brands": ["burger_king", "mcdonalds", "dominos"],
  "trackChanges": true,
  "outputMode": "delta"
}
```

Leave `brands` empty to sweep all 25. Use `outputMode: "full"` for the whole network with each
store's status, or `"delta"` for openings, changes and closures only.

### Output example

```json
{
  "uid": "dominos:34760",
  "brand": "dominos",
  "brandName": "Domino's Pizza",
  "storeId": "34760",
  "name": "Domino's ATOCHA",
  "address": "Calle Atocha 64",
  "postalCode": "28012",
  "city": "Madrid",
  "provinceCode": "28",
  "province": "Madrid",
  "countryCode": "ES",
  "latitude": 40.411792,
  "longitude": -3.698063,
  "services": ["delivery", "takeaway"],
  "operatorTaxId": "D01160076",
  "operatorName": "GRUPO ZENA PIZZA S.com.pA",
  "ownership": "company",
  "deliveryLinks": [],
  "sourcePlatform": "dominos-golo",
  "scrapedAt": "2026-11-14T18:00:00+00:00",
  "qualityFlags": [],
  "_delta_status": "new"
}
```

### Run summary

Each run writes `SUMMARY` to its key-value store: per brand, how many stores were fetched, how
many are new / updated / unchanged / removed, whether closures were checked (and why not), and
any brand that failed. A failing brand never stops the others.

### Good to know

- **Proxies**: VIPS, Foster's Hollywood, Ginos and Telepizza block datacenter IPs and use Apify
  RESIDENTIAL proxies (Spain) automatically. All other chains are fetched directly.
- **Duration**: a few minutes for all chains. Starbucks alone takes ~8 minutes, because its
  locator returns 50 stores per call and rate-limits hard.
- **Privacy**: operator tax ids are output only for companies. If a store were operated by a
  natural person, the id and name are withheld.
- **Quality flags**: some brands publish stores without a postal code. The province is then
  inferred from the coordinates and the record is flagged `province_from_coordinates`.

### How much does it cost?

This actor uses **pay-per-event pricing**: compute and residential proxy traffic are included.

| Event | Price |
|---|---|
| Actor start | $0.02 per run |
| Store record | **$4 per 1,000** (Free plan) · $3.60 Bronze · $3.20 Silver · $2.80 Gold and above |

The full network of all 25 chains (~5,050 stores) costs about $20. A weekly run in **Changes only**
mode returns just the openings, changes and closures, usually a few dozen records: well under $1.
Google Maps checks are billed separately by the [Google Maps actor](https://apify.com/rastriq/gmaps-discover-enrich)
(about $2 per 1,000 places, capped at 300 per run by default; set it to `none` to skip them).

### FAQ

**How often should I run it?** Weekly is enough to catch openings and closures. Schedule it with the
same **Stream id** so each run compares with the previous one.

**Is this data public?** Yes: every store comes from the brand's own public store locator.
Operator tax ids are output only for companies, never for individuals.

**A chain I need is missing.** Open an issue on the actor page with the chain's locator URL.

### Related actors

- [Glovo Scraper Spain](https://apify.com/rastriq/glovo-spain-scraper) — the same chains on Glovo: delivery fee, rating and menu price per store.
- [Just Eat Scraper Spain](https://apify.com/rastriq/just-eat-spain-scraper) — every restaurant by postal code, with menus.
- [Spain Franchise Database](https://apify.com/rastriq/spain-franchise-database) — investment, royalty and network size of franchise brands.
- [Spain Trademark Monitor](https://apify.com/rastriq/spain-trademark-monitor) — new restaurant brands filed at the OEPM, before they open.

***

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

**Restaurant Chain Locations Spain** extrae todos los locales de 25 cadenas de restauración en
España (Burger King, McDonald's, Telepizza, Domino's, KFC, La Tagliatella, Goiko…) desde el
localizador oficial de cada marca: dirección, código postal, provincia INE, coordenadas, teléfono,
servicios y, en McDonald's, Domino's y Pizzerías Carlos, la sociedad que opera cada local.

Programado, detecta **aperturas, cambios y cierres** entre ejecuciones, sin falsos cierres, y puede
contrastar cada cierre con Google Maps.

Precio: 4 $ por cada 1.000 locales en el plan Free (menos en planes superiores) y 0,02 $ por
ejecución. La red completa cuesta unos 20 $; un seguimiento semanal en modo *solo cambios*, menos de 1 $.

# Changelog

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

# Actor input Schema

## `brands` (type: `array`):

Chains to sweep. Empty = all.

## `trackChanges` (type: `boolean`):

Compare each store with the previous run of the same stream and set <code>\_delta_status</code>. The first run of a stream is a baseline: every store comes as <code>new</code> with <code>\_baseline: true</code>.

## `outputMode` (type: `string`):

<b>Full</b> returns every store. <b>Changes only</b> returns just openings, changes and closures; needs change tracking.

## `detectClosures` (type: `boolean`):

Emit stores missing from a complete sweep as <code>removed</code>. Skipped automatically for a brand whose sweep failed, came back short, or was capped.

## `googleMapsCheck` (type: `string`):

Looks each selected store up on Google Maps with the Rastriq Google Maps actor and adds a <code>googleMaps</code> object (status, place id, rating, reviews). For <code>removed</code> stores it adds <code>\_closure_check</code>: <code>confirmed</code>, <code>temporary</code> or <code>contradicted</code> (Google says it is still open: the brand probably just unpublished it). Billed by that actor (about $2 per 1,000 places).

## `googleMapsMaxPlaces` (type: `integer`):

Cap on stores checked per run. Closures go first, then openings, then updates.

## `closureGuardRatio` (type: `number`):

Closures are computed only if the sweep returned at least this share of the previous snapshot. Protects against a partial response reading as mass closures.

## `cursorId` (type: `string`):

Names the change-tracking stream. Runs sharing an id compare against each other; different ids are independent. Empty = <code>default</code>.

## `maxStoresPerBrand` (type: `integer`):

Cap per brand for quick tests. A capped run never updates the snapshot and never reports closures. 0 or empty = no cap.

## `starbucksIntervalSecs` (type: `number`):

Starbucks rate-limits hard below one call every ~3 s (measured). The sweep takes ~130 calls.

## `maxConcurrency` (type: `integer`):

How many brands are swept at the same time.

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

Used only for VIPS, Foster's Hollywood, Ginos and Telepizza, which block datacenter IPs. Empty = Apify RESIDENTIAL (ES). Other brands always go direct.

## Actor input object example

```json
{
  "brands": [
    "burger_king",
    "mcdonalds",
    "dominos"
  ],
  "trackChanges": true,
  "outputMode": "full",
  "detectClosures": true,
  "googleMapsCheck": "changes",
  "googleMapsMaxPlaces": 300,
  "closureGuardRatio": 0.8,
  "starbucksIntervalSecs": 3,
  "maxConcurrency": 4,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "ES"
  }
}
```

# Actor output Schema

## `stores` (type: `string`):

All stores emitted by the run.

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

Per-brand counts, failures and closure checks.

# 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 = {
    "brands": [
        "burger_king",
        "mcdonalds",
        "dominos"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "ES"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("rastriq/spain-restaurant-chain-locations").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 = {
    "brands": [
        "burger_king",
        "mcdonalds",
        "dominos",
    ],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "ES",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("rastriq/spain-restaurant-chain-locations").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 '{
  "brands": [
    "burger_king",
    "mcdonalds",
    "dominos"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "ES"
  }
}' |
apify call rastriq/spain-restaurant-chain-locations --silent --output-dataset

```

## MCP server setup

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

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/FAkidfGkLvqGCWIwx/builds/BfIBQ8XSvMT3ErRNT/openapi.json
