# UK Companies House Extractor (`bot-rebellion/uk-companies-house-extractor`) Actor Search and extract UK company data from Companies House API profiles officers and filing history - **URL**: https://apify.com/bot-rebellion/uk-companies-house-extractor.md - **Developed by:** [Bot-Rebellion](https://apify.com/bot-rebellion) (community) - **Categories:** Lead generation, Automation, Integrations - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $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 Companies House API — Company Data, Directors, Owners & Filings Extract structured UK company data from the official Companies House API. Returns JSON with company profiles, directors, beneficial owners (PSC), filing history, SIC codes, addresses, and compliance flags. ### Capabilities - **Search** UK companies by name, keyword, company number, or Companies House URL - **Company profiles**: name, number, status, type, incorporation date, address, postcode, SIC codes - **Directors & officers**: names, roles, appointment dates, nationality, occupation, date of birth, address - **Beneficial owners (PSC)**: shareholders with 25%+ ownership, voting rights, control type - **Filing history**: accounts, confirmation statements, officer changes, with document URLs - **Compliance flags**: overdue accounts, overdue confirmation statements, insolvency history, charges - **Advanced search**: paste any Companies House advanced search URL to use their filters - **No API key required** — just provide input and run - **Output**: structured JSON, every field always present (`null` when absent) ### When to use this actor Use this when you need to: - Look up a UK company by name or registration number - Get a list of directors or officers for a UK company - Find out who owns a UK company (beneficial ownership / PSC) - Check if a UK company has overdue filings or insolvency history - Extract filing history and links to filed documents - Get SIC codes and industry classifications for UK companies - Search Companies House by keyword, location, or industry - Build a dataset of UK companies for research, compliance, or lead generation - Perform KYC, AML, or due diligence checks on UK companies ### Output fields Every record contains these fields (null when not available): **Company**: `companyNumber`, `companyName`, `companyStatus`, `companyType`, `incorporationDate`, `dissolutionDate`, `address`, `postcode`, `locality`, `jurisdiction`, `companiesHouseUrl` **Industry**: `sicCodes` (array of `{code, description}`) **History**: `previousNames` **Accounts**: `accounts.lastFiled`, `accounts.type`, `accounts.nextDue`, `accounts.overdue` **Confirmation**: `confirmationStatement.lastFiled`, `confirmationStatement.nextDue`, `confirmationStatement.overdue` **Risk flags**: `hasInsolvencyHistory`, `hasCharges` **Officers** (when enabled): `officers` (array), `activeDirectors` (array of names), `officerSummary` Each officer: `name`, `role`, `appointedOn`, `resignedOn`, `active`, `nationality`, `occupation`, `countryOfResidence`, `dateOfBirth`, `address` **PSC / Beneficial owners** (when enabled): `personsWithSignificantControl` (array) Each PSC: `name`, `type`, `control` (array of plain-English descriptions), `notifiedOn`, `ceasedOn`, `active`, `nationality`, `countryOfResidence` **Filing history** (when enabled): `recentFilings` (array) Each filing: `date`, `category`, `type`, `description`, `documentUrl` **Metadata**: `scrapedAt` ### Input Three ways to specify companies — use any combination: **Search by name/keyword:** ```json { "searchQueries": ["Anthropic", "fintech London"] } ```` **Direct lookup by company number:** ```json { "companyNumbers": ["13533094", "00445790"] } ``` **Paste Companies House URLs** (company pages, search results, or advanced search): ```json { "companiesHouseUrls": [ "https://find-and-update.company-information.service.gov.uk/company/13533094", "https://find-and-update.company-information.service.gov.uk/advanced-search/get-results?companyNameIncludes=tech®isteredOfficeAddress=london&sicCodes=62012" ] } ``` **All input fields:** | Field | Type | Default | Description | |---|---|---|---| | `searchQueries` | string\[] | `[]` | Company names or keywords to search | | `companyNumbers` | string\[] | `[]` | Company registration numbers for direct lookup | | `companiesHouseUrls` | string\[] | `[]` | URLs from the Companies House website | | `includeOfficers` | boolean | `true` | Include directors and officers | | `includePSC` | boolean | `true` | Include beneficial owners | | `includeFilingHistory` | boolean | `true` | Include recent filings | | `maxFilings` | integer | `10` | Filings per company (1-100) | | `maxCompaniesPerQuery` | integer | `25` | Max companies per search (1-500) | | `activeOnly` | boolean | `true` | Exclude dissolved/liquidated companies | ### Output example ```json { "companyNumber": "13533094", "companyName": "ANTHROPIC UK LTD", "companyStatus": "active", "companyType": "Private Limited Company", "incorporationDate": "2021-06-15", "dissolutionDate": null, "address": "123 Tech Street, London, EC2A 1NT, United Kingdom", "postcode": "EC2A 1NT", "locality": "London", "jurisdiction": "england-wales", "sicCodes": [ { "code": "62012", "description": "Computer Programming & IT" } ], "previousNames": [], "accounts": { "lastFiled": "2024-06-30", "type": "small", "nextDue": "2026-03-31", "overdue": false }, "confirmationStatement": { "lastFiled": "2024-06-15", "nextDue": "2025-06-29", "overdue": false }, "hasInsolvencyHistory": false, "hasCharges": false, "companiesHouseUrl": "https://find-and-update.company-information.service.gov.uk/company/13533094", "officers": [ { "name": "John Smith", "role": "director", "appointedOn": "2021-06-15", "resignedOn": null, "active": true, "nationality": "British", "occupation": "Software Engineer", "countryOfResidence": "England", "dateOfBirth": "1985-03", "address": "123 Tech Street, London, EC2A 1NT" } ], "activeDirectors": ["John Smith"], "officerSummary": "1 active of 1 total", "personsWithSignificantControl": [ { "name": "John Smith", "type": "Individual", "control": ["Owns 75-100% of shares", "75-100% voting rights"], "notifiedOn": "2021-06-15", "ceasedOn": null, "active": true, "nationality": "British", "countryOfResidence": "England" } ], "recentFilings": [ { "date": "2024-09-15", "category": "accounts", "type": "AA", "description": "micro entity accounts", "documentUrl": "https://document-api.company-information.service.gov.uk/document/..." } ], "scrapedAt": "2026-04-04T12:00:00.000Z" } ``` ### How this actor compares to other Companies House scrapers | Feature | This Actor | Other scrapers | |---|---|---| | Beneficial owners (PSC) | Yes | No | | Filing history + document URLs | Yes | Some | | Human-readable names | "John Smith" | "SMITH, John" | | SIC code descriptions | "Computer Programming & IT" | Raw code only | | Company type decoded | "Private Limited Company" | "ltd" | | Ownership in plain English | "Owns 75-100% of shares" | Raw slugs | | Officer addresses | Yes | Some | | Postcode + city extracted | Yes | No | | Compliance flags | Yes | No | | Paste CH advanced search URLs | Yes | Some | | API-based (never breaks) | Yes | No (web scrapers) | | No API key needed | Yes | Yes | ### Use cases **B2B Sales & Lead Generation** — Search by industry keyword, get director names and company details. Filter by SIC code and location using advanced search URLs. **Due Diligence & KYC/AML** — Verify company status, check beneficial ownership via PSC data, review filing compliance, flag insolvency history. Essential for onboarding. **Investment Research** — Screen companies by incorporation date, SIC code, and type. Find newly incorporated companies in specific sectors. **Recruitment** — Extract director and officer names with roles, nationality, and occupation for executive search. **Market Research** — Map industries by SIC code, identify geographic clusters, track compliance patterns. **Legal & Regulatory** — Access filing history with document URLs. Monitor accounts and confirmation statement compliance. ### Technical details - Uses the official Companies House REST API (not web scraping) - Sliding-window rate limiter: stays within 600 req/5min limit automatically - Exponential backoff on 429 responses with 3 retries - 15-second request timeout with abort controller - No browser, no proxy, no anti-bot — direct API calls - Processes 3-5 companies per second with full enrichment ### Pricing Pay per result. No monthly subscription. Check the **Pricing** tab for rates. ### FAQ **Do I need a Companies House API key?** No. The actor handles API access. Just provide your search input and run. **How is this different from other Companies House scrapers?** This is the only Apify actor with beneficial ownership (PSC) data, human-readable formatting, compliance flags, and officer addresses. It uses the official API instead of web scraping, so it never breaks. **Can I use Companies House advanced search URLs?** Yes. Build filters on the Companies House website (SIC code, location, date, type), then paste the URL. **How accurate is the data?** Data comes directly from the official UK government Companies House API — the authoritative company registry. **Can I filter by SIC code or location?** Yes. Use advanced search URLs, or search broadly and filter the output by SIC codes and postcodes. **Is this legal?** Yes. Companies House data is public record under UK law. The API is provided for programmatic access. **What output formats are available?** JSON, CSV, Excel, XML, RSS, HTML. Access via Apify dataset or API. **Can I integrate this with other tools?** Yes. Works with Google Sheets, Zapier, Make, webhooks, Slack, and the Apify API (Node.js, Python). # Actor input Schema ## `searchQueries` (type: `array`): Company names or keywords to search (e.g., 'Anthropic', 'AI startup London', 'fintech') ## `companyNumbers` (type: `array`): UK company registration numbers for direct lookup (e.g., 13533094). Skips search. ## `companiesHouseUrls` (type: `array`): Paste URLs directly from the Companies House website. Supports company pages, search results, and advanced search URLs. Example: https://find-and-update.company-information.service.gov.uk/company/13533094 ## `includeOfficers` (type: `boolean`): Fetch all current and resigned directors, secretaries, and other officers with names, roles, appointment dates, nationality, and occupation ## `includePSC` (type: `boolean`): Fetch Persons with Significant Control — shareholders with 25%+ ownership, voting rights, or right to appoint directors ## `includeFilingHistory` (type: `boolean`): Fetch recent company filings — accounts, confirmation statements, officer changes, and more with links to original documents ## `maxFilings` (type: `integer`): Number of recent filings to fetch per company (only when filing history is enabled) ## `maxCompaniesPerQuery` (type: `integer`): How many companies to process per search query or URL ## `activeOnly` (type: `boolean`): Filter out dissolved, liquidated, and closed companies ## Actor input object example ```json { "searchQueries": [ "Anthropic" ], "companyNumbers": [], "companiesHouseUrls": [], "includeOfficers": true, "includePSC": true, "includeFilingHistory": true, "maxFilings": 10, "maxCompaniesPerQuery": 25, "activeOnly": true } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "searchQueries": [ "Anthropic" ], "companyNumbers": [], "companiesHouseUrls": [], "includeOfficers": true, "includePSC": true, "includeFilingHistory": true, "maxFilings": 10, "maxCompaniesPerQuery": 25, "activeOnly": true }; // Run the Actor and wait for it to finish const run = await client.actor("bot-rebellion/uk-companies-house-extractor").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 = { "searchQueries": ["Anthropic"], "companyNumbers": [], "companiesHouseUrls": [], "includeOfficers": True, "includePSC": True, "includeFilingHistory": True, "maxFilings": 10, "maxCompaniesPerQuery": 25, "activeOnly": True, } # Run the Actor and wait for it to finish run = client.actor("bot-rebellion/uk-companies-house-extractor").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 '{ "searchQueries": [ "Anthropic" ], "companyNumbers": [], "companiesHouseUrls": [], "includeOfficers": true, "includePSC": true, "includeFilingHistory": true, "maxFilings": 10, "maxCompaniesPerQuery": 25, "activeOnly": true }' | apify call bot-rebellion/uk-companies-house-extractor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bot-rebellion/uk-companies-house-extractor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "UK Companies House Extractor", "description": "Search and extract UK company data from Companies House API profiles officers and filing history", "version": "1.0", "x-build-id": "t4cVRaBQJvgrupi8L" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bot-rebellion~uk-companies-house-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bot-rebellion-uk-companies-house-extractor", "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/bot-rebellion~uk-companies-house-extractor/runs": { "post": { "operationId": "runs-sync-bot-rebellion-uk-companies-house-extractor", "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/bot-rebellion~uk-companies-house-extractor/run-sync": { "post": { "operationId": "run-sync-bot-rebellion-uk-companies-house-extractor", "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": { "searchQueries": { "title": "Search by company name or keyword", "type": "array", "description": "Company names or keywords to search (e.g., 'Anthropic', 'AI startup London', 'fintech')", "default": [], "items": { "type": "string" } }, "companyNumbers": { "title": "Lookup by company number", "type": "array", "description": "UK company registration numbers for direct lookup (e.g., 13533094). Skips search.", "default": [], "items": { "type": "string" } }, "companiesHouseUrls": { "title": "Companies House URLs", "type": "array", "description": "Paste URLs directly from the Companies House website. Supports company pages, search results, and advanced search URLs. Example: https://find-and-update.company-information.service.gov.uk/company/13533094", "default": [], "items": { "type": "string" } }, "includeOfficers": { "title": "Include directors & officers", "type": "boolean", "description": "Fetch all current and resigned directors, secretaries, and other officers with names, roles, appointment dates, nationality, and occupation", "default": true }, "includePSC": { "title": "Include beneficial owners (PSC)", "type": "boolean", "description": "Fetch Persons with Significant Control — shareholders with 25%+ ownership, voting rights, or right to appoint directors", "default": true }, "includeFilingHistory": { "title": "Include filing history", "type": "boolean", "description": "Fetch recent company filings — accounts, confirmation statements, officer changes, and more with links to original documents", "default": true }, "maxFilings": { "title": "Max filings per company", "minimum": 1, "maximum": 100, "type": "integer", "description": "Number of recent filings to fetch per company (only when filing history is enabled)", "default": 10 }, "maxCompaniesPerQuery": { "title": "Max companies per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many companies to process per search query or URL", "default": 25 }, "activeOnly": { "title": "Active companies only", "type": "boolean", "description": "Filter out dissolved, liquidated, and closed companies", "default": true } } }, "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 } } } } } } } } } } ```