# Companies House Scraper — UK Company Data, Status & SIC (`neuralverge/neuralverge-companies-house-company`) Actor Scrape any UK Companies House company by number — registered name, company number, status, type, incorporation date, registered office and SIC codes. No API key. Structured JSON for KYB, due diligence & onboarding. Pay only for companies found — misses are free. - **URL**: https://apify.com/neuralverge/neuralverge-companies-house-company.md - **Developed by:** [NeuralVerge](https://apify.com/neuralverge) (community) - **Categories:** Automation, Developer tools, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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 ### UK Companies House Scraper — United Kingdom Company Data, Status & SIC ✅ No API Key Scrape any UK (United Kingdom / Britain) company from **Companies House** (find-and-update.company-information.service.gov.uk) by company number — registered name, number, status, type, incorporation date, registered office address, SIC activity codes, officers and persons with significant control (PSC). Powered by the Neuralverge API. **No API key or account required**, and **you only pay for companies we actually find**. Ideal for KYC/KYB, due diligence, compliance, lead enrichment and feeding company data to AI agents. ### ✨ Why this Actor - 🇬🇧 **Full Companies House profile** — identity, status, SIC codes, officers and PSC in one structured object. - 💸 **Pay only for the companies you get** — unresolved numbers are skipped and never billed. Misses are free; no empty, billable rows. - 🔑 **No API key or account** — extraction runs on the Neuralverge backend. - ⚡ **Real-time & structured** — fresh data each run and one predictable JSON schema. ### 🔧 How it works 1. **Provide a UK company number** (e.g. `08804411`) — or an advanced full Companies House profile URL. 2. **Run the Actor.** Fetching and AI-structuring the profile happens on the Neuralverge backend. 3. **Get one dataset row per company** — the source `url`, the extraction `settings` (including the JSON schema) and the structured `machine` object. Export to CSV, JSON or Excel, or pull it over the Apify API. If the company can't be resolved, it's logged and **skipped without charge**. ### Input One company per run. | Field | Type | Notes | |---|---|---| | `companyNumber` | string | The UK Companies House company number, e.g. `08804411`. | | `companyUrl` | string | Advanced: a full Companies House profile URL to use instead of the number. | ```json { "companyNumber": "08804411" } ```` ### What you'll receive Each dataset row mirrors the Neuralverge system output and has three top-level blocks: - **`url`** — the Companies House profile URL that was scraped. - **`settings`** — the extraction settings, including the full JSON schema used, at `settings.extract_schema_json`. - **`machine`** — the structured result: `company_name`, `company_number`, `company_status`, `company_type`, `incorporation_date`, `registered_office_address`, `nature_of_business_sic` (SIC codes), `officers` and `persons_with_significant_control`. > **Nulls & empty sections are normal.** Only data present on the profile is filled — > `officers` and `persons_with_significant_control` can be `null` when not shown on the > overview page. #### Example output (real run) A real dataset row from `https://find-and-update.company-information.service.gov.uk/company/08804411`, shown **in full** — including the complete extraction **schema** (`settings.extract_schema_json`) and the full **machine-readable result** (`machine`). The `human` markdown summary is produced by the system but omitted from the dataset. ```json { "url": "https://find-and-update.company-information.service.gov.uk/company/08804411", "settings": { "has_schema": true, "country_code": "us", "extract_schema_json": { "$schema": "http://json-schema.org/draft-07/schema#", "title": "Companies House Profile", "description": "Extracts key information from a UK Companies House company profile.", "type": "object", "properties": { "company_name": { "type": "string", "description": "The current registered name of the company." }, "company_number": { "type": "string", "description": "The unique registration number of the company." }, "company_status": { "type": "string", "description": "The current operational status of the company (e.g., 'Active', 'Dissolved')." }, "company_type": { "type": "string", "description": "The legal type of the company (e.g., 'Private limited company')." }, "incorporation_date": { "type": "string", "description": "The date the company was incorporated.", "format": "date" }, "registered_office_address": { "type": "string", "description": "The full registered office address of the company." }, "nature_of_business_sic": { "type": "array", "description": "A list of Standard Industrial Classification (SIC) codes and their descriptions.", "items": { "type": "object", "properties": { "code": { "type": "string", "description": "The SIC code number." }, "description": { "type": "string", "description": "The description of the business activity for the SIC code." } }, "required": [ "code", "description" ] } }, "officers": { "type": "array", "description": "A list of current company officers (directors, secretaries, etc.).", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The full name of the officer." }, "role": { "type": "string", "description": "The role of the officer (e.g., 'Director')." }, "appointment_date": { "type": "string", "description": "The date the officer was appointed.", "format": "date" } }, "required": [ "name", "role", "appointment_date" ] } }, "persons_with_significant_control": { "type": "array", "description": "A list of persons or entities with significant control (PSC) over the company.", "items": { "type": "object", "properties": { "name": { "type": "string", "description": "The name of the PSC." }, "notified_on": { "type": "string", "description": "The date the company was notified of the PSC's status.", "format": "date" }, "nature_of_control": { "type": "array", "description": "A list of the ways in which the person has significant control.", "items": { "type": "string" } } }, "required": [ "name", "notified_on", "nature_of_control" ] } } }, "required": [ "company_name", "company_number", "company_status", "incorporation_date", "registered_office_address" ] } }, "machine": { "company_name": "REVOLUT LTD", "company_number": "08804411", "company_status": "Active", "company_type": "Private limited Company", "incorporation_date": "2013-12-06", "registered_office_address": "30 South Colonnade, London, United Kingdom, E14 5HX", "nature_of_business_sic": [ { "code": "62090", "description": "Other information technology service activities" } ], "officers": null, "persons_with_significant_control": null } } ``` > Genuine output from a live run — REVOLUT LTD (08804411), Active, with its SIC activity > code resolved. ### Pricing Pay per result — **$0.005 per company** ($5 per 1,000) returned to the dataset. **You pay only for rows returned — misses are free.** | Event | Price | |---|---| | Actor start | Free | | Company returned (per dataset row) | **$0.005** | Company numbers that can't be resolved are **not billed**. Pricing is on top of your Apify platform usage. ### Integrations & API Results are stored in a standard Apify dataset — export as CSV, JSON, XML or Excel, or fetch on demand through the [Apify API](https://docs.apify.com/api). The Actor also plugs into Apify's integrations (Make, Zapier, n8n, webhooks) and can be called from any [MCP](https://mcp.apify.com/) client. ### FAQ **Do I need an account or API key?** No. Extraction runs on the Neuralverge backend. **What identifier do I use?** The UK company number, e.g. `08804411`. You can also pass a full Companies House profile URL. **Am I charged if a company isn't found?** No. You're billed only for rows returned to the dataset. *** **Disclaimer:** This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Companies House or the UK Government. Data originates from the public Companies House register. # Actor input Schema ## `companyNumber` (type: `string`): The UK Companies House company number to look up, e.g. 08804411. ## `companyUrl` (type: `string`): Optional. A full Companies House company URL to use instead of the number, e.g. https://find-and-update.company-information.service.gov.uk/company/08804411. ## Actor input object example ```json { "companyNumber": "08804411" } ``` # Actor output Schema ## `results` (type: `string`): Structured Companies House company data (name, number, status, type, incorporation date, address, SIC codes), one row per matched company. # 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 = { "companyNumber": "08804411" }; // Run the Actor and wait for it to finish const run = await client.actor("neuralverge/neuralverge-companies-house-company").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 = { "companyNumber": "08804411" } # Run the Actor and wait for it to finish run = client.actor("neuralverge/neuralverge-companies-house-company").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 '{ "companyNumber": "08804411" }' | apify call neuralverge/neuralverge-companies-house-company --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=neuralverge/neuralverge-companies-house-company", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Companies House Scraper — UK Company Data, Status & SIC", "description": "Scrape any UK Companies House company by number — registered name, company number, status, type, incorporation date, registered office and SIC codes. No API key. Structured JSON for KYB, due diligence & onboarding. Pay only for companies found — misses are free.", "version": "0.1", "x-build-id": "ywWVOcOA3K6yllWYh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neuralverge~neuralverge-companies-house-company/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neuralverge-neuralverge-companies-house-company", "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/neuralverge~neuralverge-companies-house-company/runs": { "post": { "operationId": "runs-sync-neuralverge-neuralverge-companies-house-company", "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/neuralverge~neuralverge-companies-house-company/run-sync": { "post": { "operationId": "run-sync-neuralverge-neuralverge-companies-house-company", "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": { "companyNumber": { "title": "Company number", "type": "string", "description": "The UK Companies House company number to look up, e.g. 08804411." }, "companyUrl": { "title": "Company profile URL (advanced)", "type": "string", "description": "Optional. A full Companies House company URL to use instead of the number, e.g. https://find-and-update.company-information.service.gov.uk/company/08804411." } } }, "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 } } } } } } } } } } ```