# Spain Company Directory Scraper (`automation-lab/spain-company-directory-scraper`) Actor πŸ‡ͺπŸ‡Έ Scrape public Spanish company records from Empresite directories, rankings, provinces, activities, and profile pages for B2B leads. - **URL**: https://apify.com/automation-lab/spain-company-directory-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Lead generation - **Stats:** 4 total users, 1 monthly users, 93.5% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Spain Company Directory Scraper Extract structured Spanish company records from public Empresite directory pages, rankings, provinces, activities, and company profiles. Use it to build lead lists, map Spanish markets, enrich vendor files, and monitor public company directory changes without copying rows by hand. --- ### What does Spain Company Directory Scraper do? Spain Company Directory Scraper turns Empresite pages into clean dataset rows. It can start from ranking pages, latest-business pages, province directories, activity directories, or direct company profile URLs. The actor follows public company links, optionally opens profile pages, and saves one row per company. Typical records include company name, company URL, CIF/NIF when visible, activity, CNAE, address, locality, province, phone, website, executives, ranking position, source URL, and scrape timestamp. --- ### Who is it for? - 🧲 B2B sales teams building Spanish lead lists - 🧾 KYB and vendor-enrichment teams checking public company details - πŸ—ΊοΈ Market researchers mapping companies by province or activity - πŸ§‘β€πŸ’Ό Recruiters researching employers in a Spanish city or sector - 🏒 Agencies preparing prospecting files for Spanish campaigns - πŸ“Š Analysts monitoring newly listed or high-ranking Spanish businesses --- ### Why use this actor? Manual directory browsing is slow and inconsistent. This actor gives you repeatable exports from a public source. You can run the same province or activity every week, export to CSV, and compare new or changed rows. It also keeps the original source URL for auditability. --- ### Data you can extract | Field | Description | | --- | --- | | `companyName` | Public company name shown by Empresite | | `detailUrl` | Empresite company profile URL | | `cif` | CIF/NIF when visible on the profile | | `status` | Public status text when visible | | `legalForm` | Legal form or company type when visible | | `activity` | Activity, business object, or sector text | | `cnae` | CNAE classification when visible | | `address` | Public address text when visible | | `locality` | City/locality from listing or detail page | | `province` | Spanish province from listing or detail page | | `phone` | Public phone when visible | | `website` | Public company website when visible | | `executives` | Public executive/contact names when visible | | `rank` | Ranking/list row position when available | | `updatedAt` | Empresite update date when shown | | `sourceUrl` | Page where the company was discovered | | `scrapedAt` | ISO timestamp of extraction | --- ### How much does it cost to scrape Spanish company directory data? The actor uses pay-per-event pricing. There is a small start charge and then a per-company result charge. You control cost with `maxItems`, `maxPagesPerStartUrl`, and whether `includeDetails` is enabled. For cheapest discovery runs, set `includeDetails` to `false` and scrape listing rows only. For richer enrichment runs, keep `includeDetails` enabled. --- ### Quick start 1. Open the actor on Apify. 2. Paste one or more Empresite URLs. 3. Set `maxItems` to a safe first-run number such as 100. 4. Keep Apify Proxy enabled. 5. Run the actor. 6. Download results as CSV, Excel, JSON, or via API. --- ### Supported source URLs You can use URLs such as: - `https://empresite.eleconomista.es/Top_Empresas` - `https://empresite.eleconomista.es/Ultimos_Negocios` - `https://empresite.eleconomista.es/provincia/MADRID/` - `https://empresite.eleconomista.es/Actividad/CONSTRUCCIONES/` - `https://empresite.eleconomista.es/MERCADONA.html` --- ### Input configuration #### `startUrls` List of Empresite URLs to scrape. Use ranking pages, latest-business pages, province pages, activity pages, or direct company profile pages. #### `activities` Optional activity slugs. Example: `CONSTRUCCIONES`, `INFORMATICA`, `TRANSPORTE`, `SANIDAD`. The actor converts each slug to an Empresite activity URL. #### `provinces` Optional province slugs. Example: `MADRID`, `BARCELONA`, `VALENCIA`, `SEVILLA`. The actor converts each slug to an Empresite province URL. #### `maxItems` Maximum number of company records to save. #### `includeDetails` When enabled, the actor visits each company profile page for richer fields. Turn it off for faster and cheaper list-only discovery. #### `maxPagesPerStartUrl` Maximum pagination depth for each source URL. #### `requestDelayMs` Delay between requests. Increase it for larger jobs or if you see skipped pages. #### `proxyConfiguration` Apify Proxy is enabled by default. Datacenter proxy is usually the cheapest option. Use more specialized proxy settings only when your inputs need them. --- ### Example input ```json { "startUrls": [ { "url": "https://empresite.eleconomista.es/Ultimos_Negocios" } ], "maxItems": 100, "includeDetails": true, "maxPagesPerStartUrl": 2, "requestDelayMs": 750, "proxyConfiguration": { "useApifyProxy": true } } ```` *** ### Example output ```json { "companyName": "Mercadona Sa", "detailUrl": "https://empresite.eleconomista.es/MERCADONA.html", "sourceUrl": "https://empresite.eleconomista.es/Top_Empresas", "cif": "A46103834", "activity": "Comercio al por mayor...", "locality": "VALENCIA", "province": "Valencia", "rank": 1, "scrapedAt": "2026-07-06T06:45:17.735Z" } ``` *** ### Lead generation workflow Run the actor for a province or activity. Export results to CSV. Import the CSV into your CRM. Filter by province, activity, website presence, or visible contact details. Use `sourceUrl` and `detailUrl` to verify each lead. *** ### Market mapping workflow Choose several province URLs. Set a higher `maxItems` value. Keep `includeDetails` enabled for richer classification fields. Export to Excel or BI tools. Group by activity, CNAE, province, and locality. *** ### Vendor enrichment workflow Start from direct Empresite profile URLs for companies you already know. The actor will output one row per profile URL. Use the CIF, address, activity, and status fields to enrich vendor files. *** ### Tips for reliable runs - Start with 50-100 items before scaling. - Keep the default delay for large jobs. - Use direct source URLs from Empresite when possible. - Use `includeDetails: false` for cheap discovery runs. - Use `includeDetails: true` for enriched company profiles. - Increase delay if many pages are skipped. - Keep proxy enabled. *** ### Integrations Send results to Google Sheets using Apify integrations. Export CSV files for HubSpot, Salesforce, Pipedrive, or Airtable. Use webhooks to trigger enrichment after a run finishes. Use Apify API to schedule repeated market-monitoring jobs. *** ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/spain-company-directory-scraper').call({ startUrls: [{ url: 'https://empresite.eleconomista.es/Ultimos_Negocios' }], maxItems: 100, includeDetails: true }); console.log(run.defaultDatasetId); ``` *** ### API usage with Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_APIFY_TOKEN') run = client.actor('automation-lab/spain-company-directory-scraper').call(run_input={ 'startUrls': [{'url': 'https://empresite.eleconomista.es/Top_Empresas'}], 'maxItems': 100, 'includeDetails': True, }) print(run['defaultDatasetId']) ``` *** ### API usage with cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/automation-lab~spain-company-directory-scraper/runs?token=YOUR_APIFY_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"startUrls":[{"url":"https://empresite.eleconomista.es/Ultimos_Negocios"}],"maxItems":100}' ``` *** ### MCP usage Use the actor from Claude Desktop, Claude Code, or other MCP clients through Apify MCP. MCP server URL: `https://mcp.apify.com/?tools=automation-lab/spain-company-directory-scraper` Claude Code setup: ```bash claude mcp add apify-spain-company-directory https://mcp.apify.com/?tools=automation-lab/spain-company-directory-scraper ``` Claude Desktop JSON configuration: ```json { "mcpServers": { "apify-spain-company-directory": { "url": "https://mcp.apify.com/?tools=automation-lab/spain-company-directory-scraper" } } } ``` Example prompts: - "Scrape 100 latest Spanish companies from Empresite and summarize provinces." - "Get company records for the Madrid Empresite province page." - "Create a CSV of construction companies from Empresite." *** ### Scheduling Schedule the actor weekly or monthly to monitor market changes. Use the same input each time. Compare datasets by `companyName`, `detailUrl`, and `updatedAt`. *** ### Data quality notes Empresite pages can vary by company. Some profiles expose rich CIF, CNAE, address, phone, website, or executive fields. Other profiles expose only list-level information. Fields that are not visible remain empty. *** ### Legality and ethical use This actor extracts publicly available Empresite pages. Use the data responsibly. Respect applicable privacy, database, marketing, and data-protection laws. Do not use the actor to spam people or violate website terms. *** ### FAQ and troubleshooting #### Why did a run return fewer companies than expected? The source page may have fewer visible company links, rate limiting may have skipped some pages, or your `maxItems` value may be low. Try another source URL, increase delay, or reduce detail enrichment. #### Why are some fields empty? Not every Empresite profile exposes every field publicly. The actor only saves fields that are visible in the returned HTML. #### Why should proxy stay enabled? Directory sites can rate-limit repeated requests. Apify Proxy helps reduce temporary blocking and improves repeatability. *** ### Related scrapers Explore related Automation Lab actors for country registries, company directories, lead generation, and business enrichment on Apify: - https://apify.com/automation-lab/france-sirene-company-registry-scraper - https://apify.com/automation-lab/moneyhouse-ch-company-registry-scraper - https://apify.com/automation-lab/website-contact-finder *** ### Changelog Initial version supports Empresite listing URLs, activity/province shortcuts, direct company URLs, optional profile enrichment, and proxy-backed HTTP extraction. *** ### Support If a source URL stops working or you need a field that appears on Empresite but is missing from the dataset, open an Apify issue with your run URL and example input. # Actor input Schema ## `startUrls` (type: `array`): Empresite URLs to scrape: ranking/list pages, province/category pages, or direct company profile URLs. ## `activities` (type: `array`): Optional Empresite activity slugs such as CONSTRUCCIONES, INFORMATICA, TRANSPORTE, SANIDAD. ## `provinces` (type: `array`): Optional Empresite province slugs such as MADRID, BARCELONA, VALENCIA, SEVILLA. ## `maxItems` (type: `integer`): Maximum number of company records to save. ## `includeDetails` (type: `boolean`): Visit each company profile page when possible to enrich listing rows with CIF, address, activity, website, phone, and executives. ## `maxPagesPerStartUrl` (type: `integer`): Maximum listing pages to follow from each source URL. ## `requestDelayMs` (type: `integer`): Conservative delay between Empresite requests. Increase it for large runs. ## `proxyConfiguration` (type: `object`): Use Apify Proxy to reduce rate-limit issues. Default datacenter proxy is usually enough; switch to country-specific/residential only if needed. ## Actor input object example ```json { "startUrls": [ { "url": "https://empresite.eleconomista.es/Top_Empresas" }, { "url": "https://empresite.eleconomista.es/Ultimos_Negocios" } ], "activities": [ "CONSTRUCCIONES" ], "provinces": [ "MADRID" ], "maxItems": 20, "includeDetails": true, "maxPagesPerStartUrl": 2, "requestDelayMs": 750, "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://empresite.eleconomista.es/Top_Empresas" }, { "url": "https://empresite.eleconomista.es/Ultimos_Negocios" } ], "activities": [ "CONSTRUCCIONES" ], "provinces": [ "MADRID" ], "maxItems": 20, "includeDetails": true, "maxPagesPerStartUrl": 2, "requestDelayMs": 750, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/spain-company-directory-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [ { "url": "https://empresite.eleconomista.es/Top_Empresas" }, { "url": "https://empresite.eleconomista.es/Ultimos_Negocios" }, ], "activities": ["CONSTRUCCIONES"], "provinces": ["MADRID"], "maxItems": 20, "includeDetails": True, "maxPagesPerStartUrl": 2, "requestDelayMs": 750, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("automation-lab/spain-company-directory-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 '{ "startUrls": [ { "url": "https://empresite.eleconomista.es/Top_Empresas" }, { "url": "https://empresite.eleconomista.es/Ultimos_Negocios" } ], "activities": [ "CONSTRUCCIONES" ], "provinces": [ "MADRID" ], "maxItems": 20, "includeDetails": true, "maxPagesPerStartUrl": 2, "requestDelayMs": 750, "proxyConfiguration": { "useApifyProxy": true } }' | apify call automation-lab/spain-company-directory-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/spain-company-directory-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Spain Company Directory Scraper", "description": "πŸ‡ͺπŸ‡Έ Scrape public Spanish company records from Empresite directories, rankings, provinces, activities, and profile pages for B2B leads.", "version": "0.1", "x-build-id": "HWWyOTqpHq2c8QfyA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~spain-company-directory-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-spain-company-directory-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/automation-lab~spain-company-directory-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-spain-company-directory-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/automation-lab~spain-company-directory-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-spain-company-directory-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", "properties": { "startUrls": { "title": "Empresite URLs", "type": "array", "description": "Empresite URLs to scrape: ranking/list pages, province/category pages, or direct company profile URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "activities": { "title": "Activity slugs", "type": "array", "description": "Optional Empresite activity slugs such as CONSTRUCCIONES, INFORMATICA, TRANSPORTE, SANIDAD.", "items": { "type": "string" } }, "provinces": { "title": "Province slugs", "type": "array", "description": "Optional Empresite province slugs such as MADRID, BARCELONA, VALENCIA, SEVILLA.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum companies", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of company records to save.", "default": 20 }, "includeDetails": { "title": "Open company profile pages", "type": "boolean", "description": "Visit each company profile page when possible to enrich listing rows with CIF, address, activity, website, phone, and executives.", "default": true }, "maxPagesPerStartUrl": { "title": "Maximum pages per source", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum listing pages to follow from each source URL.", "default": 2 }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Conservative delay between Empresite requests. Increase it for large runs.", "default": 750 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use Apify Proxy to reduce rate-limit issues. Default datacenter proxy is usually enough; switch to country-specific/residential only if needed.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```