# UK Companies House Scraper: Company Search & Profiles API (`rowcraft/uk-companies-house-scraper`) Actor

UK companies from the official Companies House API with your free key: search by name, status, type, SIC code, date or location, or look up company numbers. Profile, registered office, accounts and confirmation statement dates, SIC codes, filings and charges. No officers or PSCs; pay per company.

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

## Pricing

from $2.00 / 1,000 companies

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/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: Company Search & Profiles API

Get UK companies from **Companies House**, the official register of every company in England, Wales, Scotland and Northern Ireland. This **Companies House scraper** reads the register's **public data API** with your own free API key, so it is fast, complete and does not break when a web page changes. Each company comes back as one flat row: name, number, status, type, incorporation date, SIC codes, registered office, accounts and confirmation statement deadlines, previous names, and optionally the latest filings, charges and insolvency cases, as JSON, CSV or Excel.

Look up company numbers, search by name, or run the advanced search: name contains or excludes, status, company type, SIC codes, incorporation and dissolution dates, registered office location. Schedule it with **Only new rows** to get a daily feed of newly registered companies in your sector and region for the price of the new rows.

![Input form of UK Companies House Scraper: Company Search & Profiles API](https://api.apify.com/v2/key-value-stores/7hbQFQdGq61v2OZ2h/records/uk-companies-house-scraper-input.png)

### What you get

One row per company, the same columns whatever way the company was found:

- **Company:** number, name, status and status detail, type and subtype, jurisdiction, incorporation and dissolution dates, link to the company page; codes come with their official labels
- **Activity:** SIC codes with the official descriptions
- **Registered office:** one-line address plus premises, lines, town, county, postcode, country, PO box, and the in-dispute and undeliverable flags; the care-of line is dropped
- **Accounts:** accounting reference date, next accounts due and made up to, overdue flag, last accounts type and period
- **Confirmation statement:** next due, last made up to, overdue flag
- **History:** previous names with the dates they changed, last full members list, charges and insolvency flags, community interest company flag
- **Overseas and branch companies:** registry country and name, registration number, legal form, governing law, business activity, parent company of a UK establishment
- **Optional, when switched on:** the latest filings (date, category, type, official description, pages), charges (totals plus a list with status, dates, description and particulars) and insolvency cases (type and dates)
- **Run data:** how the company was selected, the search it came from, and whether the full profile was read

### Why this actor

- **Official API, your own key:** the free Companies House API key goes into a secret field, Apify stores it encrypted, and the actor sends it only to `api.company-information.service.gov.uk`. No scraping of web pages, no proxies, no CAPTCHAs.
- **Three ways in:** company numbers or links, name searches, and the advanced search with every filter the register offers, including SIC prefixes (`62` covers all computer programming and consultancy codes) and dates such as `30 days`.
- **Nearly 80 flat fields** with stable names, labels next to every code, booleans as booleans, dates in ISO format.
- **Count before you pay:** **Count only** shows how many companies match and what they would cost; nothing is delivered.
- **People are never requested:** no officers, no persons with significant control, no disqualifications, no practitioners, no persons entitled under a charge. You pay per delivered company, with a charge cap.
- **Protects your key:** 600 requests per five minutes is the register's limit; the default pace stays under it, and the first `429` ends the run instead of hammering the API.

### How to use it

1. Open the Actor and fill in **Companies House API key** (the other fields are optional filters).
2. Set **Maximum companies** to a small number for a first try (the default is a safe start).
3. Optional: tick **Count only** and start once. You get the number of matching rows and the estimated cost, for free (only the start event is charged). Untick it to get the data.
4. Click **Start**. The status line shows progress; the run stops cleanly at your limit or at the charge limit you set in the run options.
5. Open the **Dataset** tab and download JSON, CSV, Excel, XML or HTML, or send the rows to Google Sheets, Slack, Make, n8n or Zapier with the Integrations tab.
6. To run it on a schedule, use **Schedules** in Apify Console and turn on **Only new rows since the last run** below: every run then costs only the new rows, and a webhook URL tells you when something new came in.

### Input

| Field | What it does |
|---|---|
| `apiKey` | Your free Companies House API key (see FAQ), stored encrypted, used only against the register's API |
| `companyNumbers` | Company numbers or links to company pages, one per line (`00445790`, `SC123456`, `445790` is padded to 8 characters) |
| `searchNames`, `maxResultsPerName` | Free-text name searches as on the register's search box, with the number of hits to keep per name |
| `nameIncludes`, `nameExcludes` | Advanced search: words the company name must contain or must not contain |
| `statuses`, `types`, `subtypes` | Active, dissolved, liquidation, administration and the other statuses; company types such as `ltd`, `plc`, `llp`, `overseas-company`; subtypes such as community interest companies |
| `sicCodes` | SIC codes or prefixes (`62012`, `6201`, `62`, `62.01`); prefixes expand to every code below them |
| `incorporatedFrom`, `incorporatedTo`, `dissolvedFrom`, `dissolvedTo` | Date ranges: `2026-10-01`, `yesterday`, `30 days`, `6 months` |
| `location` | Town, county or postcode area of the registered office, as on the register's advanced search |
| `maxItems`, `includeProfile` | How many companies to deliver; read the full profile for each company (needed for accounts, confirmation statement, previous names and SIC descriptions when searching) |
| `includeFilingHistory`, `maxFilings`, `includeCharges`, `includeInsolvency` | Add the latest filings, the charges and the insolvency cases to each row (one extra request each, per company) |
| `countOnly`, `onlyNew`, `stateName`, `notifyUrl`, `notifyWhenEmpty` | Count only (deliver nothing); see **Automation** below |
| `requestIntervalMs` | Pause between requests, 600 ms by default; the register allows 600 requests per five minutes per key |

The three selection methods can be combined in one run: numbers are fetched first, then name searches, then the advanced search. A company that appears twice is delivered once.

Example: active private limited companies in London that write software and were incorporated in the last month, with full profiles.

```json
{
  "apiKey": "YOUR_COMPANIES_HOUSE_API_KEY",
  "statuses": ["active"],
  "types": ["ltd"],
  "sicCodes": ["62012", "62020"],
  "location": "London",
  "incorporatedFrom": "30 days",
  "includeProfile": true,
  "maxItems": 500
}
```

### Output

78 fields per row. Empty values are `null`, never missing, so CSV and Excel columns are stable.

| Field | Type | Example |
|---|---|---|
| `id` | string | 00445790 |
| `url` | string | `https://find-and-update.company-information.service.gov.uk/company/…` |
| `companyNumber` | string | 00445790 |
| `companyName` | string | TESCO PLC |
| `status` | string | active |
| `statusLabel` | string | Active |
| `statusDetail` | string | active-proposal-to-strike-off |
| `statusDetailLabel` | string | Active proposal to strike off |
| `type` | string | plc |
| `typeLabel` | string | Public limited company |
| `subtype` | string | community-interest-company |
| `subtypeLabel` | string | Community Interest Company (CIC) |
| `jurisdiction` | string | england-wales |
| `jurisdictionLabel` | string | England/Wales |
| `incorporatedOn` | string | 1947-11-27 |
| `dissolvedOn` | string | Dissolved on |
| `sicCodes` | array | \["47110"] |
| `sicDescriptions` | array | \["Retail sale in non-specialised stores with food, beverages or tob… |
| `registeredOffice` | string | Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, AL7 1GA, … |
| `registeredOfficePremises` | string | Tesco House |
| `registeredOfficeLine1` | string | Shire Park, Kestrel Way |
| `registeredOfficeLine2` | string | Address line 2 |
| `registeredOfficeLocality` | string | Welwyn Garden City |
| `registeredOfficeRegion` | string | Hertfordshire |
| `registeredOfficePostcode` | string | AL7 1GA |
| `registeredOfficeCountry` | string | England |
| `registeredOfficePoBox` | string | PO box |
| `registeredOfficeInDispute` | boolean | False |
| `registeredOfficeUndeliverable` | boolean | False |
| `hasCharges` | boolean | True |
| `hasInsolvencyHistory` | boolean | False |
| `hasBeenLiquidated` | boolean | False |
| `isCommunityInterestCompany` | boolean | False |
| `canFile` | boolean | True |
| `accountsReferenceDate` | string | 28-02 |
| `accountsNextDue` | string | 2026-08-31 |
| `accountsNextMadeUpTo` | string | 2026-02-28 |
| `accountsOverdue` | boolean | False |
| `lastAccountsMadeUpTo` | string | 2025-02-22 |
| `lastAccountsType` | string | group |
| `lastAccountsTypeLabel` | string | Group |
| `lastAccountsPeriodStart` | string | 2024-02-25 |
| `lastAccountsPeriodEnd` | string | 2025-02-22 |
| `confirmationStatementNextDue` | string | 2026-08-01 |
| `confirmationStatementLastMadeUpTo` | string | 2025-07-18 |
| `confirmationStatementOverdue` | boolean | False |
| `previousNames` | array | \["TESCO STORES (HOLDINGS) PUBLIC LIMITED COMPANY"] |
| `previousNamesCount` | integer | 1 |
| `previousNameChanges` | array | Previous names with dates |
| `lastFullMembersListDate` | string | Last full members list date |
| `externalRegistrationNumber` | string | External registration number |
| `foreignRegistryCountry` | string | Overseas registry country |
| `foreignRegistryName` | string | Overseas registry name |
| `foreignRegistrationNumber` | string | Overseas registration number |
| `foreignLegalForm` | string | Overseas legal form |
| `foreignGovernedBy` | string | Overseas governing law |
| `foreignBusinessActivity` | string | Overseas business activity |
| `branchParentCompanyNumber` | string | Parent company number (branch) |
| `branchParentCompanyName` | string | Parent company name (branch) |
| `branchBusinessActivity` | string | Branch business activity |
| `partialDataAvailable` | string | Partial data note |
| `matchedPreviousName` | string | Previous name that matched the search |
| `source` | string | advanced-search |
| `searchQuery` | string | company_status=active\&sic_codes=62012\&location=London |
| `profileLoaded` | boolean | True |
| `filingsCount` | integer | 312 |
| `filings` | array | Latest filings (date, category, type, description, pages) |
| `lastFilingDate` | string | 2026-09-30 |
| `lastFilingDescription` | string | Confirmation statement made on 2026-09-18 with no updates |
| `chargesTotal` | integer | 3 |
| `chargesSatisfied` | integer | 2 |
| `chargesPartSatisfied` | integer | 0 |
| `chargesOutstanding` | integer | 1 |
| `charges` | array | Charges (code, status, dates, description) |
| `insolvencyStatus` | array | Insolvency status (with insolvency on) |
| `insolvencyCasesCount` | integer | 0 |
| `insolvencyCases` | array | Insolvency cases (number, type, dates) |
| `scrapedAt` | string | Scraped at |

#### Example rows

Two real rows from a run (long texts shortened here, complete in the dataset):

```json
[
  {
    "id": "00445790",
    "url": "https://find-and-update.company-information.service.gov.uk/company/00445790",
    "companyNumber": "00445790",
    "companyName": "TESCO PLC",
    "status": "active",
    "statusLabel": "Active",
    "statusDetail": null,
    "statusDetailLabel": null,
    "type": "plc",
    "typeLabel": "Public limited company",
    "subtype": null,
    "subtypeLabel": null,
    "jurisdiction": "england-wales",
    "jurisdictionLabel": "England/Wales",
    "incorporatedOn": "1947-11-27",
    "dissolvedOn": null,
    "sicCodes": [
      "47110"
    ],
    "sicDescriptions": [
      "Retail sale in non-specialised stores with food, beverages or tobacco predominating"
    ],
    "registeredOffice": "Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, AL7 1GA, United Kingdom",
    "registeredOfficePremises": null,
    "registeredOfficeLine1": "Tesco House, Shire Park",
    "registeredOfficeLine2": "Kestrel Way",
    "registeredOfficeLocality": "Welwyn Garden City",
    "registeredOfficeRegion": null,
    "registeredOfficePostcode": "AL7 1GA",
    "registeredOfficeCountry": "United Kingdom",
    "registeredOfficePoBox": null,
    "registeredOfficeInDispute": false,
    "registeredOfficeUndeliverable": false,
    "hasCharges": false,
    "hasInsolvencyHistory": false,
    "hasBeenLiquidated": false,
    "isCommunityInterestCompany": null,
    "canFile": true,
    "accountsReferenceDate": "26-02",
    "accountsNextDue": "2027-08-26",
    "accountsNextMadeUpTo": "2027-02-26",
    "accountsOverdue": false,
    "lastAccountsMadeUpTo": "2026-02-28",
    "lastAccountsType": "group",
    "lastAccountsTypeLabel": "Group",
    "lastAccountsPeriodStart": "2025-02-27",
    "lastAccountsPeriodEnd": "2026-02-28",
    "confirmationStatementNextDue": "2027-07-02",
    "confirmationStatementLastMadeUpTo": "2026-06-18",
    "confirmationStatementOverdue": false,
    "previousNames": [
      "TESCO STORES (HOLDINGS) PUBLIC LIMITED COMPANY",
      "TESCO STORES (HOLDINGS) LIMITED"
    ],
    "previousNamesCount": 2,
    "previousNameChanges": [
      {
        "name": "TESCO STORES (HOLDINGS) PUBLIC LIMITED COMPANY",
        "from": "1981-12-14",
        "until": "1983-08-25"
      },
      {
        "name": "TESCO STORES (HOLDINGS) LIMITED",
        "from": "1947-11-27",
        "until": "1981-12-14"
      }
    ],
    "lastFullMembersListDate": "2013-06-07",
    "externalRegistrationNumber": null,
    "foreignRegistryCountry": null,
    "foreignRegistryName": null,
    "foreignRegistrationNumber": null,
    "foreignLegalForm": null,
    "foreignGovernedBy": null,
    "foreignBusinessActivity": null,
    "branchParentCompanyNumber": null,
    "branchParentCompanyName": null,
    "branchBusinessActivity": null,
    "partialDataAvailable": null,
    "matchedPreviousName": null,
    "source": "number",
    "searchQuery": null,
    "profileLoaded": true,
    "scrapedAt": "2026-10-10T06:26:54.596Z",
    "filingsCount": 8372,
    "filings": [
      {
        "date": "2026-09-16",
        "category": "capital",
        "subcategory": null,
        "type": "SH03",
        "description": "Purchase of own shares.",
        "descriptionCode": "capital-return-purchase-own-shares",
        "pages": 4,
        "paperFiled": true
      },
      {
        "date": "2026-08-26",
        "category": "capital",
        "subcategory": null,
        "type": "SH06",
        "description": "Cancellation of shares. Statement of capital on 2026-07-07",
        "descriptionCode": "capital-cancellation-shares",
        "pages": 4,
        "paperFiled": true
      },
      {
        "date": "2026-08-26",
        "category": "capital",
        "subcategory": null,
        "type": "SH06",
        "description": "Cancellation of shares. Statement of capital on 2026-06-30",
        "descriptionCode": "capital-cancellation-shares",
        "pages": 4,
        "paperFiled": true
      },
      "… 2 more"
    ],
    "lastFilingDate": "2026-09-16",
    "lastFilingDescription": "Purchase of own shares.",
    "chargesTotal": 9,
    "chargesSatisfied": 7,
    "chargesPartSatisfied": 0,
    "chargesOutstanding": 2,
    "charges": [
      {
        "code": null,
        "number": 9,
        "status": "outstanding",
        "createdOn": "2009-11-04",
        "deliveredOn": "2009-11-06",
        "satisfiedOn": null,
        "description": null,
        "particulars": null
      },
      {
        "code": null,
        "number": 8,
        "status": "outstanding",
        "createdOn": "2009-11-04",
        "deliveredOn": "2009-11-06",
        "satisfiedOn": null,
        "description": null,
        "particulars": null
      },
      {
        "code": null,
        "number": 7,
        "status": "fully-satisfied",
        "createdOn": "2009-03-27",
        "deliveredOn": "2009-03-27",
        "satisfiedOn": "2009-11-25",
        "description": null,
        "particulars": null
      },
      "… 6 more"
    ],
    "insolvencyStatus": [],
    "insolvencyCasesCount": 0,
    "insolvencyCases": []
  },
  {
    "id": "00048839",
    "url": "https://find-and-update.company-information.service.gov.uk/company/00048839",
    "companyNumber": "00048839",
    "companyName": "BARCLAYS PLC",
    "status": "active",
    "statusLabel": "Active",
    "statusDetail": null,
    "statusDetailLabel": null,
    "type": "plc",
    "typeLabel": "Public limited company",
    "subtype": null,
    "subtypeLabel": null,
    "jurisdiction": "england-wales",
    "jurisdictionLabel": "England/Wales",
    "incorporatedOn": "1896-07-20",
    "dissolvedOn": null,
    "sicCodes": [
      "64191"
    ],
    "sicDescriptions": [
      "Banks"
    ],
    "registeredOffice": "1 Churchill Place, London, E14 5HP",
    "registeredOfficePremises": null,
    "registeredOfficeLine1": "1 Churchill Place",
    "registeredOfficeLine2": null,
    "registeredOfficeLocality": "London",
    "registeredOfficeRegion": null,
    "registeredOfficePostcode": "E14 5HP",
    "registeredOfficeCountry": null,
    "registeredOfficePoBox": null,
    "registeredOfficeInDispute": false,
    "registeredOfficeUndeliverable": false,
    "hasCharges": false,
    "hasInsolvencyHistory": false,
    "hasBeenLiquidated": false,
    "isCommunityInterestCompany": null,
    "canFile": true,
    "accountsReferenceDate": "31-12",
    "accountsNextDue": "2027-06-30",
    "accountsNextMadeUpTo": "2026-12-31",
    "accountsOverdue": false,
    "lastAccountsMadeUpTo": "2025-12-31",
    "lastAccountsType": "group",
    "lastAccountsTypeLabel": "Group",
    "lastAccountsPeriodStart": "2025-01-01",
    "lastAccountsPeriodEnd": "2025-12-31",
    "confirmationStatementNextDue": "2026-11-15",
    "confirmationStatementLastMadeUpTo": "2025-11-01",
    "confirmationStatementOverdue": false,
    "previousNames": [
      "BARCLAYS BANK PLC",
      "BARCLAYS BANK LIMITED",
      "BARCLAY & COMPANY LIMITED"
    ],
    "previousNamesCount": 3,
    "previousNameChanges": [
      {
        "name": "BARCLAYS BANK PLC",
        "from": "1982-02-15",
        "until": "1985-01-01"
      },
      {
        "name": "BARCLAYS BANK LIMITED",
        "from": "1916-02-17",
        "until": "1982-02-15"
      },
      {
        "name": "BARCLAY & COMPANY LIMITED",
        "from": "1896-07-20",
        "until": "1916-02-17"
      }
    ],
    "lastFullMembersListDate": "2012-08-31",
    "externalRegistrationNumber": null,
    "foreignRegistryCountry": null,
    "foreignRegistryName": null,
    "foreignRegistrationNumber": null,
    "foreignLegalForm": null,
    "foreignGovernedBy": null,
    "foreignBusinessActivity": null,
    "branchParentCompanyNumber": null,
    "branchParentCompanyName": null,
    "branchBusinessActivity": null,
    "partialDataAvailable": null,
    "matchedPreviousName": null,
    "source": "number",
    "searchQuery": null,
    "profileLoaded": true,
    "scrapedAt": "2026-10-10T06:26:31.297Z"
  }
]
```

Results can be downloaded as JSON, CSV, Excel, XML or HTML from the Dataset tab, or read through the Apify API.

![Results of UK Companies House Scraper: Company Search & Profiles API in the Apify dataset view](https://api.apify.com/v2/key-value-stores/7hbQFQdGq61v2OZ2h/records/uk-companies-house-scraper-results.png)

### Pricing

**Pay per result.** You pay for each company delivered to your dataset, nothing else: no subscription, no minimum, no charge for rows your filters drop or for the requests behind them.

| Your Apify plan | Price per 1,000 rows | Price per row |
|---|---|---|
| Free plan | **$3.00** | $0.003 |
| Starter plan | **$2.67** | $0.00267 |
| Scale plan | **$2.33** | $0.00233 |
| Business plan and above | **$2.00** | $0.002 |

Example: 1,000 companies cost $3.00 on the Free plan and $2.00 on the Business plan. The Apify platform usage of a run (compute, storage) is small for this actor — well under one cent per 1,000 rows — and is billed by Apify separately, as for every Actor.
A start event of $0.00005 is charged once per run (Apify default).
**Cap your spend:** set *Maximum total charge* in the run options. The actor stops cleanly when the cap is reached and you keep everything delivered until then. The run summary (`RUN_SUMMARY` in the key-value store) says why a run stopped.
**Check before you pay:** turn on **Count only** to see how many rows match and what they would cost at your tier. That run delivers nothing and costs only the start event.

### Automation: only new rows, notifications, schedules

**Only new rows since the last run.** Turn on `onlyNew` and the actor remembers every company it delivered to you (in a key-value store named `rowcraft-uk-companies-house-scraper-state` in your Apify account). The next run with the same `stateName` skips what you already have and you pay only for new rows. The first run delivers everything that matches. Use a different `stateName` for each schedule or search so they keep separate memories.

**Notification when the run ends.** Put a webhook address in `notifyUrl` and the actor sends one JSON POST with the number of new rows, links to the dataset (JSON and CSV) and the run. It works out of the box with Slack and Discord incoming webhooks (the message is in `text` and `content`), with Make, n8n and Zapier catch hooks, and with your own endpoint. By default it is sent only when there is at least one new row; `notifyWhenEmpty` sends it every time.

**Schedules.** Create a schedule in Apify Console (hourly, daily, weekly or cron) with `onlyNew` on. A daily schedule gives you a feed of new companies for the price of the new rows only.

**Integrations.** Send the results to Make, n8n, Zapier, Google Sheets, Slack, Google Drive, Airtable or any webhooks from the Integrations tab of the Actor, with no code. Apify also offers native actions for Make, n8n and Zapier.

**API, SDKs and AI agents.** Every run is available through the Apify API and the official JavaScript and Python clients; the Actor can also be called by AI agents through the Apify MCP server. The example input in the API tab is a working call.

**Count only.** `countOnly` returns the number of matching companies and the estimated cost without delivering anything, so you can size a job before paying for it.

### Use cases

- **New-company feeds:** every company incorporated this week in your sector (SIC codes) and region, delivered daily to a sheet, a CRM or Slack.
- **Lead lists for B2B services:** accountants, insurers, banks, software vendors and agencies that sell to new or growing companies; filter by type, age, activity and location.
- **Supplier and customer checks:** status, age, accounts deadlines and overdue flags, charges and insolvency history for a list of company numbers.
- **Portfolio monitoring:** re-run on your company numbers with **Only new rows** switched off and compare status, filings and charges with last week.
- **Research and journalism:** companies by SIC code, postcode area and date range, dissolved companies in a period, overseas companies with UK establishments.

### What this actor does not do

- Deliver directors, secretaries, persons with significant control, disqualifications, insolvency practitioners, persons entitled under a charge, e-mail addresses or phone numbers: these endpoints and fields are never requested.
- Deliver the documents themselves (accounts PDFs, filed forms); each filing row carries the official description and page count, and the company page is linked.
- Work without a key: the register's API requires a free API key, which the customer creates in the Companies House Developer Hub (see FAQ).
- Use the streaming API or the document API; log in to WebFiling; solve CAPTCHAs or use proxies.

### Limits and fair use

- The register allows **600 requests per five minutes per key** and answers `429` beyond that. The default pause of 600 ms between requests keeps a run under the limit; the shortest allowed is 500 ms. The first `429` ends the run, the rows delivered so far are kept and the run summary says `stoppedByRateLimit`.
- The advanced search returns up to 500 companies per request and the actor pages through it until `maxItems` or the last result; the run summary reports the total under `totalMatching`. Very broad filters can mean tens of thousands of companies, and past 10,000 results the register's paging is not documented, so narrow the filters (dates, location, SIC codes) for big lists. Name searches return up to 1,000 hits per name.
- One request per company for the full profile, plus one each for filings, charges and insolvency when switched on. 1,000 companies with profiles are about 1,000 requests, roughly ten minutes at the default pace.
- A company number that does not exist is reported in the run summary under `missingNumbers` and is not charged. An invalid key stops the run with a clear message and nothing is charged beyond the start event.
- Dates and times follow the register (Europe/London); the run summary carries the counts, the pages read and the warnings.

### Data source

The data comes from the [Companies House Public Data API](https://developer-specs.company-information.service.gov.uk/companies-house-public-data-api/reference), the official interface of the UK register operated by Companies House, an executive agency of the UK Government. Each row links to the company's page on [Find and update company information](https://find-and-update.company-information.service.gov.uk/). The register is public by law (Companies Act 2006): Companies House makes the data available for use and re-use, including commercially, and places no restrictions of its own on how it is used; the customer remains responsible for complying with data protection law. Companies House's own material is Crown copyright under the [Open Government Licence](https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/). SIC codes follow the [UK Standard Industrial Classification 2007](https://www.gov.uk/government/publications/standard-industrial-classification-of-economic-activities-sic). Rowcraft is independent and not affiliated with Companies House or the UK Government; the names belong to their owners.

### Privacy: no personal data

Rowcraft actors are built not to collect personal data:

- Only the company profile, search, filing history, charges and insolvency endpoints are called. The officers, persons with significant control, disqualified officers and appointments endpoints are never requested, so no director, secretary or owner ever reaches the dataset.
- Inside the endpoints that are used, fields about people are dropped before the row is saved: the care-of line of the registered office, the persons entitled under a charge, the insolvency practitioners, and the names in filing descriptions (an appointment filing reads `Appointment of [name removed] as a director`).
- E-mail addresses, phone numbers and `mailto:` or `tel:` links that appear inside free text are removed before the row is saved.

You are responsible for using the data in line with the law that applies to you, including the UK GDPR when a row concerns a sole trader or an individual's company.

### Other Rowcraft actors

All Rowcraft actors read official or public sources, deliver flat rows without personal data and support only-new runs and notifications:

- [Ashby Jobs Scraper – Job Postings with Salary Ranges](https://apify.com/rowcraft/ashby-jobs-scraper) — Job postings from Ashby job boards (jobs.ashbyhq.com) by company: title, department, team, locations with country, employment and workplace type, published salary range, full text.
- [Broken Link Checker – Find 404s and Dead Links API](https://apify.com/rowcraft/broken-link-checker) — Pay per crawled page, not per link: crawl a site within robots.txt and check every link on each page for 404s, 5xx errors, DNS and TLS failures and redirects.
- [Career Site Jobs Scraper: Greenhouse, Lever, Ashby, Workday](https://apify.com/rowcraft/career-site-jobs-scraper) — Job listings from the career pages of the companies you choose on Greenhouse, Lever, Ashby, Workday, Workable, Personio, Recruitee, Teamtailor and Gem, in one run and one format: title, locations, department, salary when published, full text.
- [Chrome Web Store Scraper: Users, Ratings & Versions](https://apify.com/rowcraft/chrome-web-store-scraper) — Reads public Chrome Web Store listing pages with no login, no proxy and no personal data: users, rating, category, version, update date, permissions and company developers.
- [Domain Email and DNS Checker API: MX, SPF, DMARC, Providers](https://apify.com/rowcraft/domain-email-dns-checker) — Find which email provider, sending services and DNS host each domain uses, from public DNS records only.
- [SIRENE France Company Scraper: SIREN, NAF, Revenue, Status](https://apify.com/rowcraft/france-company-register) — French companies from the official Recherche d'entreprises API (INSEE SIRENE + INPI): SIREN and SIRET, legal form, NAF activity, head-office address, employee band, revenue and net income, labels, creation date and VAT number.
- [Gem Jobs Scraper – Job Board Listings from jobs.gem.com](https://apify.com/rowcraft/gem-jobs-scraper) — Job listings from Gem job boards (jobs.gem.com) by company: title, department, offices with country, employment type, remote, hybrid or on-site, requisition ID, publication date and full ad text, from the public Gem Job Board API.
- [Google Play Apps Scraper: App Details, Installs, Ratings](https://apify.com/rowcraft/google-play-apps-scraper) — Public Google Play app details as flat rows: installs, rating, number of ratings, price, version, last update, minimum Android, ads and in-app purchases.
- [Greenhouse Jobs Scraper – Job Listings by Company Board](https://apify.com/rowcraft/greenhouse-jobs-scraper) — Job listings from Greenhouse job boards by company: title, departments, offices, publication date, full ad text, published pay ranges.
- [Himalayas Jobs Scraper: Remote Jobs API with Salaries](https://apify.com/rowcraft/himalayas-jobs-scraper) — Remote jobs from Himalayas through its public jobs API: title, company, salary range, seniority, categories, the countries and time zones open to candidates, full description and job link.
- [KRS Poland Companies Scraper: Register Data, PKD, Status](https://apify.com/rowcraft/krs-poland-companies) — Polish companies from the official KRS register API of the Ministry of Justice: name, KRS, NIP and REGON numbers, legal form, status, address, PKD activity codes, share capital, branches and registration dates.
- [LEI Records Scraper: Legal Entity Identifier Lookup API](https://apify.com/rowcraft/lei-records-scraper) — Legal Entity Identifier (LEI) records from the Global LEI Index, read through the public GLEIF API: legal name, legal form, register number, addresses, status, renewal date and parent companies.
- [Lever Jobs Scraper – Job Postings from jobs.lever.co](https://apify.com/rowcraft/lever-jobs-scraper) — Job postings from Lever career pages (jobs.lever.co) by company: title, team, department, location, commitment, workplace type, salary range when published, description, requirements and benefits.
- [Norway Company Register Scraper: Brønnøysund Business Data](https://apify.com/rowcraft/norway-company-register-scraper) — Norwegian companies from the Central Coordinating Register for Legal Entities (Brønnøysund, NLOD open data): organisation number, legal form, industry, employees, share capital, addresses, website, VAT and bankruptcy status.
- [Personio Jobs Scraper: Job Listings, Salaries, Departments](https://apify.com/rowcraft/personio-jobs-scraper) — Job ads from any company's Personio careers feed: title, department, office, employment type, schedule, seniority, salary when published, keywords and the full description in the language you choose.
- [Platsbanken Scraper: Sweden Jobs, Employers, Org Numbers](https://apify.com/rowcraft/platsbanken-jobs-scraper) — Every job ad on Platsbanken (Arbetsförmedlingen) from the official JobTech API: headline, employer and organisation number, occupation codes, municipality, coordinates, salary type, deadline and full text.
- [Recruitee Jobs Scraper – Job Listings by Company Career Site](https://apify.com/rowcraft/recruitee-jobs-scraper) — Job listings from Recruitee career sites by company: title, department, locations with country, employment type, remote flag, published salary and full text, one request per company.
- [Robots.txt and AI Crawler Access Checker API](https://apify.com/rowcraft/robots-ai-crawler-checker) — Check which AI and search crawlers a website lets in: GPTBot, ClaudeBot, PerplexityBot, Google-Extended and more, read from robots.txt by the RFC 9309 rules.
- [RSS Feed Finder and Reader – Blog and News Article API](https://apify.com/rowcraft/rss-feed-finder-reader) — Find the RSS, Atom and JSON feeds of any website and read their newest articles, from a domain name alone.
- [SEO Audit Tool: Titles, Meta Tags, Headings and Links API](https://apify.com/rowcraft/seo-audit-tool) — Audit the on-page SEO of any list of pages or websites: titles, meta descriptions, headings, canonicals, indexing, links, images and structured data, with a score and the issues found per page.
- [Shopify Products Scraper: Store Catalog Export to JSON, CSV](https://apify.com/rowcraft/shopify-products-scraper) — Products from any Shopify store's public catalog: title, vendor, type, tags, description, variants with price, compare-at price, SKU and stock, images, options, store currency.
- [Sitemap URL Extractor: Every Page with Last-Modified Dates](https://apify.com/rowcraft/sitemap-url-extractor) — Get every page a site lists in its sitemaps, with last-modified dates, from robots.txt through sitemap indexes and .gz files.
- [SSL Certificate and Security Headers Checker API](https://apify.com/rowcraft/ssl-security-headers-checker) — Check the TLS certificate and the HTTP security headers of every domain in one run, with an A+ to F grade and the exact issues to fix.
- [Store Products Scraper – Shopify, WooCommerce, VTEX](https://apify.com/rowcraft/store-products-scraper) — Export the product catalogue of any Shopify, WooCommerce or VTEX store from its public catalogue endpoint: title, brand, prices, discounts, stock, categories, images and links, one row per product, the same columns on every platform.
- [Structured Data Extractor: JSON-LD, Schema.org, Open Graph](https://apify.com/rowcraft/structured-data-extractor) — Pull the schema.org JSON-LD, Microdata, RDFa and Open Graph of any page list into flat rows: types, product price, availability, ratings, organization, breadcrumbs, with validation issues.
- [Teamtailor Jobs Scraper – Career Site Jobs by Company](https://apify.com/rowcraft/teamtailor-jobs-scraper) — Job listings from Teamtailor career sites by company: title, department, role, locations with city and country, remote or hybrid status, publication date and full ad text, from the official job feed.
- [TED Tenders Scraper: EU Public Procurement Notices API](https://apify.com/rowcraft/ted-tenders-scraper) — EU public procurement notices from TED (Tenders Electronic Daily), the official EU tenders portal, through its public Search API: title, buyer, country, CPV codes, values, deadlines, lots and document links.
- [UK Tenders Scraper: Find a Tender + Contracts Finder API](https://apify.com/rowcraft/uk-tenders-scraper) — UK public procurement notices from Find a Tender and Contracts Finder, the official UK government portals, through their open OCDS APIs: title, buyer, region, CPV codes, values, deadlines, notice type and links.
- [Bulk URL Status and Redirect Chain Checker API](https://apify.com/rowcraft/url-status-redirect-checker) — Check the status code, redirect chain, canonical and indexing signals of every URL in a list, with the final destination and a loop flag.
- [VTEX Products Scraper – Public Catalog Export](https://apify.com/rowcraft/vtex-products-scraper) — Export the catalogue of any VTEX store (Auchan, Chedraui and thousands of retailers in Europe and Latin America) from its public search endpoint: title, brand, EAN, prices, list prices, stock, categories, specifications and images, one row per product.
- [Website Tech Stack Detector – Technology Lookup API](https://apify.com/rowcraft/website-tech-stack-detector) — Find the technologies behind a list of websites: CMS, e-commerce platform, analytics, tag managers, ad pixels, consent tools, chat, CDN and payments, from one polite home-page request per domain.
- [WooCommerce Products Scraper – Store API Export](https://apify.com/rowcraft/woocommerce-products-scraper) — Export every product of a WooCommerce store through its public Store API: title, SKU, prices and sale prices, stock, categories, tags, attributes, ratings, images and links, one row per product.
- [Workable Jobs Scraper: Job Listings from Career Pages](https://apify.com/rowcraft/workable-jobs-scraper) — Job listings from any company's Workable career page: title, department, location, remote or on-site, employment type, description, requirements, benefits and salary when published.
- [Workday Jobs Scraper – Jobs from myworkdayjobs.com Sites](https://apify.com/rowcraft/workday-jobs-scraper) — Job listings from Workday career sites (myworkdayjobs.com) by company: title, locations, country, posting date, time type, requisition ID and the full description.

### FAQ

**Where do I get the API key, and is it free?** From the [Companies House Developer Hub](https://developer.company-information.service.gov.uk/): sign in with a Companies House account, open **Your applications**, create an application for the live environment, then **Create new key** with client type **API key**. The key is free and is shown once; paste it into `apiKey`. The same key can be reused in every run and every schedule.

**Is my key safe in the actor?** `apiKey` is a secret input field: Apify stores it encrypted and hides it in the run's input view. The actor sends it only to `api.company-information.service.gov.uk` as HTTP basic authentication, which is how the register expects it. Rowcraft never sees it.

**Why are there no directors or owners?** Rowcraft actors deliver data about companies, not about people. Officers, persons with significant control, disqualifications and appointments are separate endpoints that the actor never calls, and the people-related fields inside the endpoints it does call are removed. The company page linked in every row shows them on the register itself.

**What is the difference between a name search and the advanced search?** `searchNames` works like the search box on the register: free text, matches on current and previous names, relevance order, up to 1,000 hits per name. The advanced search uses the filters (`nameIncludes`, `statuses`, `types`, `sicCodes`, dates, `location`) and is the right tool for lists such as "active software companies in Manchester incorporated this year".

**How do SIC codes work here?** A five-digit code is used as is; a shorter prefix expands to every five-digit code that starts with it (`62` covers all computer programming, consultancy and related activities, `6201` the two programming codes). Dots are ignored, so `62.01` works too. Each row carries the codes and their official descriptions.

**Which date formats are accepted?** ISO dates (`2026-10-01`), `today`, `yesterday`, and relative periods such as `7 days`, `3 weeks`, `6 months`, `2 years`. The register's own dates come back as `YYYY-MM-DD`.

**What happens when the rate limit is hit?** The register allows 600 requests per five minutes per key. The actor paces itself under that limit and, if a `429` still arrives, stops immediately, keeps what it has delivered and marks `stoppedByRateLimit` in the run summary. Repeatedly ignoring `429` can get a key blocked, which is why the actor does not retry.

**Can I get dissolved companies?** Yes: put `dissolved` in `statuses` and, if you want a period, set `dissolvedFrom` and `dissolvedTo`. Dissolved companies come back with whatever the register still shows for them.

**What about overseas companies and UK establishments?** Company types such as `overseas-company` and `uk-establishment` are supported; the rows carry the foreign registry, registration number, legal form, governing law and, for establishments, the parent company. Their numbers start with `FC` or `BR`.

**What does Count only do?** It asks the register how many companies match (numbers, name searches and advanced search combined) and writes the count, with the cost at your plan, into the run summary. Nothing is delivered and only the start event is charged.

**Can I pay only for new companies?** Yes. Turn on **Only new rows since the last run**: the actor remembers what it delivered to you and later runs with the same state name deliver (and charge) only the new rows.

**How do I get the results into Slack, Google Sheets, Make, n8n or Zapier?** Use the Integrations tab of the Actor for the data, and the `notifyUrl` field for a message when a run ends (Slack and Discord webhooks work directly; catch hooks of Make, n8n and Zapier too).

**Can I call it from code or from an AI agent?** Yes: through the Apify API, the JavaScript and Python clients, and the Apify MCP server. The API tab shows a working example with the input of this Actor.

**Is it legal to use this data?** The actor reads the official API described in the Data source section and delivers company and job data without personal data. The licence of the source is described above. How you use the data is your responsibility under the law that applies to you.

**Does it collect personal data?** No. Contact persons, e-mails and phone numbers are removed and fields about people are never requested. See the Privacy section.

**The run finished with 0 rows. Did I pay?** No: with no rows delivered nothing is charged apart from the start event. Check the run summary (`RUN_SUMMARY`) for warnings, widen the filters, or run with **Only new rows** off if everything matching was already delivered to you.

### Support and reviews

**Problems, missing fields, questions:** open an issue on the **Issues** tab of this Actor. We answer within one working day and fix confirmed bugs in the next release; the changelog lists every change.

If this Actor saved you time, a short review on its page helps other users find it and helps us keep improving it.

# Changelog

This Actor's version history is a separate document: https://apify.com/rowcraft/uk-companies-house-scraper/changelog.md

# Actor input Schema

## `apiKey` (type: `string`):

Your own key from the Companies House Developer Hub (free: sign in → Your applications → Create an application (live) → Create new key, type API key). Stored encrypted by Apify, used only for requests to api.company-information.service.gov.uk, never logged. The key's limit is 600 requests per 5 minutes; the run stops at the first 429 to protect it.

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

Specific companies, one per line: 00445790, SC123456, or a link to a Companies House company page. Numbers without leading zeros are completed (445790 → 00445790).

## `searchNames` (type: `array`):

Free-text searches of the register, one per line (Tesco, Barclays Bank). Each search returns the best matches in Companies House order, up to the limit below.

## `maxResultsPerName` (type: `integer`):

How many matches to take from each name search (1 = only the best match).

## `nameIncludes` (type: `string`):

Advanced search: words the company name must contain (software consulting).

## `nameExcludes` (type: `string`):

Words the company name must not contain.

## `statuses` (type: `array`):

Empty = all statuses.

## `types` (type: `array`):

Empty = all types.

## `subtypes` (type: `array`):

Empty = all.

## `sicCodes` (type: `array`):

Standard Industrial Classification 2007 codes, one per line: a full code (62012 = software development) or a prefix (62 = all computer programming and consultancy codes).

## `incorporatedFrom` (type: `string`):

Earliest incorporation date: 2026-01-01, today, yesterday, or a relative value such as 30 days, 6 months, 2 years.

## `incorporatedTo` (type: `string`):

Latest incorporation date, same formats.

## `dissolvedFrom` (type: `string`):

Earliest dissolution date (use with the Dissolved status).

## `dissolvedTo` (type: `string`):

Latest dissolution date.

## `location` (type: `string`):

Town, county, postcode or part of the registered office address (Manchester, SW1A, Cardiff).

## `maxItems` (type: `integer`):

Stop after this many companies. 0 = all matching.

## `includeProfile` (type: `boolean`):

One request per company for the complete profile (accounts and confirmation statement dates, previous names, jurisdiction, flags). Off = only the search fields (name, number, status, type, dates, address, SIC codes), which costs one request per 500 companies.

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

The latest filings (date, category, type, description from the official templates, names of people removed), plus the total count.

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

How many of the latest filings to include (up to 100).

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

Counts (total, satisfied, outstanding) and the list of charges with status, dates and description. Persons entitled are not included.

## `includeInsolvency` (type: `boolean`):

Insolvency status and cases (type, dates). Practitioners are not included.

## `countOnly` (type: `boolean`):

Only count how many rows match your filters and estimate the cost at your price tier. Nothing is delivered and nothing is charged apart from the start event. Turn it off to get the data.

## `onlyNew` (type: `boolean`):

Remember the rows already delivered to you (in a key-value store in your Apify account) and deliver only rows that appeared since the last run with the same state key. The first run delivers everything that matches; later runs cost only the new rows. Ideal for schedules.

## `stateName` (type: `string`):

Name of the memory used by "Only new rows". Use a different name for each schedule or search (for example `stockholm-python`) so they do not share one memory.

## `notifyUrl` (type: `string`):

A webhook address that receives one JSON POST with the number of new rows and links to the dataset: a Slack or Discord incoming webhook, a Make, n8n or Zapier catch hook, or your own endpoint. The message is also in the `text` (Slack) and `content` (Discord) fields.

## `notifyWhenEmpty` (type: `boolean`):

By default the notification is sent only when at least one row was delivered.

## `requestIntervalMs` (type: `integer`):

Default 600 ms. The Companies House limit is 600 requests per 5 minutes per key (one every 500 ms); the minimum here is 500. The first 429 ends the run so your key is never flagged.

## Actor input object example

```json
{
  "maxResultsPerName": 10,
  "statuses": [
    "active"
  ],
  "maxItems": 50,
  "includeProfile": true,
  "includeFilingHistory": false,
  "maxFilings": 20,
  "includeCharges": false,
  "includeInsolvency": false,
  "countOnly": false,
  "onlyNew": false,
  "stateName": "default",
  "notifyWhenEmpty": false,
  "requestIntervalMs": 600
}
```

# Actor output Schema

## `results` (type: `string`):

All delivered rows in the default dataset (JSON, CSV, Excel and other formats via the dataset API).

## `runSummary` (type: `string`):

Counts, warnings and why the run stopped (RUN_SUMMARY record in the default key-value store).

# 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 = {
    "statuses": [
        "active"
    ],
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("rowcraft/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 = {
    "statuses": ["active"],
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("rowcraft/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 '{
  "statuses": [
    "active"
  ],
  "maxItems": 50
}' |
apify call rowcraft/uk-companies-house-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rowcraft/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/tsFCOh5vK6XubcV4V/builds/e9wbMG1B7uS3WFKVB/openapi.json