# Companies House Scraper \[Only $0.003💰] | Directors | SIC Codes (`ahmed_jasarevic/service-scraper`) Actor

Scrape UK Companies House data without an API key: company profiles, directors and officers, SIC codes, filing history, registered charges and persons with significant control. Perfect for UK B2B lead generation, KYC company verification and due diligence.

- **URL**: https://apify.com/ahmed\_jasarevic/service-scraper.md
- **Developed by:** [Ahmed Jasarevic](https://apify.com/ahmed_jasarevic) (community)
- **Categories:**
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.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/actors/running/actors-in-store.md#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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 — Company Profiles, Officers, PSCs & More

**Extract UK company data straight from the public Companies House register — no API key required.** One run returns a complete company record: directors and officers, SIC codes, filing history, registered charges, persons with significant control (PSCs), registered office address and incorporation/dissolution dates. Built for UK B2B lead generation, KYC verification and due diligence checks.

### Main Use Cases

- **UK B2B lead generation** — build lists of registered UK companies with their directors, industry codes and addresses.
- **KYC & company verification** — confirm a UK company is active, check its legal type, incorporation date and dissolved status before doing business.
- **Due diligence on suppliers and partners** — review filing history, registered charges and beneficial owners (PSCs) in one place.
- **Investor and market research** — screen companies on the register by name or company number and export structured data.
- **Monitoring company filings** — schedule recurring runs to track new filings, officer appointments and accounts-due dates.
- **Registered office & SIC code lookup** — enrich CRM records with official company addresses and Standard Industrial Classification codes.

### How It Works

The actor reads the **public UK Companies House register** (`find-and-update.company-information.service.gov.uk`) — the official live register of every registered UK company — using a fast CheerioCrawler over plain HTTP. No browser, no login and **no API key**: an official Companies House API key normally requires registration and per-request authentication, and the free bulk data snapshot is only updated monthly. This actor returns **live data on demand**, with automatic pagination, retries and per-company record caps so you control cost.

### Extract Directors & Officers For Lead Qualification

Every company record includes the full officer list: name, role, appointment and resignation dates, month/year of birth, nationality, country of residence and service address. Use it to qualify decision-makers before outreach, verify director history, or map the leadership of companies you research.

### Get SIC Codes For Industry Segmentation

Each record carries the company's official SIC (Standard Industrial Classification) codes with full descriptions. Segment companies by industry, or filter leads into verticals directly from the scraped data.

### Review Filing History & Registered Charges Before You Commit

The actor pulls filing history (account type, date, description and a link to the official PDF document) plus registered charges — mortgages, debentures and security agreements with created/delivered dates, status and the persons entitled. Run it before extending credit, signing a supply agreement or acquiring a company.

### Track Beneficial Owners (PSCs) For Compliance

Persons with significant control (PSCs) are included with notification dates, nationality, country of residence and nature of control — the data you need for AML, sanctions screening and beneficial-ownership checks under UK company law.

### Input

| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| `searchQuery` | string | no | — | Company name or number to search the register for (e.g. `Tesco` or `00445790`). Top matching companies are scraped. |
| `companyNumbers` | array | no | — | Specific registration numbers (e.g. `00445790`, `SC311560`, `NI012345`). Combined with the search query if both are set. |
| `includeOfficers` | boolean | no | `true` | Fetch officers (directors, secretaries) with appointment/resignation dates. |
| `includeFilingHistory` | boolean | no | `true` | Fetch filing history (accounts, confirmation statements, incorporations, etc.). |
| `includeCharges` | boolean | no | `true` | Fetch registered charges (mortgages, debentures) against the company. |
| `includePsc` | boolean | no | `true` | Fetch persons with significant control (beneficial owners). |
| `maxCompanies` | integer | no | `10` | Max companies to scrape (1–1000). Free accounts are capped at 5 per run. |
| `maxOfficers` | integer | no | `100` | Max officer records per company (1–500). |
| `maxFilings` | integer | no | `50` | Max filing-history records per company (1–500). |
| `maxCharges` | integer | no | `50` | Max charge records per company (1–500). |

### Output

One dataset record per company, with nested detail arrays:

| Field | Description |
|---|---|
| `companyNumber` / `companyName` | Registration number and registered name |
| `companyStatus` / `companyType` | Status (Active, Dissolved, Liquidation…) and legal type (PLC, Ltd, LLP…) |
| `incorporationDate` / `dissolutionDate` | Dates of incorporation and dissolution (if any) |
| `jurisdiction` | England and Wales / Scotland / Northern Ireland |
| `registeredOfficeAddress` | Full registered office address |
| `sicCodes` | Official SIC industry codes with descriptions |
| `accounts` / `confirmationStatement` | Next/last made-up-to and due-by dates, overdue flags |
| `previousCompanyNames` | Former names with effective-from and ceased-on dates |
| `officers` | Directors/secretaries: role, status, appointed/resigned dates, DOB (month/year), nationality, country of residence, address |
| `officersCount` / `officersResignedCount` | Officer totals |
| `filingHistory` | Filings: date, type, description, official document URL, page count |
| `filingHistoryCount` | Filing total |
| `charges` | Charges: title, created/delivered dates, status, satisfied date, persons entitled, particulars |
| `chargesCount` | Charge total |
| `personsWithSignificantControl` | PSCs: name, notification/ceased dates, DOB, nationality, country of residence, natures of control |
| `pscCount` / `pscExemption` | PSC total and exemption notice (if any) |
| `sourceUrl` | Link to the company's public register page |

### Example Input

```json
{
  "searchQuery": "Tesco",
  "maxCompanies": 3,
  "includeOfficers": true,
  "includeFilingHistory": true,
  "includeCharges": true,
  "includePsc": true
}
```

### Example Output

```json
{
  "companyNumber": "00445790",
  "companyName": "TESCO PLC",
  "companyStatus": "Active",
  "companyType": "Public limited Company",
  "incorporationDate": "1947-11-27",
  "jurisdiction": "England and Wales",
  "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"],
  "officers": [
    {
      "name": "BETHELL, Melissa",
      "role": "Director",
      "status": "Active",
      "appointedOn": "2018-09-24",
      "dateOfBirth": "1974-09",
      "nationality": "British",
      "countryOfResidence": "United Kingdom",
      "address": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA"
    }
  ],
  "officersCount": 74,
  "filingHistory": [
    {
      "date": "2026-08-26",
      "type": "SH06",
      "description": "Cancellation of shares...",
      "documentUrl": "https://find-and-update.company-information.service.gov.uk/company/00445790/filing-history/MzUz.../document?format=pdf&download=0",
      "pages": 4
    }
  ],
  "charges": [
    {
      "title": "Account security agreement",
      "createdOn": "2009-11-04",
      "deliveredOn": "2009-11-06",
      "status": "Outstanding",
      "personsEntitled": ["Tesco Trustee Company of Ireland Limited"],
      "particulars": "Right title benefit and interest..."
    }
  ],
  "sourceUrl": "https://find-and-update.company-information.service.gov.uk/company/00445790"
}
```

### Integrations & Automation

- **API** — call the actor programmatically from any app with the Apify API and get results as JSON.
- **Webhooks** — trigger downstream workflows when a run finishes.
- **Scheduling** — run weekly or monthly to monitor filings, accounts-due dates and officer changes. Scheduling recurring runs also improves the actor's store recommendation signals.

### Related Actors

- [Companies House Scraper — UK Companies, Directors & PSCs](https://apify.com/scrapesage/companies-house-scraper) — comparable UK register coverage with officer-lead records
- [UK Companies House Bulk Scraper](https://apify.com/logiover/uk-companies-house-bulk-scraper) — monthly bulk Company Data Product exports
- [UK Companies House Scraper](https://apify.com/parseforge/uk-companies-house-scraper) — flat-row company profiles
- [Companies House UK](https://apify.com/bovi/companies-house-uk) — official API-based lookup (API key required)
- [Business Registration Lookup — SEC EDGAR & UK Companies House](https://apify.com/nexgendata/business-registration-lookup) — KYB record checks across UK and US registries

### FAQ

#### Why use this actor instead of the Companies House API?

The official Companies House API is free but requires **registration, an API key and per-request authentication** on a separate developer platform, and rate limits apply to each key. This actor reads the same public register over plain HTTP — no key, no registration, no separate auth setup. You get live data on demand (the official bulk snapshot is only refreshed monthly).

#### What are alternatives to scraping Companies House?

Apart from the official API (key required) and the monthly Free Company Data Product snapshot, alternatives include the PSC data product, the XML gateway (paid) and third-party company data platforms. For **live, keyless access to full company records on Apify**, this actor plus the related actors above cover most use cases.

#### Is scraping Companies House legal?

Companies House data is public register data, reusable under the **Open Government Licence v3.0**. This actor reads the same public pages anyone can view in a browser, with polite delays and retries built in. Always review the target site's terms of service before large-scale use.

#### Does Companies House data include email addresses or phone numbers?

No. The public register contains no contact details beyond the registered office address. For contact enrichment, combine this actor's output with an external data source.

#### Can I check if a UK company is dissolved?

Yes — `companyStatus` ("Dissolved") and `dissolutionDate` are returned for every record, and you can search the register's dissolved index by the same search query.

#### How do I find SIC codes for a company?

Every record includes `sicCodes` — the official Standard Industrial Classification codes with descriptions used across UK government statistics.

### SEO Keywords

companies house scraper, uk company data, companies house api alternative, scrape companies house, uk company search, b2b lead generation uk, kyc company verification, due diligence company check, uk company directors, company officers uk, sic code lookup, beneficial owner search, persons with significant control, companies house filing history, dissolved company search, company registration number lookup, registered office address lookup, uk business database, track company filings, company status check, companies house api, free uk company data, scottish companies house, companies house northern ireland

### For AI Agents & LLM Apps

This actor is callable via the **Apify MCP server** and the **Apify REST API**. It returns one JSON object per UK company with its full public register record.

Minimal working input:

```json
{
  "searchQuery": "Tesco",
  "maxCompanies": 1
}
```

Fast variant (profile + address + SIC codes only, cheapest run):

```json
{
  "companyNumbers": ["00445790"],
  "includeOfficers": false,
  "includeFilingHistory": false,
  "includeCharges": false,
  "includePsc": false
}
```

Output fields: `companyNumber`, `companyName`, `companyStatus`, `companyType`, `incorporationDate`, `dissolutionDate`, `jurisdiction`, `registeredOfficeAddress`, `sicCodes`, `accounts`, `confirmationStatement`, `previousCompanyNames`, `officers`, `officersCount`, `officersResignedCount`, `filingHistory`, `filingHistoryCount`, `charges`, `chargesCount`, `personsWithSignificantControl`, `pscCount`, `pscExemption`, `sourceUrl`.

Behaviors an agent should know:

- `searchQuery` and `companyNumbers` are **combined and deduplicated** when both are set — direct company numbers are scraped first.
- All include flags default to `true`, so disabling unneeded sections (`includeOfficers`, `includeFilingHistory`, `includeCharges`, `includePsc`) reduces requests and cost.
- **Free-tier accounts are capped at 5 companies per run** regardless of `maxCompanies`; paid accounts get the configured limit (up to 1000).
- Officer `dateOfBirth` is month/year only (register design). Filing document URLs point to official PDFs; the actor does not download them.
- Requests are retried with backoff; partial records are persisted if a run is aborted.

Billing model: pay-per-event — **$0.0005 per run start + $0.003 per company result**.

### Legal & Compliance Disclaimer

This actor is independent and is **not affiliated with, endorsed by, or sponsored by Companies House or the UK government**. It accesses only publicly available pages of the Companies House register — no login bypass, no API keys, no CAPTCHA solving. Users are responsible for their own compliance with the Companies House terms of service and any applicable data-protection law (the register is published under the Open Government Licence v3.0). Officer date-of-birth data is returned only as month/year, matching the register's own data design. This project is not legal advice.

# Actor input Schema

## `searchQuery` (type: `string`):

Company name or number to search the register for (e.g. "Tesco" or "00445790"). The top matching companies will be scraped.

## `companyNumbers` (type: `array`):

Specific company registration numbers to scrape (e.g. 00445790, SC311560, NI012345). If provided together with a search query, both are combined.

## `includeOfficers` (type: `boolean`):

Fetch the company's officers (directors, secretaries) with appointment/resignation dates.

## `includeFilingHistory` (type: `boolean`):

Fetch the company's filing history (accounts, confirmation statements, incorporations, etc.).

## `includeCharges` (type: `boolean`):

Fetch registered charges (mortgages, debentures) against the company.

## `includePsc` (type: `boolean`):

Fetch persons with significant control (beneficial owners) of the company.

## `maxCompanies` (type: `integer`):

Maximum number of companies to scrape (from search results or the provided list).

## `maxOfficers` (type: `integer`):

Maximum number of officer records to fetch per company.

## `maxFilings` (type: `integer`):

Maximum number of filing history records to fetch per company.

## `maxCharges` (type: `integer`):

Maximum number of charge records to fetch per company.

## Actor input object example

```json
{
  "searchQuery": "Tesco",
  "includeOfficers": true,
  "includeFilingHistory": true,
  "includeCharges": true,
  "includePsc": true,
  "maxCompanies": 10,
  "maxOfficers": 100,
  "maxFilings": 50,
  "maxCharges": 50
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("ahmed_jasarevic/service-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("ahmed_jasarevic/service-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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 ahmed_jasarevic/service-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ahmed_jasarevic/service-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/VQPAJc9PpIzLx1ETF/builds/FSAah5dBSs5YJ9k3M/openapi.json
