# UK Fresh Companies + Beneficial Owners (Companies House) (`akeeml/uk-fresh-companies-psc`) Actor Daily feed of newly-incorporated UK companies from the official Companies House API, enriched with directors and PSC (beneficial owners). Filter by SIC industry and status. For B2B prospecting, KYB and AML onboarding. Bring your own free API key. - **URL**: https://apify.com/akeeml/uk-fresh-companies-psc.md - **Developed by:** [OpenData Leads](https://apify.com/akeeml) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.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 ## UK Fresh Companies + Beneficial Owners 🇬🇧 Get **newly-incorporated UK companies every day**, enriched with **directors and PSC (beneficial owners)** — straight from the official Companies House register. This Actor turns Companies House **advanced search** into a clean, deduplicated feed of fresh incorporations, then enriches each company with its **officers** and its **Persons with Significant Control** (the beneficial owners UK law requires companies to disclose). Filter by **SIC industry** and status. Built for B2B teams selling to new UK businesses, and for KYB/AML onboarding and due-diligence workflows that need ownership data at source. ### Bring your own API key (free) Companies House data is free but **key-gated**. Get your own key in ~2 minutes: 1. Sign up at **developer.company-information.service.gov.uk**. 2. Register an application and create a **Public Data API key**. 3. Paste it into the `apiKey` input (it's stored securely). The key is rate-limited to 600 requests / 5 min; this Actor throttles itself to stay within it (each company uses ~1–3 calls depending on enrichment). ### Input | Field | Description | |---|---| | `apiKey` | Your free Companies House Public Data API key (required). | | `lastNDays` | Look-back window in days (default 7). Use `1`–`2` for a daily schedule. | | `incorporatedFrom` | `YYYY-MM-DD`; overrides the window. | | `sicCodes` | SIC industry codes to filter, e.g. `62012` (software), `56101` (restaurants). Empty = all. | | `companyStatus` | Statuses to include (default `active`). | | `includeOfficers` | Fetch directors / secretaries (default on). | | `includePsc` | Fetch beneficial owners / PSC (default on). | | `maxResults` | Max companies per run (default 100). | #### Example — new UK software companies this week ```json { "apiKey": "YOUR_KEY", "lastNDays": 7, "sicCodes": ["62012", "62020"], "maxResults": 200 } ```` ### Output One row per company (flat JSON / CSV / Excel): ```json { "company_number": "12345678", "company_name": "EXAMPLE LTD", "company_status": "active", "company_type": "ltd", "date_of_creation": "2026-07-01", "registered_office_address": "…", "sic_codes": ["62012"], "officers": [{ "name": "…", "role": "director", "appointed_on": "…", "nationality": "…", "birth": "1990-04" }], "psc": [{ "name": "…", "kind": "individual-person-with-significant-control", "natures_of_control": ["ownership-of-shares-75-to-100-percent"], "notified_on": "…" }] } ``` ### Scheduling a daily feed Schedule daily with `lastNDays: 2` (small overlap absorbs registration lag; rows are deduplicated by company number within each run). Push straight to your CRM, a Google Sheet, a webhook, or a KYB pipeline. ### Data source & legality - **Companies House Public Data API** — official free UK government API. The PSC (beneficial ownership) register is fully public by law. You use your own API key; no scraping. This is an **informational feed**, not a KYB/AML certification. # Actor input Schema ## `apiKey` (type: `string`): Your own free Companies House Public Data API key. Get one at developer.company-information.service.gov.uk → register an application → 'Live'/Public Data API key. Stored securely. ## `lastNDays` (type: `integer`): Include companies incorporated in the last N days. Ignored if 'Incorporated from' is set. For a daily schedule, use 1–2. ## `incorporatedFrom` (type: `string`): Only companies incorporated on/after this date. Overrides the look-back window. ## `sicCodes` (type: `array`): Filter to these SIC industry codes, e.g. 62012 (business software), 56101 (restaurants). Empty = all industries. ## `companyStatus` (type: `array`): Company statuses to include. Default: active. ## `includeOfficers` (type: `boolean`): Fetch each company's officers (directors / secretaries). Adds one API call per company. ## `includePsc` (type: `boolean`): Fetch each company's Persons with Significant Control — the beneficial owners, for KYB/AML. Adds one API call per company. ## `maxResults` (type: `integer`): Maximum companies per run. Keep modest: with officers + PSC on, each company uses ~3 API calls, and Companies House allows 600 calls / 5 min per key. ## Actor input object example ```json { "lastNDays": 7, "companyStatus": [ "active" ], "includeOfficers": true, "includePsc": true, "maxResults": 100 } ``` # 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("akeeml/uk-fresh-companies-psc").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("akeeml/uk-fresh-companies-psc").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 akeeml/uk-fresh-companies-psc --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=akeeml/uk-fresh-companies-psc", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "UK Fresh Companies + Beneficial Owners (Companies House)", "description": "Daily feed of newly-incorporated UK companies from the official Companies House API, enriched with directors and PSC (beneficial owners). Filter by SIC industry and status. For B2B prospecting, KYB and AML onboarding. Bring your own free API key.", "version": "0.1", "x-build-id": "sGoWGNBKJZZtGLguJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/akeeml~uk-fresh-companies-psc/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-akeeml-uk-fresh-companies-psc", "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/akeeml~uk-fresh-companies-psc/runs": { "post": { "operationId": "runs-sync-akeeml-uk-fresh-companies-psc", "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/akeeml~uk-fresh-companies-psc/run-sync": { "post": { "operationId": "run-sync-akeeml-uk-fresh-companies-psc", "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": [ "apiKey" ], "properties": { "apiKey": { "title": "Companies House API key", "type": "string", "description": "Your own free Companies House Public Data API key. Get one at developer.company-information.service.gov.uk → register an application → 'Live'/Public Data API key. Stored securely." }, "lastNDays": { "title": "Look-back window (days)", "minimum": 1, "maximum": 90, "type": "integer", "description": "Include companies incorporated in the last N days. Ignored if 'Incorporated from' is set. For a daily schedule, use 1–2.", "default": 7 }, "incorporatedFrom": { "title": "Incorporated from (YYYY-MM-DD)", "type": "string", "description": "Only companies incorporated on/after this date. Overrides the look-back window." }, "sicCodes": { "title": "SIC industry codes", "type": "array", "description": "Filter to these SIC industry codes, e.g. 62012 (business software), 56101 (restaurants). Empty = all industries.", "items": { "type": "string" } }, "companyStatus": { "title": "Company status", "type": "array", "description": "Company statuses to include. Default: active.", "default": [ "active" ], "items": { "type": "string" } }, "includeOfficers": { "title": "Include officers (directors)", "type": "boolean", "description": "Fetch each company's officers (directors / secretaries). Adds one API call per company.", "default": true }, "includePsc": { "title": "Include PSC (beneficial owners)", "type": "boolean", "description": "Fetch each company's Persons with Significant Control — the beneficial owners, for KYB/AML. Adds one API call per company.", "default": true }, "maxResults": { "title": "Max companies", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum companies per run. Keep modest: with officers + PSC on, each company uses ~3 API calls, and Companies House allows 600 calls / 5 min per key.", "default": 100 } } }, "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 } } } } } } } } } } ```