# Registry Events Tracker — New Companies & Dissolutions (FR+UK) (`aspiring_barricade/registry-events-tracker`) Actor Fresh company registry events as sales signals: new registrations, dissolutions, modifications and insolvency proceedings for France (BODACC) and the UK (Companies House). Filter by event type, region, sector and date window, with dedup and a new-only alert mode. Official open data. - **URL**: https://apify.com/aspiring\_barricade/registry-events-tracker.md - **Developed by:** [Joachim Pouchain](https://apify.com/aspiring_barricade) (community) - **Categories:** Developer tools, Automation, Agents - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.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 ## Registry Events Tracker — New Companies, Dissolutions & Director Changes (FR + UK) A fresh **business registration tracker** for **France** and the **UK**. Instead of a static directory, this actor returns a **stream of registry events** — **new companies**, **dissolutions**, modifications and **insolvency** proceedings — straight from official open data (**BODACC** for France, **Companies House** for the UK). Filter by event type, region, sector and date window, deduplicate, and use **new-only** mode for clean **sales signals**: *"which companies just got created or changed in my area this week."* This is **lead generation France UK** at the source: official registries, not a scraped contact list. ### What it does - **New company alerts** — fresh incorporations (FR + UK). - **Dissolutions, modifications & insolvency** — radiations, changes and *procédures collectives* (FR). - **Filters** — event type, region (FR department / UK town), sector (UK SIC code), and a lookback window. - **New-only alert mode** — return only events not seen in previous runs (per alert key) — perfect for daily prospecting. - **Dedup** — no repeated rows across runs. ### Output fields | Field | Meaning | |-------|---------| | `country` | `FR` or `UK` | | `event_type` | `new_company`, `dissolution`, `modification`, `insolvency`, `accounts_filing` | | `event_date` | Publication / incorporation date | | `company_name`, `company_id` | Name + SIREN (FR) / company number (UK) | | `registry` | `RCS (BODACC)` or `UK Companies House` | | `sector_code(s)` | SIC codes (UK); `null` for FR (BODACC carries no NAF) | | `region`, `region_code` | Department / town + code / postcode | | `status`, `detail` | Event family + sub-type | | `source_url` | Official record link | ### Why this one - **An event flux, not a static lookup.** Built for prospecting on fresh signals, with a **new-only** alert mode that competitors' static scrapers don't offer. - **FR + UK unified** in one normalized schema (SIREN ↔ company number, same fields). - **Official open data** — BODACC (DILA) and Companies House — with cache + retry/backoff. - **Agent- & n8n-ready** — one clean event per row; schedule it for daily lead alerts. ### Input ```json { "country": "FR", "event_types": [], "window_days": 7, "new_only": false, "max_items": 50 } ```` | Field | Type | Description | |-------|------|-------------| | `country` | string | `FR`, `UK` or `BOTH`. | | `event_types` | array | `new_company`, `dissolution`, `modification`, `insolvency`, `accounts_filing`. Empty = all (FR). UK = `new_company` only. | | `window_days` | integer | Events from the last N days. Default 7. | | `region` | string | FR department number (e.g. `75`) or UK town (e.g. `London`). | | `sic_codes` | array | UK sector filter (e.g. `62012` software development). | | `new_only` | boolean | Only events new since the last run. | | `alert_key` | string | Namespace for new-only history. | | `max_items` | integer | Max events returned/charged. Default 50. | ### Output Real FR insolvency event and UK new-incorporation event: ```json { "country": "FR", "event_type": "insolvency", "event_date": "2026-06-28", "company_name": "LUXART-RENOV", "company_id": "841918410", "registry": "RCS (BODACC)", "sector_code": null, "region": "Aisne", "region_code": "02", "status": "Procédures collectives", "detail": "Avis initial", "source": "BODACC — DILA (bodacc-datadila.opendatasoft.com)", "source_url": "https://www.bodacc.fr/pages/annonces-commerciales-detail/?q.id=id:A202601212046", "timestamp": "2026-06-29T10:43:29.368Z" } ``` ```json { "country": "UK", "event_type": "new_company", "event_date": "2026-06-22", "company_name": "VALE & VOYAGER LTD", "company_id": "17293246", "registry": "UK Companies House", "sector_code": "46900", "sector_codes": ["46900", "47910", "70229", "79901"], "region": "Manchester", "region_code": "M40 8WN", "status": "active", "detail": "ltd", "source": "UK Companies House (api.company-information.service.gov.uk)", "source_url": "https://find-and-update.company-information.service.gov.uk/company/17293246", "timestamp": "2026-06-29T10:43:30.355Z" } ``` ### Use cases - **Sales prospecting** — reach newly-formed companies the week they register (FR + UK), filtered to your sector/region. - **Distress / restructuring leads** — track French *procédures collectives* (insolvency) as they're published. - **Market intelligence** — measure formation and dissolution rates by region and sector. - **AI agents / n8n** — schedule daily with `new_only: true` for a deduplicated lead feed. ### Pricing Pay-per-result: target **$0.004 per event** (~$3–5 / 1,000), plus Apify platform usage. `max_items` and `new_only` keep scheduled runs cheap. ### Categories `Developer tools`, `Automation`, `Agents`, `Business`. ### Setup & notes - **France (BODACC)** works with **no key** — the default run returns events out of the box. - **UK (Companies House)** needs a free API key. Set it as a **secret environment variable** `COMPANIES_HOUSE_API_KEY` on the actor. Without it, `country: UK`/`BOTH` reports the UK part as unavailable; FR still works. - UK currently covers **new incorporations** (Companies House advanced-search). FR covers creations, dissolutions, modifications, insolvency and account filings. - FR BODACC announcements don't carry a NAF/sector code, so `sector_code` is `null` for France. - Official registry data, **not a legal opinion**. # Actor input Schema ## `country` (type: `string`): FR (France, BODACC), UK (Companies House) or BOTH. ## `event_types` (type: `array`): Filter: new\_company, dissolution, modification, insolvency, accounts\_filing. Empty = all (FR). UK supports new\_company only. ## `window_days` (type: `integer`): Only events from the last N days. ## `region` (type: `string`): FR: department number (e.g. 75 for Paris). UK: a location/town (e.g. London). ## `sic_codes` (type: `array`): UK only: filter new incorporations by SIC code (e.g. 62012 for software development). ## `new_only` (type: `boolean`): Return only events not seen in previous runs (persisted per alert key). Perfect for scheduled lead alerts. ## `alert_key` (type: `string`): Namespace so different saved searches keep separate new-only history. ## `max_items` (type: `integer`): Maximum events returned/charged per run. ## Actor input object example ```json { "country": "FR", "event_types": [], "window_days": 7, "sic_codes": [], "new_only": false, "alert_key": "default", "max_items": 50 } ``` # 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 = { "window_days": 7, "max_items": 50 }; // Run the Actor and wait for it to finish const run = await client.actor("aspiring_barricade/registry-events-tracker").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 = { "window_days": 7, "max_items": 50, } # Run the Actor and wait for it to finish run = client.actor("aspiring_barricade/registry-events-tracker").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 '{ "window_days": 7, "max_items": 50 }' | apify call aspiring_barricade/registry-events-tracker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=aspiring_barricade/registry-events-tracker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Registry Events Tracker — New Companies & Dissolutions (FR+UK)", "description": "Fresh company registry events as sales signals: new registrations, dissolutions, modifications and insolvency proceedings for France (BODACC) and the UK (Companies House). Filter by event type, region, sector and date window, with dedup and a new-only alert mode. Official open data.", "version": "1.0", "x-build-id": "cSbfDzyYEJfBadhoD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aspiring_barricade~registry-events-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aspiring_barricade-registry-events-tracker", "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/aspiring_barricade~registry-events-tracker/runs": { "post": { "operationId": "runs-sync-aspiring_barricade-registry-events-tracker", "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/aspiring_barricade~registry-events-tracker/run-sync": { "post": { "operationId": "run-sync-aspiring_barricade-registry-events-tracker", "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": { "country": { "title": "Country", "enum": [ "FR", "UK", "BOTH" ], "type": "string", "description": "FR (France, BODACC), UK (Companies House) or BOTH.", "default": "FR" }, "event_types": { "title": "Event types", "type": "array", "description": "Filter: new_company, dissolution, modification, insolvency, accounts_filing. Empty = all (FR). UK supports new_company only.", "default": [], "items": { "type": "string" } }, "window_days": { "title": "Lookback window (days)", "minimum": 1, "maximum": 365, "type": "integer", "description": "Only events from the last N days.", "default": 7 }, "region": { "title": "Region filter (optional)", "type": "string", "description": "FR: department number (e.g. 75 for Paris). UK: a location/town (e.g. London)." }, "sic_codes": { "title": "Sector / SIC codes (UK, optional)", "type": "array", "description": "UK only: filter new incorporations by SIC code (e.g. 62012 for software development).", "default": [], "items": { "type": "string" } }, "new_only": { "title": "Alert mode: only new since last run", "type": "boolean", "description": "Return only events not seen in previous runs (persisted per alert key). Perfect for scheduled lead alerts.", "default": false }, "alert_key": { "title": "Alert key", "type": "string", "description": "Namespace so different saved searches keep separate new-only history.", "default": "default" }, "max_items": { "title": "Max results (cost cap)", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum events returned/charged per run.", "default": 50 } } }, "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 } } } } } } } } } } ```