# UK Companies House Scraper (`fetch_cat/uk-companies-house-scraper`) Actor Scrape Companies House company profiles, officers, filings, PSCs, registered addresses, status, SIC codes, and incorporation dates. - **URL**: https://apify.com/fetch\_cat/uk-companies-house-scraper.md - **Developed by:** [Hanna Nosova](https://apify.com/fetch_cat) (community) - **Categories:** Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.02 / 1,000 company records 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 ## UK Companies House Scraper Extract public UK company registry data from Companies House. ### What does UK Companies House Scraper do? UK Companies House Scraper collects public company profiles from the official UK Companies House website. It can search by company name, trading name, or company number. It can also enrich direct Companies House company profile URLs. The actor returns company status, company type, registered office address, incorporation date, SIC codes, officers, filings, and PSC data when available. ### Who is it for? Sales teams use it to build company lead lists. Compliance teams use it to check official registry status. Recruiters use it to enrich employer records. Finance teams use it for due-diligence workflows. Legal operations teams use it to monitor filings and registered office changes. Data teams use it to enrich CRMs and internal company databases. ### Why use this actor? You can collect structured Companies House records without building and maintaining your own parser. You can start from search terms or known profile URLs. You can include nested officer and filing details in the same dataset row. You can export the results as JSON, CSV, Excel, XML, or HTML from Apify. ### What data can you extract? | Field | Description | | --- | --- | | query | Search query or source URL used | | companyName | Registered company name | | companyNumber | Companies House number | | companyStatus | Active, dissolved, liquidation, or other public status | | companyType | Company type shown by Companies House | | incorporationDate | Incorporation date when available | | dissolutionDate | Dissolution date when available | | registeredOfficeAddress | Registered office address text | | sicCodes | Nature of business / SIC entries | | previousNames | Previous company names and periods | | officers | Officer and director summaries | | filings | Recent filing history rows and document links | | personsWithSignificantControl | PSC summaries or exemptions | | profileUrl | Companies House company profile URL | | scrapedAt | Timestamp of extraction | ### How much does it cost to scrape UK Companies House? This actor uses transparent pay-per-event pricing, so you pay only for starting a run and for company records that are saved to the dataset. | Charge event | When it is charged | Price | | --- | --- | ---: | | Start | Once when a run begins | $0.005 per run | | Company record - FREE tier | Each saved company profile | $0.000044454 per company | | Company record - BRONZE tier | Each saved company profile | $0.000038655 per company | | Company record - SILVER tier | Each saved company profile | $0.000030151 per company | | Company record - GOLD tier | Each saved company profile | $0.000023193 per company | | Company record - PLATINUM tier | Each saved company profile | $0.000015462 per company | | Company record - DIAMOND tier | Each saved company profile | $0.000010823 per company | Nested officers, PSCs, and filings are included in the same company record charge for this version. You are not charged separately for officer rows, PSC rows, filing rows, addresses, SIC codes, or previous names. Example run costs on the FREE tier: | Example run | Estimated actor charge formula | | --- | --- | | 1 company profile | $0.005 start + 1 × $0.000044454 company record | | 10 company profiles | $0.005 start + 10 × $0.000044454 company records | | 100 company profiles | $0.005 start + 100 × $0.000044454 company records | | 1,000 company profiles | $0.005 start + 1,000 × $0.000044454 company records | For a free-plan or low-volume test, start with `maxResultsPerQuery: 1` and one query or one company URL. That produces one company record when a match is found and keeps the run near the one-time start charge plus one per-company charge. Increase `maxResultsPerQuery` only after the sample output matches your workflow. To keep costs predictable, use exact company numbers or direct profile URLs for enrichment jobs, keep search limits small for broad names, and disable officers, filing history, or PSCs when you do not need those nested sections. ### How to use it 1. Open the actor on Apify. 2. Enter company names, company numbers, or profile URLs. 3. Choose how many companies to save per query. 4. Decide whether to include officers, filings, and PSCs. 5. Run the actor. 6. Download the dataset in your preferred format. ### Input options #### Company names or numbers Use `queries` for company names, trading names, or exact company numbers. Example values: - `tesco` - `openai` - `00002065` #### Company profile URLs Use `companyUrls` when you already know the Companies House profile page. Example: `https://find-and-update.company-information.service.gov.uk/company/00445790` #### Maximum companies per query Use `maxResultsPerQuery` to control result volume. A low number is best for testing. Increase it for larger lead lists. #### Include officers Enable `includeOfficers` to add people listed on the company People tab. This can include directors and secretaries. #### Include filing history Enable `includeFilingHistory` to collect recent filing rows. Rows can include filing type, date, description, pages, and PDF links. #### Include PSCs Enable `includePersonsWithSignificantControl` to collect PSC records when available. Some companies are exempt or do not show PSCs. ### Example input ```json { "queries": ["tesco", "00002065"], "companyUrls": [{ "url": "https://find-and-update.company-information.service.gov.uk/company/00445790" }], "maxResultsPerQuery": 2, "includeOfficers": true, "includeFilingHistory": true, "includePersonsWithSignificantControl": false, "maxOfficersPerCompany": 5, "maxFilingsPerCompany": 5 } ```` ### Example output ```json { "query": "tesco", "companyName": "TESCO PLC", "companyNumber": "00445790", "companyStatus": "Active", "companyType": "Public limited Company", "incorporationDate": "27 November 1947", "registeredOfficeAddress": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA", "sicCodes": ["47110 - Retail sale in non-specialised stores with food, beverages or tobacco predominating"], "profileUrl": "https://find-and-update.company-information.service.gov.uk/company/00445790", "scrapedAt": "2026-07-03T00:00:00.000Z" } ``` ### Tips for better results Use exact company numbers when you need a specific legal entity. Use company names when you want discovery and matching variants. Keep `maxResultsPerQuery` small for first runs. Enable nested sections only when you need them. Use direct URLs for repeat enrichment jobs. ### Common workflows #### B2B lead enrichment Upload a list of company names. Export status, address, SIC code, and officer data. Join the dataset back to your CRM. #### Compliance checks Run company numbers from your customer list. Review company status and filing history. Flag dissolved or unusual statuses. #### Market mapping Search competitor names or sector keywords. Collect public registry details. Use SIC codes and addresses to segment results. ### Integrations You can connect this actor to Google Sheets. You can send results to Make or Zapier. You can call it from a backend service using the Apify API. You can schedule recurring runs for monitoring workflows. ### API usage with Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('fetch_cat/uk-companies-house-scraper').call({ queries: ['tesco'], maxResultsPerQuery: 2 }); console.log(run.defaultDatasetId); ``` ### API usage with Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_APIFY_TOKEN') run = client.actor('fetch_cat/uk-companies-house-scraper').call(run_input={ 'queries': ['tesco'], 'maxResultsPerQuery': 2, }) print(run['defaultDatasetId']) ``` ### API usage with cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/fetch_cat~uk-companies-house-scraper/runs?token=YOUR_APIFY_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"queries":["tesco"],"maxResultsPerQuery":2}' ``` ### Using with MCP You can expose this actor as an Apify MCP tool and call it from Claude Code, Claude Desktop, Cursor, VS Code, or another MCP-compatible client. Use this MCP tools URL: `https://mcp.apify.com/?tools=fetch_cat/uk-companies-house-scraper` For Claude Code, add the remote MCP server with HTTP transport: ```bash claude mcp add --transport http apify-uk-companies-house \ https://mcp.apify.com/?tools=fetch_cat/uk-companies-house-scraper ``` For Claude Desktop, Cursor, or VS Code, add an MCP server entry like this and replace `YOUR_APIFY_TOKEN` with your Apify API token if your client requires an authorization header: ```json { "mcpServers": { "apify-uk-companies-house": { "url": "https://mcp.apify.com/?tools=fetch_cat/uk-companies-house-scraper", "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" } } } } ``` After connecting, ask your MCP client to run the UK Companies House scraper with a small input first. Good first prompts: "Search Companies House for Tesco, save up to 2 company records, and summarize active company records." "Enrich these UK company numbers with registered office addresses and filing history: 00445790, 00002065." "Run the Companies House actor for this prospect list and return company status, SIC codes, and profile URLs." MCP calls still use your Apify account, so the same run start and company record charges apply. Keep the first MCP run small, inspect the dataset link returned by Apify, and then scale up the query list. ### Limits and caveats Companies House search can return officers and other result types. This actor saves company profiles only. Some companies have no PSC data or show an exemption notice. Filing documents may be processing and may not yet have a PDF link. Large searches should use polite limits. ### Legality ### Is it legal to scrape Companies House? Companies House publishes company information for public access. You are responsible for using the data lawfully. Respect applicable privacy, database, and data-protection rules. Do not use the data for prohibited or abusive purposes. ### FAQ #### Can I scrape officers and filings together? Yes. Enable officers and filing history in the input, then set sensible per-company limits. ### Troubleshooting #### Why did I get fewer companies than requested? The search may have fewer company profile results than your limit. The actor ignores officer-only search results because the output is company-focused. #### Why are PSCs empty? Some companies have no PSC records, are exempt, or do not expose the section in the same way. Enable `includePersonsWithSignificantControl` if you need PSC enrichment. #### Why is a PDF link missing? Companies House may show that a filing document is still being processed. Those rows can still appear without a document URL. ### Related scrapers Explore other public-data and business-data actors from the same developer account on Apify. Useful combinations include jobs, maps, and company-enrichment scrapers. - [SEC EDGAR Company Filings Scraper](https://apify.com/fetch_cat/sec-edgar-company-filings-scraper) — collect US company filings for due diligence. - [Google Maps Lead Finder](https://apify.com/fetch_cat/google-maps-lead-finder) — discover local businesses and contact signals. - [Google Jobs Scraper](https://apify.com/fetch_cat/google-jobs-scraper) — enrich hiring and employer research workflows. ### Data freshness Each run fetches current public pages. The `scrapedAt` timestamp records when the item was extracted. ### Export formats Apify datasets can be exported as JSON. They can be exported as CSV. They can be exported as Excel. They can be exported as XML. They can be exported through the Dataset API. ### Support If you need a new output field, open an Apify issue on the actor page. Include your run ID and an example company URL. ### Changelog Initial version supports search queries, direct company URLs, company overview fields, officers, filing history, and PSC summaries. # Actor input Schema ## `queries` (type: `array`): Company names, trading names, or exact 8-character company numbers to search on Companies House. ## `companyUrls` (type: `array`): Optional direct Companies House company profile URLs, for example https://find-and-update.company-information.service.gov.uk/company/00445790. ## `maxResultsPerQuery` (type: `integer`): Maximum company profile records to save for each search query. ## `includeOfficers` (type: `boolean`): Fetch each company's People page and include officer/director summaries. ## `includePersonsWithSignificantControl` (type: `boolean`): Fetch persons with significant control when the tab is available. ## `includeFilingHistory` (type: `boolean`): Fetch recent filing rows and PDF links. ## `maxOfficersPerCompany` (type: `integer`): Caps nested officer records per company. ## `maxFilingsPerCompany` (type: `integer`): Caps nested filing-history records per company. ## `maxConcurrency` (type: `integer`): Number of company profiles fetched in parallel. Keep moderate for GOV.UK pages. ## `useProxy` (type: `boolean`): Usually not needed for Companies House. Enable only if your network has connectivity issues. ## `proxyConfiguration` (type: `object`): Optional Apify Proxy settings used when Use Apify Proxy is enabled. ## Actor input object example ```json { "queries": [ "tesco", "00002065" ], "companyUrls": [ { "url": "https://find-and-update.company-information.service.gov.uk/company/00445790" } ], "maxResultsPerQuery": 10, "includeOfficers": true, "includePersonsWithSignificantControl": false, "includeFilingHistory": true, "maxOfficersPerCompany": 10, "maxFilingsPerCompany": 10, "maxConcurrency": 3, "useProxy": false, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (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 = { "queries": [ "tesco", "00002065" ], "companyUrls": [ { "url": "https://find-and-update.company-information.service.gov.uk/company/00445790" } ], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("fetch_cat/uk-companies-house-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 = { "queries": [ "tesco", "00002065", ], "companyUrls": [{ "url": "https://find-and-update.company-information.service.gov.uk/company/00445790" }], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("fetch_cat/uk-companies-house-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 '{ "queries": [ "tesco", "00002065" ], "companyUrls": [ { "url": "https://find-and-update.company-information.service.gov.uk/company/00445790" } ], "proxyConfiguration": { "useApifyProxy": false } }' | apify call fetch_cat/uk-companies-house-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetch_cat/uk-companies-house-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "UK Companies House Scraper", "description": "Scrape Companies House company profiles, officers, filings, PSCs, registered addresses, status, SIC codes, and incorporation dates.", "version": "0.1", "x-build-id": "PDA7Q7O3MhE3ZmPow" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetch_cat~uk-companies-house-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetch_cat-uk-companies-house-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/fetch_cat~uk-companies-house-scraper/runs": { "post": { "operationId": "runs-sync-fetch_cat-uk-companies-house-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/fetch_cat~uk-companies-house-scraper/run-sync": { "post": { "operationId": "run-sync-fetch_cat-uk-companies-house-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": { "queries": { "title": "Company names or numbers", "type": "array", "description": "Company names, trading names, or exact 8-character company numbers to search on Companies House.", "items": { "type": "string" } }, "companyUrls": { "title": "Company profile URLs", "type": "array", "description": "Optional direct Companies House company profile URLs, for example https://find-and-update.company-information.service.gov.uk/company/00445790.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResultsPerQuery": { "title": "Maximum companies per query", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum company profile records to save for each search query.", "default": 10 }, "includeOfficers": { "title": "Include officers", "type": "boolean", "description": "Fetch each company's People page and include officer/director summaries.", "default": true }, "includePersonsWithSignificantControl": { "title": "Include PSCs", "type": "boolean", "description": "Fetch persons with significant control when the tab is available.", "default": false }, "includeFilingHistory": { "title": "Include filing history", "type": "boolean", "description": "Fetch recent filing rows and PDF links.", "default": true }, "maxOfficersPerCompany": { "title": "Maximum officers per company", "minimum": 0, "maximum": 200, "type": "integer", "description": "Caps nested officer records per company.", "default": 10 }, "maxFilingsPerCompany": { "title": "Maximum filings per company", "minimum": 0, "maximum": 100, "type": "integer", "description": "Caps nested filing-history records per company.", "default": 10 }, "maxConcurrency": { "title": "Maximum concurrency", "minimum": 1, "maximum": 8, "type": "integer", "description": "Number of company profiles fetched in parallel. Keep moderate for GOV.UK pages.", "default": 3 }, "useProxy": { "title": "Use Apify Proxy", "type": "boolean", "description": "Usually not needed for Companies House. Enable only if your network has connectivity issues.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify Proxy settings used when Use Apify Proxy is enabled." } } }, "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 } } } } } } } } } } ```