# Spain Empresia Company Scraper (`parseforge/spain-empresia-scraper`) Actor

Lookup Spanish companies on Empresia.es by name search or direct slug. Returns company name, CIF, city, BORME announcement count, related entities, and the company's directors/proxies (apoderados) registry.

- **URL**: https://apify.com/parseforge/spain-empresia-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Business, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.50 / 1,000 spanish company 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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 🇪🇸 Spain Empresia Company Scraper

> 🚀 🇪🇸 **Lookup Spanish companies on Empresia.es.** Pull **3M+ Spanish companies** worth of data with **10 fields per record**. No API key, no manual data entry.

> 🕒 **Last updated:** 2026-05-05 · **📊 10 fields per record** · **🌍 Spain** · **💵 from $0.005 per item (FREE tier)**

The **Spain Empresia Company Scraper** Lookup Spanish companies on Empresia.es by name search or direct slug. Returns company name, CIF (tax ID), city, slug, and the directors/proxies (apoderados) registry per company. The actor opens a company report per query and returns the first matching company.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| Sales teams, compliance officers, researchers, journalists, real-estate analysts, healthcare ops | Spanish sales prospecting, EU compliance & due diligence, Recruiting & talent intelligence, Investigative journalism |

---

### 📋 What the Spain Empresia Company Scraper does

Highlights of every record returned:

- 🏢 **Company identity.** name, CIF tax ID, city, Empresia URL.
- 👥 **Directors & proxies (apoderados).** name, role (Apod. Solid./Mancom., Administrador, etc.) per officer.
- 🔍 **Name or slug input.** Accepts both human-readable names ('banco santander') and Empresia direct slugs ('banco-santander').
- 🇪🇸 **Spain-wide coverage.** Includes companies across all 17 autonomous communities.

> 💡 **Why it matters:** verified, structured data delivered in seconds beats hand-curated spreadsheets that go stale within days. Run this Actor on a schedule and your downstream pipeline always has fresh records.

---

### 🎬 Full Demo

_🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded Spain Empresia Company Scraper dataset._

---

### ⚙️ Input

<table>
<thead><tr><th>Input</th><th>Type</th><th>Default</th><th>Behavior</th></tr></thead>
<tbody>
<tr><td><code>queries</code></td><td>array of strings</td><td><code>required</code></td><td>Search terms (company names) or Empresia direct slugs.</td></tr>
<tr><td><code>maxItems</code></td><td>integer</td><td><code>10</code></td><td>Records to return. Free: max 10. Paid: up to 1,000,000.</td></tr>
</tbody>
</table>

**Example input:**

