# Spain BORME Corporate Acts Parser (`minute_contest/borme-corporate-acts-scraper`) Actor Parse daily BORME (Boletin Oficial del Registro Mercantil) Section A PDFs into structured corporate acts - company incorporations, officer appointments, capital changes, dissolutions, and more. - **URL**: https://apify.com/minute\_contest/borme-corporate-acts-scraper.md - **Developed by:** [minute contest](https://apify.com/minute_contest) (community) - **Categories:** Business, Lead generation, Automation - **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 corporate acts 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 ## Spain BORME Corporate Acts Scraper | Actos del Registro Mercantil Extract structured corporate acts from Spain's official BORME gazette - company incorporations, officer appointments, capital changes, mergers, and dissolutions. The only working alternative to the defunct LibreBORME. ### Quick Start Click **Try it** and paste this input: ```json { "date": "2026-04-01", "provinces": ["MADRID"], "actTypes": ["Nombramientos", "Constitucion"] } ```` ### Sample Output ```json { "companyName": "BROKENTIA SOCIEDAD LIMITADA", "registryNumber": "162243", "province": "ALBACETE", "date": "2026-04-01", "acts": [ { "type": "Constitucion", "details": "Comienzo de operaciones: 27.10.25. Objeto social: el comercio al por menor de prendas de vestir..." }, { "type": "Nombramientos", "details": "Adm. Unico: MARENTES VILLARRAGA ALEJANDRA SOFIA." } ], "officers": ["MARENTES VILLARRAGA ALEJANDRA SOFIA"], "registryData": "S 8 , H AB 32200, I/A 1 (25.03.26)", "sourceUrl": "https://www.boe.es/borme/dias/2026/04/01/pdfs/BORME-A-2026-63-02.pdf", "bormeId": "BORME-A-2026-63-02" } ``` ### Pricing | Volume | Cost | |--------|------| | Start cost | $0.005 | | Per result | $0.003 | | ~100 results | ~$0.31 | | ~1,000 results | ~$3.01 | | ~10,000 results | ~$30.01 | No subscriptions, no minimum commitment - pay only for what you use. ### Features - **Daily BORME parsing** - fetch and parse any date's Section A publications - **Date range support** - process multiple days in a single run - **Province filtering** - target specific provinces (Madrid, Barcelona, etc.) - **Act type filtering** - extract only specific acts (Nombramientos, Constitucion, etc.) - **Officer extraction** - parse officer names from appointments and dismissals - **30+ act types recognized** - incorporations, dissolutions, mergers, capital changes, and more - **Full traceability** - every record includes source PDF URL and BORME document ID ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `date` | string | No | yesterday | Specific date (YYYY-MM-DD). BORME publishes on business days only. | | `dateFrom` | string | No | - | Start of date range (YYYY-MM-DD) | | `dateTo` | string | No | - | End of date range (YYYY-MM-DD, inclusive) | | `provinces` | array | No | all | Filter by province names (e.g. `["MADRID", "BARCELONA"]`) | | `actTypes` | array | No | all | Filter by act types (e.g. `["Nombramientos", "Constitucion"]`) | #### More Input Examples **Yesterday's BORME (all provinces):** ```json {} ``` **Date range, officer changes only:** ```json { "dateFrom": "2026-04-01", "dateTo": "2026-04-03", "actTypes": ["Nombramientos", "Ceses/Dimisiones"] } ``` **New incorporations in Barcelona:** ```json { "date": "2026-04-01", "provinces": ["BARCELONA"], "actTypes": ["Constitucion"] } ``` ### Output Fields | Field | Description | |-------|-------------| | `companyName` | Full legal company name | | `registryNumber` | BORME entry number (unique per day) | | `province` | Province of the Registro Mercantil | | `date` | BORME publication date (YYYY-MM-DD) | | `acts` | Array of `{type, details}` - each corporate act with its parsed content | | `officers` | Parsed officer names from Nombramientos/Ceses/Reelecciones entries | | `registryData` | Raw registry reference (Seccion, Hoja, Inscripcion/Asiento) | | `sourceUrl` | Direct URL to the source BORME PDF | | `bormeId` | BORME document identifier (e.g. BORME-A-2026-63-28) | #### Recognized Act Types | Act Type | English | Description | |----------|---------|-------------| | Nombramientos | Appointments | New officer appointments | | Ceses/Dimisiones | Dismissals/Resignations | Officer departures | | Reelecciones | Re-elections | Officer re-appointments | | Revocaciones | Revocations | Power of attorney revocations | | Constitucion | Incorporation | New company formation | | Disolucion | Dissolution | Company dissolution | | Extincion | Extinction | Company liquidation completion | | Ampliacion de capital | Capital increase | Share capital increase | | Reduccion de capital | Capital decrease | Share capital reduction | | Modificaciones estatutarias | Bylaws amendment | Changes to company statutes | | Cambio de domicilio social | Address change | Registered office relocation | | Cambio de objeto social | Purpose change | Business purpose modification | | Cambio de denominacion social | Name change | Company name change | | Fusion | Merger | Company merger | | Escision | Spin-off | Company split | | Declaracion de unipersonalidad | Sole shareholder | Single-shareholder declaration | | Situacion concursal | Insolvency | Bankruptcy/insolvency proceedings | | Otros conceptos | Other | Other registered acts | ### Use Cases - **B2B Prospecting** - find newly incorporated companies (Constitucion) for outreach - **Competitive Intelligence** - monitor officer changes at competitor companies - **M\&A Monitoring** - track mergers, spin-offs, and capital changes - **Compliance & Due Diligence** - verify company status, officer appointments, and dissolution events - **Legal Research** - monitor insolvency proceedings and statutory changes ### Data Source & Compliance All data comes from the official Spanish Government gazette - [boe.es](https://www.boe.es/diario_borme/) via their [Open Data API](https://www.boe.es/datosabiertos/). The BORME is the official publication of the Spanish Registro Mercantil. All corporate acts are legally mandated disclosures published for transparency. - **Free, public data** updated daily (business days, Monday-Saturday) - **Coverage**: all 50 Spanish provinces + Ceuta and Melilla - Rate-limited (2-second delay between PDF downloads) to respect boe.es - Data reuse governed by the [BOE reuse conditions](https://www.boe.es/informacion/aviso_legal/index.php#reutilizacion) ### European Business Data Suite This Actor is part of a growing suite of European business registry scrapers. No subscriptions, no minimum commitment - pay only for what you use. | Country | Registry | Actor | What it does | |---------|----------|-------|-------------| | **Spain** | **BORME** | **This Actor** | Corporate acts - incorporations, officers, capital changes | | Poland | eKRS | [Financial Statements](https://apify.com/minute_contest/poland-krs-financial-scraper) | Balance sheets, income statements | | Poland | KRS | [Board Members](https://apify.com/minute_contest/krs-fullnames-scraper) | Full non-anonymized director names | | Poland | KRZ | [Debtor Registry](https://apify.com/minute_contest/krz-debtor-scraper) | Bankruptcy, restructuring, enforcement | | Poland | KNF | [Financial Supervision](https://apify.com/minute_contest/knf-registry-scraper) | 75,000+ regulated financial entities | | Poland | MSiG | [Court Gazette](https://apify.com/minute_contest/msig-scraper) | Court announcements since 2001 | | Poland | EKW | [Land Registry](https://apify.com/minute_contest/ekw-ksiegi-wieczyste-scraper) | Property ownership, mortgages | | Poland | CRBR | [Beneficial Owners](https://apify.com/minute_contest/crbr-beneficial-owners-scraper) | UBO verification by NIP/KRS | | Poland | UOKiK | [Abusive Clauses](https://apify.com/minute_contest/uokik-clauses-scraper) | 7,500+ banned contract clauses | | Poland | BDO | [Waste Registry](https://apify.com/minute_contest/bdo-waste-registry-scraper) | 674,000+ waste management entities | > **Full suite**: [apify.com/minute\_contest](https://apify.com/minute_contest) ### Informacion en espanol #### Que es este Actor? Este Actor extrae automaticamente los actos mercantiles publicados en la **Seccion Primera (Seccion A)** del BORME - Boletin Oficial del Registro Mercantil. El BORME publica diariamente en formato PDF los actos inscritos en los Registros Mercantiles de toda Espana: constituciones de sociedades, nombramientos y ceses de administradores, ampliaciones de capital, disoluciones, fusiones, y mas. El API de datos abiertos de boe.es proporciona un indice diario con las URLs de los PDFs, pero el contenido real esta atrapado dentro de los PDFs. Este Actor descarga los PDFs de cada provincia, extrae el texto, y lo convierte en datos JSON estructurados. **LibreBORME** - la unica alternativa gratuita anterior - dejo de funcionar en abril de 2025. #### Para quien? - **Equipos de ventas B2B** que buscan empresas recien constituidas para prospectacion comercial - **Departamentos legales** que monitorizan cambios societarios de clientes o competidores - **Fondos de inversion** que rastrean fusiones, escisiones y ampliaciones de capital - **Despachos de abogados** que necesitan datos del Registro Mercantil automatizados - **Analistas de mercado** que estudian tendencias de constitucion por provincia y sector - **Equipos de compliance** que verifican administradores y apoderados de sociedades #### Como funciona? 1. Consulta el API de datos abiertos del BOE para obtener el indice BORME del dia 2. Descarga los PDFs de la Seccion A (actos inscritos) de cada provincia 3. Extrae el texto de cada PDF usando pdfjs-dist 4. Parsea cada inscripcion: nombre de sociedad, numero de registro, tipo de acto, personas nombradas/cesadas 5. Devuelve los datos estructurados en formato JSON #### Tipos de actos reconocidos Nombramientos, Ceses/Dimisiones, Reelecciones, Revocaciones, Constitucion, Disolucion, Extincion, Ampliacion de capital, Reduccion de capital, Modificaciones estatutarias, Cambio de domicilio social, Cambio de objeto social, Cambio de denominacion social, Fusion, Escision, Declaracion de unipersonalidad, Situacion concursal, y mas. ### Limitations - **Section A only** - Section B (other acts) and Section C (legal notices) are not parsed - **PDF text quality** - parsing accuracy depends on pdfjs-dist text extraction; some entries with unusual formatting may be partially parsed - **Weekends and holidays** - BORME does not publish on Sundays or Spanish national holidays; the Actor will return empty results for those dates - **Rate limiting** - the 2-second delay between PDFs means processing a full day (27-30 PDFs) takes approximately 1-2 minutes - **Historical data** - the boe.es API serves BORME data from approximately 2009 onwards; earlier dates may return 404 - **No entry detail pages** - the Actor parses the PDF summaries, not the full registry entries (which require paid access to the Registro Mercantil) # Actor input Schema ## `date` (type: `string`): Specific date to fetch in YYYY-MM-DD format. Defaults to yesterday if no date or date range is provided. BORME publishes on business days only. ## `dateFrom` (type: `string`): Start of date range (YYYY-MM-DD). Use with dateTo for multi-day extraction. Maximum recommended range: 5 days per run. ## `dateTo` (type: `string`): End of date range (YYYY-MM-DD, inclusive). Use with dateFrom for multi-day extraction. ## `provinces` (type: `array`): Filter by province names (e.g. \["MADRID", "BARCELONA"]). Leave empty for all provinces. Case-insensitive matching. ## `actTypes` (type: `array`): Filter by act types (e.g. \["Nombramientos", "Constitucion"]). Leave empty for all act types. Common types: Nombramientos, Ceses/Dimisiones, Constitucion, Disolucion, Ampliacion de capital, Cambio de domicilio social, Modificaciones estatutarias, Reelecciones, Revocaciones. ## Actor input object example ```json {} ``` # Actor output Schema ## `corporateActs` (type: `string`): Parsed BORME entries with company name, registry number, province, acts (Nombramientos, Ceses, Constitucion, etc.), officers, and source references. # 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 = { "date": "" }; // Run the Actor and wait for it to finish const run = await client.actor("minute_contest/borme-corporate-acts-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 = { "date": "" } # Run the Actor and wait for it to finish run = client.actor("minute_contest/borme-corporate-acts-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 '{ "date": "" }' | apify call minute_contest/borme-corporate-acts-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=minute_contest/borme-corporate-acts-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Spain BORME Corporate Acts Parser", "description": "Parse daily BORME (Boletin Oficial del Registro Mercantil) Section A PDFs into structured corporate acts - company incorporations, officer appointments, capital changes, dissolutions, and more.", "version": "1.0", "x-build-id": "yPoFD5cGMN4yWErCW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/minute_contest~borme-corporate-acts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-minute_contest-borme-corporate-acts-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/minute_contest~borme-corporate-acts-scraper/runs": { "post": { "operationId": "runs-sync-minute_contest-borme-corporate-acts-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/minute_contest~borme-corporate-acts-scraper/run-sync": { "post": { "operationId": "run-sync-minute_contest-borme-corporate-acts-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": { "date": { "title": "Date", "type": "string", "description": "Specific date to fetch in YYYY-MM-DD format. Defaults to yesterday if no date or date range is provided. BORME publishes on business days only." }, "dateFrom": { "title": "Date From", "type": "string", "description": "Start of date range (YYYY-MM-DD). Use with dateTo for multi-day extraction. Maximum recommended range: 5 days per run." }, "dateTo": { "title": "Date To", "type": "string", "description": "End of date range (YYYY-MM-DD, inclusive). Use with dateFrom for multi-day extraction." }, "provinces": { "title": "Province Filter", "type": "array", "description": "Filter by province names (e.g. [\"MADRID\", \"BARCELONA\"]). Leave empty for all provinces. Case-insensitive matching.", "items": { "type": "string" } }, "actTypes": { "title": "Act Type Filter", "type": "array", "description": "Filter by act types (e.g. [\"Nombramientos\", \"Constitucion\"]). Leave empty for all act types. Common types: Nombramientos, Ceses/Dimisiones, Constitucion, Disolucion, Ampliacion de capital, Cambio de domicilio social, Modificaciones estatutarias, Reelecciones, Revocaciones.", "items": { "type": "string" } } } }, "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 } } } } } } } } } } ```