# UK Companies House Scraper (`santamaria-automations/uk-companies-house-scraper`) Actor

Search UK Companies House for company records. Returns company name, number, type, status, registered address, and current and resigned officers. Pay per delivered company.

- **URL**: https://apify.com/santamaria-automations/uk-companies-house-scraper.md
- **Developed by:** [NanoScrape](https://apify.com/santamaria-automations) (community)
- **Categories:** Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 company delivereds

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?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## UK Companies House Scraper

Search the [UK Companies House](https://find-and-update.company-information.service.gov.uk) register by company name or keyword and get structured company records, with optional officers (directors and secretaries). Companies are de-duplicated by company number across queries and restarts.

### What you can do with it

- Build lists of UK companies by name or keyword, with status, type, incorporation date and registered address.
- Pull current (and optionally resigned) officers for each company.
- Check which companies are active, dissolved or in liquidation before outreach or onboarding.

An empty input (`{}`) runs a small demo: search "tesco", 5 results.

### Input

| Field | Type | Description | Default |
|-------|------|-------------|---------|
| `queries` | string\[] | Company names or keywords. A single string also works. | demo: `tesco` |
| `maxResultsPerQuery` | integer | Maximum companies per query, 1 to 1000. | 50 (5 in the demo) |
| `includeOfficers` | boolean | Officers and directors of each company. | false |
| `includeResigned` | boolean | Also return resigned officers. Only applies with officers. | false |

Example:

```json
{
  "queries": ["Revolut Ltd", "Monzo Bank Limited"],
  "maxResultsPerQuery": 10,
  "includeOfficers": true
}
```

### Output

One row per company. Fields:

| Field | Description |
|-------|-------------|
| `company_name` | Registered company name |
| `company_number` | Companies House registration number |
| `company_type` | Company type code (ltd, plc, llp, ...) |
| `company_status` | active, dissolved, liquidation, ... |
| `date_of_creation` | Incorporation date (`YYYY-MM-DD`) |
| `registered_address` | Registered office address as one string |
| `address_locality` | Town or city (can be empty) |
| `address_postal_code` | Postal code (can be empty) |
| `address_country` | Country (empty for some companies) |
| `company_url` | Link to the company's page on Companies House |
| `officers` | Only with includeOfficers: name, role, appointed_on, resigned_on, nationality, country_of_residence, address, birth_month_year (dates as `YYYY-MM-DD`). |
| `data_source` | Where the row came from (`website`) |
| `search_query` | The query that found this company |
| `scraped_at` | ISO 8601 UTC timestamp |

Sample row:

```json
{
  "company_name": "REVOLUT LTD",
  "company_number": "08804411",
  "company_type": "ltd",
  "company_status": "active",
  "date_of_creation": "2013-12-06",
  "registered_address": "30 South Colonnade, London, United Kingdom, E14 5HX",
  "address_locality": "London",
  "address_postal_code": "E14 5HX",
  "address_country": "United Kingdom",
  "company_url": "https://find-and-update.company-information.service.gov.uk/company/08804411",
  "officers": [
    {
      "name": "BRITTON, Caroline Louise",
      "role": "director",
      "appointed_on": "2019-03-08",
      "nationality": "British",
      "country_of_residence": "United Kingdom",
      "address": "30 South Colonnade, London, United Kingdom, E14 5HX",
      "birth_month_year": "1965-02"
    }
  ],
  "data_source": "website",
  "search_query": "revolut",
  "scraped_at": "2026-10-26T07:01:59Z"
}
```

### Pricing

Pay per event:

| Event | When it is charged |
|-------|--------------------|
| `actor-start` | Once per run, after the first company row has been delivered. A run that delivers nothing (for example a search with no hits) is not charged. |
| `uk-company-result` | Per company row delivered. |
| `uk-company-officers-enriched` | Per company whose officers were added. |

An enrichment is charged only when it was actually added to the row. See the Pricing tab for current prices. If you set a maximum total charge for the run, rows stop when the next row (with its enrichments) would exceed it, and the run ends with the status "Stopped at the max charge limit. N companies delivered."

### Use with AI agents (MCP)

```json
{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=santamaria-automations/uk-companies-house-scraper",
        "--header",
        "Authorization: Bearer <YOUR_API_TOKEN>"
      ]
    }
  }
}
```

Example prompt: "Use uk-companies-house-scraper to list the active directors of Revolut Ltd."

### FAQ

**How many companies can one query return?** Up to 1000. The register's search stops there.

**Why can `address_country` be empty?** The register does not show it for every company.

**How do I find a company number?** Search by name and read `company_number` from the result.

**Can I stop at a budget?** Yes, set a maximum total charge on the run.

### Data protection

The actor returns data that is public on Companies House. Officer records can include names, correspondence addresses and birth month and year of individuals. You are responsible for using the data lawfully, including UK GDPR and direct-marketing rules.

### Related actors

- [Website Email Scraper](https://apify.com/santamaria-automations/website-email-scraper): find emails on a company's website
- [Website Contact Extractor](https://apify.com/santamaria-automations/website-contact-extractor): team members and decision-makers from company websites
- [Google Maps Scraper](https://apify.com/santamaria-automations/google-maps-scraper): local businesses with phone, website and reviews

### Support

Something not working or a field missing? Open an issue from the Issues tab of this actor or email contact@nanoscrape.com.

# Actor input Schema

## `queries` (type: `array`):

Company names or keywords to search in UK Companies House (e.g. 'Revolut Ltd', 'fintech'). Leave the whole input empty for a tiny demo run (search 'tesco', 5 results).

## `maxResultsPerQuery` (type: `integer`):

Maximum companies returned per query. Maximum: 1000 (the register's search stops at 1000 hits per query).

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

Fetch officers (directors, secretaries) for each company. One extra request per company.

## `includeResigned` (type: `boolean`):

Include former officers who have resigned. Only applies when officers are enabled.

## Actor input object example

```json
{
  "queries": [
    "Revolut Ltd",
    "Monzo Bank Limited"
  ],
  "maxResultsPerQuery": 50,
  "includeOfficers": false,
  "includeResigned": false
}
```

# Actor output Schema

## `defaultDataset` (type: `string`):

UK company records from Companies House, with optional officers

# 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 = {
    "queries": [
        "Revolut Ltd",
        "Monzo Bank Limited"
    ]
};

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

# Prepare the Actor input
run_input = { "queries": [
        "Revolut Ltd",
        "Monzo Bank Limited",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("santamaria-automations/uk-companies-house-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 '{
  "queries": [
    "Revolut Ltd",
    "Monzo Bank Limited"
  ]
}' |
apify call santamaria-automations/uk-companies-house-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,santamaria-automations/uk-companies-house-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/x5FFYifGDpZK1qy0Y/builds/3X3vJZfm91eKSswX9/openapi.json