# Spain New Companies — BORME Official Registry (`agoradelmediterraneo/spain-new-companies-borme`) Actor Extract newly constituted companies from Spain official BORME registry. Filter by province, CNAE sector and date range. Returns name, capital, directors, address. Source: BOE open data API (CC BY 4.0). Ideal for B2B lead generation. - **URL**: https://apify.com/agoradelmediterraneo/spain-new-companies-borme.md - **Developed by:** [Agora](https://apify.com/agoradelmediterraneo) (community) - **Categories:** Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 ## Spain New Companies — BORME Official Registry Extract newly constituted companies from Spain's official Mercantile Registry (BORME) published daily by the BOE. Filter by province, CNAE sector, date range, and company type. Returns structured B2B data ready for CRM import, sales prospecting, or competitive intelligence. **Data source:** BOE Open Data API (https://www.boe.es/datosabiertos/) — official government data, CC BY 4.0. --- ### Why This Actor? Every working day, Spain's official gazette (BOE) publishes 200–500 newly constituted companies via BORME (Boletín Oficial del Registro Mercantil). This is the most reliable source of new business leads in Spain: - **Zero lead decay** — companies just incorporated, no prior sales contact - **Official data** — name, address, capital, directors, CNAE sector from government source - **No scraping risk** — fully legal open government data (CC BY 4.0) - **Daily cadence** — automate weekly prospecting lists for your SDR team --- ### Use Cases #### 1. B2B Sales Prospecting Pull all new IT/software companies (CNAE 62) in Madrid and Barcelona every Monday. Feed directly into your CRM. Your SDR team calls before competitors even know the company exists. #### 2. Competitive Intelligence Monitor new entrants in your sector by CNAE code. Get alerts when capital-intensive companies (>€50k) are incorporated in your region. #### 3. Financial Services Lead Generation Banks, insurers, and accounting firms use BORME to offer services to newly incorporated companies — the moment of maximum need for business accounts, insurance, and accounting. #### 4. Market Research Quantify new business formation by sector, province, and capital level. Track economic activity trends across Spanish regions. #### 5. n8n / Make / Zapier Integration Combine with email enrichment APIs to build automated outreach workflows. New company → find founder on LinkedIn → personalized email sequence. --- ### Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `days` | integer | 7 | Working days to scan (1–30). Mon-Fri only; skips holidays. | | `province` | string | all | Filter by province name: `MADRID`, `BARCELONA`, `VALENCIA`, `SEVILLA`, `BILBAO`, etc. Leave empty for all Spain. | | `cnae` | string | all | Filter by CNAE code prefix: `62` (IT/Software), `47` (Retail), `41` (Construction), `64` (Finance), `86` (Healthcare). | | `sector` | string | all | Filter by sector keyword: `Informática`, `Construcción`, `Hostelería`. | | `maxItems` | integer | 500 | Max companies to return (1–5000). | #### Example: New IT companies in Madrid, last 5 days ```json { "days": 5, "province": "MADRID", "cnae": "62", "maxItems": 100 } ```` #### Example: All Spain, last week ```json { "days": 7, "maxItems": 500 } ``` *** ### Output Format Each result is a JSON object with the following fields: | Field | Type | Description | |-------|------|-------------| | `nombre` | string | Company name | | `tipo_sociedad` | string | Legal form: S.L., S.A., S.L.U., etc. | | `provincia` | string | Province of registration | | `fecha_borme` | string | BORME publication date (YYYYMMDD) | | `capital_euros` | float | Share capital in EUR (null if not disclosed) | | `objeto_social` | string | Business purpose (up to 400 chars) | | `cnae_principal` | string | Primary CNAE code | | `cnae_descripcion` | string | CNAE description | | `sector` | string | Human-readable sector | | `domicilio` | string | Registered address | | `administradores` | array | Director names | | `datos_registrales` | string | Registry entry reference | | `fuente` | string | Direct URL to official BORME entry | #### Sample Output ```json [ { "nombre": "ALCARAVAN GESTION AGRICOLA SL.", "tipo_sociedad": "S.L.", "provincia": "MADRID", "fecha_borme": "20260710", "capital_euros": 3000.0, "objeto_social": "ASESORAMIENTO Y GESTION AGROPECUARIA.", "cnae_principal": "01", "cnae_descripcion": "Agricultura", "sector": "Agricultura", "domicilio": "C/ SANTO ANGEL 77-A (MADRID)", "administradores": ["JOSE GARCIA MARTINEZ"], "datos_registrales": "S 8, H M 890341, I/A 1 (3.07.26).", "fuente": "https://www.boe.es/diario_borme/txt.php?id=BORME-A-2026-131-28" }, { "nombre": "NEXUS CLOUD SOLUTIONS SL.", "tipo_sociedad": "S.L.", "provincia": "BARCELONA", "fecha_borme": "20260709", "capital_euros": 10000.0, "objeto_social": "DESARROLLO DE SOFTWARE Y SERVICIOS DE COMPUTACION EN LA NUBE. ACTIVIDAD PRINCIPAL: 6201 / PROGRAMACIÓN INFORMÁTICA.", "cnae_principal": "6201", "cnae_descripcion": "Programación informática", "sector": "Informática/Software", "domicilio": "C/ DIAGONAL 420 3º 2ª (BARCELONA)", "administradores": ["ANA TORRES RUIZ"], "datos_registrales": "S 5, H B 543210, I/A 1 (7.07.26).", "fuente": "https://www.boe.es/diario_borme/txt.php?id=BORME-A-2026-130-08" } ] ``` *** ### Volume Expectations | Scope | Typical output | |-------|---------------| | All Spain, 1 day | 200–500 companies | | All Spain, 1 week | 800–2,000 companies | | Single province (Madrid), 1 week | 150–400 companies | | CNAE 62 (IT), all Spain, 1 week | 30–80 companies | Volume varies by day of week and time of year. BORME is not published on weekends or national holidays. *** ### Pricing This actor uses **Pay Per Result** pricing: **$0.001 per company extracted** (+ $0.00005/run base cost). A typical run extracting 500 companies costs **$0.50**. A weekly automated run extracting 1,000 companies costs **~$1/week**. *** ### Integration Examples #### n8n: Weekly prospecting list to Google Sheets ``` Schedule trigger (Monday 8am) → Apify actor run (days: 5, cnae: 62, province: MADRID) → Format data → Append to Google Sheets → Slack notification with count ``` #### Python: Direct API integration ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("agoraintelligence/spain-new-companies-borme").call( run_input={"days": 7, "cnae": "62", "maxItems": 200} ) items = list(client.dataset(run["defaultDatasetId"]).iterate_items()) ``` *** ### Data Quality Notes - **Coverage:** ~95% of newly incorporated companies appear within 1–3 working days of notarial deed. - **CNAE availability:** ~60% of entries include explicit CNAE codes. Remaining 40% still include `objeto_social` for keyword filtering. - **Directors:** Extracted when disclosed in the BORME entry (varies by notary). - **No PII:** Director names are public registry data, not private individuals (legal requirement). *** ### FAQ **Is this data legal to use?** Yes. BORME data is published by the Spanish government under CC BY 4.0 open data license. **How fresh is the data?** BORME is published each working day. With `days: 1`, you get companies published yesterday. With `days: 7`, you get the last week. **Can I get historical data beyond 30 days?** Not with this actor (BOE API limit). For historical data, contact the actor author. **Does it cover all types of companies?** Focuses on constitutions (new incorporations). Does not cover capital increases, dissolutions, or name changes. **What if BORME is not published that day?** The actor gracefully skips missing dates (holidays, weekends) and continues with available dates. *** ### Support Issues or feature requests: open a GitHub issue or contact via Apify console. **Looking for bulk data, custom CNAE profiles, or n8n integration help?** Contact us directly. # Actor input Schema ## `days` (type: `integer`): Number of past working days to extract (Mon-Fri only). Default: 7 = last week. ## `province` (type: `string`): Optional: filter by province name (e.g. BARCELONA, MADRID, VALENCIA). Leave empty for all Spain. ## `cnae` (type: `string`): Optional: filter by CNAE prefix (e.g. '62' for IT, '47' for retail, '41' for construction). Leave empty for all sectors. ## `sector` (type: `string`): Optional: filter by sector keyword (e.g. 'Informática', 'Construcción', 'Hostelería'). ## `maxItems` (type: `integer`): Maximum number of companies to return. ## Actor input object example ```json { "days": 7, "province": "", "cnae": "", "sector": "", "maxItems": 500 } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("agoradelmediterraneo/spain-new-companies-borme").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 = {} # Run the Actor and wait for it to finish run = client.actor("agoradelmediterraneo/spain-new-companies-borme").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 '{}' | apify call agoradelmediterraneo/spain-new-companies-borme --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=agoradelmediterraneo/spain-new-companies-borme", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Spain New Companies — BORME Official Registry", "description": "Extract newly constituted companies from Spain official BORME registry. Filter by province, CNAE sector and date range. Returns name, capital, directors, address. Source: BOE open data API (CC BY 4.0). Ideal for B2B lead generation.", "version": "0.1", "x-build-id": "nxHhS2nZVveAkb3vv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/agoradelmediterraneo~spain-new-companies-borme/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-agoradelmediterraneo-spain-new-companies-borme", "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/agoradelmediterraneo~spain-new-companies-borme/runs": { "post": { "operationId": "runs-sync-agoradelmediterraneo-spain-new-companies-borme", "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/agoradelmediterraneo~spain-new-companies-borme/run-sync": { "post": { "operationId": "run-sync-agoradelmediterraneo-spain-new-companies-borme", "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": { "days": { "title": "Working days to scan", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of past working days to extract (Mon-Fri only). Default: 7 = last week.", "default": 7 }, "province": { "title": "Province filter", "type": "string", "description": "Optional: filter by province name (e.g. BARCELONA, MADRID, VALENCIA). Leave empty for all Spain.", "default": "" }, "cnae": { "title": "CNAE code filter", "type": "string", "description": "Optional: filter by CNAE prefix (e.g. '62' for IT, '47' for retail, '41' for construction). Leave empty for all sectors.", "default": "" }, "sector": { "title": "Sector keyword filter", "type": "string", "description": "Optional: filter by sector keyword (e.g. 'Informática', 'Construcción', 'Hostelería').", "default": "" }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of companies to return.", "default": 500 } } }, "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 } } } } } } } } } } ```