# Spain Franchise Database — Investment & Royalty (`rastriq/spain-franchise-database`) Actor

Franchise terms of ~6,000 brands from five Spanish franchise directories: investment, entry fee, royalty, advertising fee, contract length, own vs franchised stores and franchisor company. All sectors or hospitality only.

- **URL**: https://apify.com/rastriq/spain-franchise-database.md
- **Developed by:** [Rastriq — Structured data from the world](https://apify.com/rastriq) (community)
- **Categories:** 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 franchise records

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

## Spain Franchise Database — Investment, Entry Fee, Royalty & Network Data

Franchise terms of **every franchise brand listed in five Spanish franchise directories**, all
sectors: how much it costs to open one, what royalty it charges, how long the contract runs, how
many stores the brand has and which company is behind it. You can also limit it to **hospitality
and restaurants**.

For franchisors benchmarking their offer, franchise consultants, investors and anyone comparing
franchises in Spain.

### What you get

About **9,300 records, roughly 6,000 distinct brands** with every sector (November 2026):

| Directory | Records | Best for |
|---|---:|---|
| Infofranquicias | ~4,900 | Widest coverage (212 subsectors), own vs franchised stores, minimum population |
| Franquicias Hoy | ~1,880 | Total stores, advertising fee |
| Topfranquicias | ~1,080 | Own vs franchised stores, founding year, franchisor company |
| Mundofranquicia | ~790 | Investment and contract terms, network in Spain, last-update date |
| franquicias.es | ~670 | Own vs franchised stores in Spain, franchising since |

With `scope` = `hosteleria`, about 1,900 records of hospitality and restaurant brands.

Each record has, when the directory publishes it:

- **investment**, **entry fee**, **royalty** and **advertising fee**, each as the published text and
  as a number (€ or %);
- **contract length** in years, **minimum premises** in m², **minimum population**;
- **stores**: own, franchised and total (as declared by the brand);
- **founding year**, **franchising since**, **country of origin**;
- **franchisor company** and its city, only when it is a company (S.L., S.A., …);
- optionally, **contact data** (see below);
- directory, sectors and subsectors, source URL, extraction date, and every mapped field as text
  (`rawFields`) for audit.

### One record per directory

The same brand can appear in several directories with different figures: each directory
refreshes its pages at its own pace. Records are **not merged**. Use `brandKey` (lower-case
alphanumeric name) to join them and pick the source you trust per field. Names are not always
written the same way ("Häagen-Dazs" / "Haagen Dazs Busca franquiciado en Madrid"), so an exact
`brandKey` join under-counts the overlap.

### Input example

```json
{ "scope": "hosteleria", "sources": ["topfranquicias", "franquiciashoy"], "includeContactData": false }
```

Leave `sources` empty to read all five. Every sector is about 9,300 brand pages and takes over an
hour at the default pacing (Infofranquicias alone is ~4,900 pages); hospitality only is about a
fifth of that. `maxBrandsPerSource` caps each directory for a quick test.

### Output example

```json
{
  "uid": "franquiciashoy:asiaticos/ramen-kagura",
  "source": "franquiciashoy",
  "brandName": "Ramen Kagura",
  "brandKey": "ramenkagura",
  "subsectors": ["asiaticos"],
  "investmentText": "Desde 250.000 €",
  "investmentMinEur": 250000,
  "entryFeeEur": 20000,
  "royaltyText": "5% sobre facturación",
  "royaltyPct": 5,
  "advertisingFeePct": 2,
  "contractYears": 7,
  "storesTotal": 17,
  "minSurfaceM2": 150,
  "foundedYear": 2014,
  "originCountry": "España",
  "qualityFlags": []
}
```

### Contact data (opt-in)

Tick **Include contact data** (`"includeContactData": true`) to add what each directory shows
openly on the brand page:

| Field | From |
|---|---|
| `contactPerson` (a person or a department) | Topfranquicias, Infofranquicias |
| `contactAddress` (head office) | Topfranquicias, Infofranquicias |
| `contactEmail` | franquicias.es |
| `contactPhone` | when a directory shows one openly (none of the five did in November 2026) |

It also outputs the franchisor's name, city and postal code when it is not a company. Nothing
behind a contact form is requested, so Mundofranquicia and Franquicias Hoy add nothing here.

These are **personal data under the GDPR**. You need a lawful basis to store and use them (for
example legitimate interest for B2B prospecting), you must inform the people concerned and honour
objections and deletion requests. Off by default, the fields are present and `null`.

### Good to know

- **Some listings are old.** Infofranquicias keeps pages of brands that stopped franchising ("Esta
  marca dejó de franquiciar") and directories carry ads for single units ("X busca franquiciado
  en Sevilla"). Check `sourceUpdatedAt` where the directory gives it.
- **Figures are declared by the brands.** Store counts are what the brand tells the directory;
  some brands declare their worldwide network, not Spain's.
- **Privacy by default**: contact persons, phones, e-mails and street addresses are not output. A
  franchisor name without a corporate form could be an individual, so it is withheld and the
  record is flagged `company_withheld_not_legal_entity`.
- **Run summary**: `SUMMARY` in the key-value store gives, per directory, brands listed, records
  emitted and detail pages that failed. A failing page is skipped and counted; a failing directory
  never stops the others.

### How much does it cost?

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

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

All sectors from the five directories (~9,300 records) cost about $37; hospitality only (~1,900
records) about $7.60. Use `maxBrandsPerSource` for a cheap test and **Max cost per run** to cap a run.

### FAQ

**Why are there more records than brands?** One record per directory: a brand listed in three
directories gives three records. Join them with `brandKey`.

**Are the figures official?** They are what each brand declares to the directory. Keep `source`
and `sourceUrl` to cite them.

**Can I get contact data?** Only with **Include contact data** on, and only what the directory shows
openly. You need a lawful basis under the GDPR to use it.

### Related actors

- [Restaurant Chain Locations Spain](https://apify.com/rastriq/spain-restaurant-chain-locations) — the real store network of 25 restaurant chains, with openings and closures.
- [Spain Trademark Monitor](https://apify.com/rastriq/spain-trademark-monitor) — new brands filed at the OEPM, by Nice class.
- [Glovo Scraper Spain](https://apify.com/rastriq/glovo-spain-scraper) and [Just Eat Scraper Spain](https://apify.com/rastriq/just-eat-spain-scraper) — delivery fees and menu prices per store.

***

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

**Spain Franchise Database** extrae las condiciones de todas las franquicias de cinco directorios
españoles (Infofranquicias, Franquicias Hoy, Topfranquicias, Mundofranquicia y franquicias.es):
inversión, canon de entrada, royalty, canon de publicidad, duración del contrato, local y población
mínimos, número de locales propios y franquiciados, año de fundación y empresa franquiciadora.
Todos los sectores o solo hostelería y restauración.

Unos 9.300 registros y 6.000 marcas. Un registro por directorio; únelos con `brandKey`.

Precio: 4 $ por cada 1.000 registros en el plan Free (menos en planes superiores) y 0,01 $ por
ejecución. Todos los sectores, unos 37 $; solo hostelería, unos 7,60 $. Los datos de contacto son
opcionales y están desactivados por defecto (RGPD).

# Changelog

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

# Actor input Schema

## `scope` (type: `string`):

Every sector each directory lists, discovered from its home page, or only hospitality & restaurants.

## `sources` (type: `array`):

Empty = all five. Prefilled with one directory for a quick sample run; clear it to cover all five.

## `maxBrandsPerSource` (type: `integer`):

Cap per directory for quick tests. 0 or empty = all. Prefilled at 10 for a quick sample run; clear it for the full database.

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

Polite pacing; the directories are read in parallel.

## `includeContactData` (type: `boolean`):

Adds what each directory shows openly on the brand page: contact person, phone, e-mail and head-office address (Topfranquicias, Infofranquicias, franquicias.es), and the franchisor's name, city and postal code even when it is not a company. Nothing behind a contact form is requested. These are personal data under the GDPR: you need a lawful basis to store and use them (for example, legitimate interest for B2B contact), and you must honour objections and deletion requests.

## Actor input object example

```json
{
  "scope": "all",
  "sources": [
    "infofranquicias"
  ],
  "maxBrandsPerSource": 10,
  "requestIntervalSecs": 0.5,
  "includeContactData": false
}
```

# Actor output Schema

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

All brand records.

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

Per-directory counts and errors.

# 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 = {
    "sources": [
        "infofranquicias"
    ],
    "maxBrandsPerSource": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("rastriq/spain-franchise-database").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 = {
    "sources": ["infofranquicias"],
    "maxBrandsPerSource": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("rastriq/spain-franchise-database").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 '{
  "sources": [
    "infofranquicias"
  ],
  "maxBrandsPerSource": 10
}' |
apify call rastriq/spain-franchise-database --silent --output-dataset

```

## MCP server setup

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

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/rT9HDsNb3EHfoOmQ1/builds/amKXomAeKHGT5eMMi/openapi.json