```json
{
    "queries": ["banco-santander", "telefonica", "iberdrola"],
    "maxItems": 50
}
````

***

### 📊 Output

Each record contains **10 fields**. Download the dataset as CSV, Excel, JSON, or XML.

#### 🧾 Top fields

- `query`
- `name`
- `cif`
- `city`
- `slug`
- `url`
- `directors`
- `directorsCount`

***

### ✨ Why choose this Actor

- 🛠️ **No infrastructure** to maintain. The Apify cloud handles scheduling, retries, proxies, and storage.
- 🌍 **Verified source data.** Records come from authoritative public sources, not third-party aggregators.
- 🔁 **Repeatable runs.** Schedule monthly, weekly, or hourly to keep your pipeline always fresh.
- 📊 **Multiple export formats.** CSV, Excel, JSON, XML out of the box.
- 💵 **Pay only for what you use.** Pay-per-result-item pricing, free preview included.

***

### 💼 Business use cases

#### 📊 Spanish sales prospecting

Enrich Spanish leads with verified CIF, city, and director rosters before outreach.

#### 💼 EU compliance & due diligence

Validate Spanish counterparties' registration and director list before contracting.

#### 🤝 Recruiting & talent intelligence

Map directors and apoderados across competitors for executive-search outreach.

#### 🔍 Investigative journalism

Trace director overlap and corporate structures across thousands of Spanish companies.

***

### 📈 How it compares to alternatives

| Approach | Cost | Coverage | Refresh | Filters | Setup |
|---|---|---|---|---|---|
| **⭐ Spain Empresia Company Scraper** *(this Actor)* | $5 free credit, then pay-per-use | Full source coverage | **Live per run** | Source-native filters supported | ⚡ 2 min |
| Build your own scraper | Engineering hours | Full once built | Whenever you maintain it | Custom code | 🐢 Days to weeks |
| Paid managed APIs | $$$ monthly | Vendor-defined | Live | Vendor-defined | ⏳ Hours |
| Third-party data dumps | Varies | Subset, often stale | Periodic | None | 🕒 Variable |

Pick this Actor when you want broad coverage, server-side filtering, and no pipeline maintenance.

***

### 🚀 How to use

1. [Create a free account](https://console.apify.com/sign-up?fpr=vmoqkp) on Apify (includes $5 in free credit).
2. Open the **Spain Empresia Company Scraper** Actor page.
3. Fill out the input form and click **Start**.
4. Download your dataset in CSV, Excel, JSON, or XML.

***

### 🌟 Beyond business use cases

#### 🎓 Research and academia

Economists studying the Spanish corporate landscape can dataset directors-and-proxies relationships at scale.

#### 🎨 Personal and creative

Genealogy researchers can trace family-business networks via the apoderados registry.

#### 🤝 Non-profit and civic

Anti-corruption groups can audit suppliers and contracting parties for director-level conflicts.

#### 🧪 Experimentation

Data scientists can use Spanish company records for entity-resolution and Spanish NLP benchmarks.

***

### 🤖 Ask an AI assistant about this scraper

Open a ready-to-send prompt about this ParseForge actor in the AI of your choice:

- 💬 [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20%F0%9F%87%AA%F0%9F%87%B8%20Spain%20Empresia%20Company%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20%F0%9F%87%AA%F0%9F%87%B8%20Spain%20Empresia%20Company%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🔍 [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20%F0%9F%87%AA%F0%9F%87%B8%20Spain%20Empresia%20Company%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)
- 🅒 [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20%F0%9F%87%AA%F0%9F%87%B8%20Spain%20Empresia%20Company%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.)

***

### ❓ Frequently Asked Questions

#### Where does the data come from?

From `empresia.es`, a Spanish business directory that aggregates BORME (Boletín Oficial del Registro Mercantil) announcements and Mercantile Registry data.

#### Why use slug input vs name?

Slugs are deterministic (one slug = one company); names may match multiple companies. The actor returns the first match either way, so slugs give the most predictable result.

#### Are financial statements included?

No. Empresia exposes the company identity, registry status, and director list. Audited financials require separate Mercantile Registry purchase.

#### Can I search by CIF?

Empresia's URL pattern is name-based, not CIF-based. To find by CIF, use a separate CIF lookup service first to get the company name slug.

#### How fresh is the data?

Empresia syncs nightly from BORME and the Mercantile Registry.

***

### 🔌 Integrate with any app

Connect this Actor to your stack via the [Apify integrations](https://docs.apify.com/platform/integrations) catalog:

- 📊 **Make / Zapier / n8n**  -  trigger scrapes from any business workflow.
- 💬 **Slack / Discord**  -  get a notification when a run finishes.
- 📁 **Google Drive / Google Sheets**  -  push the dataset directly into a spreadsheet.
- 📨 **Gmail / Mailchimp / HubSpot**  -  automate outreach with the scraped leads.
- 🔌 **Apify CLI / SDK**  -  programmatic control from Python, Node.js, or any HTTP client.
- ⚡ **Webhooks**  -  POST run results to any endpoint when complete.

***

### 🔗 Recommended Actors

- 🔧 [**FINRA BrokerCheck Scraper**](https://apify.com/parseforge/finra-brokercheck-scraper)
- 🔧 [**UK Companies House Scraper**](https://apify.com/parseforge/uk-companies-house-scraper)
- 🔧 [**SEC EDGAR Full-Text Search**](https://apify.com/parseforge/sec-edgar-full-text-search-scraper)
- 🔧 [**Crunchbase Scraper**](https://apify.com/parseforge/crunchbase-scraper)
- 🔧 [**OpenSecrets Scraper**](https://apify.com/parseforge/opensecrets-scraper)

***

> **Disclaimer:** This Actor scrapes only publicly accessible data. We do not collect personal information beyond what is voluntarily published by the source. Do not use the data for unauthorized contact, spam, or any purpose violating applicable laws or the source site's Terms of Service. Respect [GDPR](https://gdpr.eu/), [CCPA](https://oag.ca.gov/privacy/ccpa), and applicable consumer-protection laws. ParseForge is not affiliated with any source site.

***

**🆘 Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue.

# Actor input Schema

## `queries` (type: `array`):

List of company name search terms (e.g., 'banco santander') or Empresia direct slugs (e.g., 'banco-santander'). The actor opens a company report per query, returning the FIRST matching company.

## `maxItems` (type: `integer`):

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

## Actor input object example

```json
{
  "queries": [
    "banco-santander",
    "telefonica",
    "iberdrola"
  ],
  "maxItems": 10
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 = {
    "queries": [
        "banco-santander",
        "telefonica",
        "iberdrola"
    ],
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/spain-empresia-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 = {
    "queries": [
        "banco-santander",
        "telefonica",
        "iberdrola",
    ],
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/spain-empresia-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 '{
  "queries": [
    "banco-santander",
    "telefonica",
    "iberdrola"
  ],
  "maxItems": 10
}' |
apify call parseforge/spain-empresia-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/spain-empresia-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Spain Empresia Company Scraper",
        "description": "Lookup Spanish companies on Empresia.es by name search or direct slug. Returns company name, CIF, city, BORME announcement count, related entities, and the company's directors/proxies (apoderados) registry.",
        "version": "1.0",
        "x-build-id": "fS5PiQsuQtR65bKEB"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~spain-empresia-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-spain-empresia-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/parseforge~spain-empresia-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-spain-empresia-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/parseforge~spain-empresia-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-spain-empresia-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": [
                    "queries"
                ],
                "properties": {
                    "queries": {
                        "title": "Search Queries or Slugs",
                        "type": "array",
                        "description": "List of company name search terms (e.g., 'banco santander') or Empresia direct slugs (e.g., 'banco-santander'). The actor opens a company report per query, returning the FIRST matching company.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```