# SiteVerdict — UK New Companies Feed (Companies House) (`siteverdict/siteverdict-uk-new-companies-feed`) Actor

Daily feed of brand-new UK companies from the official Companies House API (your free key): filter by industry/SIC, region, postcode, name and officer count. Only new since last run, CSV and HubSpot export, Slack digest. Company data only; director names off by default.

- **URL**: https://apify.com/siteverdict/siteverdict-uk-new-companies-feed.md
- **Developed by:** [Aman Thakran](https://apify.com/siteverdict) (community)
- **Categories:** Business, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

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 New Companies Feed — fresh Companies House incorporations, every morning

**Get every brand-new UK company in your niche the day it is registered** — straight from the **official Companies House API** with your own free key. Filter by industry (plain-English keywords → SIC codes), UK region, postcode, company name and number of officers; get **only the companies you have not seen before**; export to CSV or HubSpot; get a Slack digest.

- 🗓️ **Daily delta**: schedule it and each run returns only new companies since the last run
- 🏭 **Industry in plain English**: "travel", "software", "restaurant" → official SIC 2007 codes (shown in the log)
- 📍 **Region & postcode**: London, Scotland, North West… (ITL1 regions from the postcode area) or PL1, EC1A districts
- 👥 **Officer count filter**: e.g. sole-director companies only (`maxOfficers: 1`)
- ⚡ **Streaming API option**: listen to the live Companies House stream for near real-time new incorporations
- 📤 **Exports**: CSV, HubSpot-import CSV, optional direct HubSpot company creation, Slack / webhook digest
- 🔒 **Company data only** — director names are off by default and, when on, limited to what the register publishes (name, role, appointment date)

### Who it is for

1. **B2B sales & lead generation** — accountants, banks, insurers, web agencies, payroll and SaaS selling to new businesses.
2. **Local service businesses** — new companies in your town or postcode district.
3. **Market researchers** — daily counts of new firms by sector and region.

### Example output

```json
{
  "companyNumber": "99100002",
  "companyName": "NORTHERN CODE WORKS LIMITED",
  "incorporatedOn": "2026-10-09",
  "typeLabel": "Private limited company",
  "sicCodes": ["62012", "62020"],
  "sicDescriptions": ["Business and domestic software development", "Information technology consultancy activities"],
  "registeredOffice": { "singleLine": "Unit 4 Mill Lane, Manchester, M1 1AA, England", "postcode": "M1 1AA" },
  "ukRegion": "North West",
  "activeOfficerCount": 3,
  "links": { "registerPage": "https://find-and-update.company-information.service.gov.uk/company/99100002" },
  "source": "advanced-search"
}
```

**Before:** manual searches on Companies House and copy-paste. **After:** "12 new software companies in the North West this week" in Slack at 7 am, already in HubSpot.

### How to use

1. Create a free REST API key at the Companies House Developer Hub (developer.company-information.service.gov.uk → *Your applications* → *Create an application* → *REST key*). For the Streaming source create a *Streaming* key too.
2. Paste the key, add industry keywords and regions, keep **Daily delta** on.
3. Schedule the Actor daily. Download `NEW_COMPANIES_CSV` or `HUBSPOT_COMPANIES_CSV` from the key-value store, or turn on HubSpot push with a private app token (`crm.objects.companies.write`).

No key? It runs on fictional sample companies, free.

### Pricing

| Event | Price (proposed) |
|---|---|
| New company delivered (`new-company`) | $0.002 |
| Company created in HubSpot (`hubspot-company-created`, optional) | $0.002 |

Examples: **100 new companies ≈ $0.20**; a daily feed of ~30 matches ≈ **$1.80 a month**. Companies already delivered in earlier runs are never charged again. Sample mode is free.

### Benchmark (honest summary)

Compared with new-company Actors on the Apify Store by documented features (we did not run them):

| | SiteVerdict | Typical new-company scrapers |
|---|---|---|
| Source | Official Companies House API (your free key) | Mixed; some scrape the website |
| Daily delta (never pay twice) | ✅ | Rare |
| Region / postcode district / officer-count filters | ✅ | Partial |
| Streaming API (near real-time) | ✅ | ❌ |
| HubSpot CSV + direct push | ✅ | ❌ |
| Personal data | Off by default; no DOB/addresses ever | Often directors + DOB by default |
| Price | $0.002 per company | $0.002–$0.04 per company |

Our sister Actor **SiteVerdict Companies House** covers lookups, full profiles and filing monitoring; this one is the lean, scheduled lead feed.

### FAQ

**Why do I need my own key?** It is free, and Companies House rate limits (600 requests / 5 minutes) apply per key. Your data and quota stay yours.

**How fresh is it?** Advanced search reflects the register within hours of incorporation. The Streaming API is near real-time; listen for a few minutes per run and the timepoint is saved for the next run.

**Can I get directors' emails or phone numbers?** No. Companies House does not publish them and we never harvest contact details of individuals.

### Limits

- Advanced search returns at most 10,000 results per query; wide date ranges are split automatically.
- Up to 50,000 companies per run (default 500). Officer filters need one extra API call per company (your quota, not money).
- **Max total charge:** the run stops cleanly when the next company would not fit your maximum charge. OUTPUT then has `stoppedAtMaxCharge: true` and the status message says how many matching companies were not processed. A budget used up exactly is a complete run. HubSpot creations are cut to what the budget can pay for; the rest are named in the status message and every row stays in `HUBSPOT_COMPANIES_CSV`.
- **Key problems fail loudly:** a rejected REST or stream key (401), an expired stream timepoint (416) or repeated Companies House errors end the run as FAILED with the reason in the status message, and nothing more is charged. Companies delivered before a failure are remembered, so they are never charged twice.
- Regions come from the registered-office postcode area (border areas approximate; the registered office may differ from the trading address).

### Sources & compliance

- Companies House Public Data API (REST): https://developer-specs.company-information.service.gov.uk/ ; Streaming API: https://developer-specs.company-information.service.gov.uk/streaming-api/guides/overview (read 11 Oct 2026).
- Data licence: **Open Government Licence v3.0** — "Contains public sector information licensed under the Open Government Licence v3.0." SIC descriptions and enumerations from the official companieshouse/api-enumerations repository.
- Officer data is personal data. It is **off by default**; when enabled we output only names, roles and appointment dates as published (no dates of birth, nationality, occupation or addresses). **UK GDPR/PECR:** you are the controller of any personal data you collect; you need a lawful basis (usually legitimate interests with a balancing test) and must give a privacy notice. Unsolicited marketing emails/texts to individuals (including sole traders and partnerships) need prior consent under PECR; corporate subscribers can be emailed but must be offered an opt-out.
- HubSpot push uses your private app token only to create records in your own CRM.
- Not legal advice. Not affiliated with Companies House or HubSpot.
- Support: hello@webrevenuescan.com (include the run ID).

# Changelog

This Actor's version history is a separate document: https://apify.com/siteverdict/siteverdict-uk-new-companies-feed/changelog.md

# Actor input Schema

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

Create one in ~5 minutes at developer.company-information.service.gov.uk (Your applications > Create an application > REST key). Stored encrypted, never logged or output.

## `source` (type: `string`):

<b>Advanced search</b> (recommended): companies incorporated in a date range. <b>Streaming API</b>: listens to the live Companies House change stream for a few minutes and picks out brand-new incorporations (needs a separate free stream key).

## `streamKey` (type: `string`):

Only for the Streaming API source (create a 'Streaming' key in the same developer hub). Stored encrypted.

## `sampleMode` (type: `boolean`):

Switched on automatically when no key is given.

## `incorporatedLastDays` (type: `integer`):

1 = today only. Used when no explicit dates are given.

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

Optional; overrides 'last N days'.

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

Optional; default today.

## `sicKeywords` (type: `array`):

Plain English, e.g. travel, software, restaurant, accountant, construction. Resolved to SIC 2007 codes (shown in the log).

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

Exact 5-digit codes, e.g. 62012.

## `regions` (type: `array`):

Any of: London, South East, South West, East of England, East Midlands, West Midlands, North East, North West, Yorkshire and The Humber, Wales, Scotland, Northern Ireland. Based on the registered-office postcode.

## `postcodeAreas` (type: `array`):

e.g. PL (area) or PL1 / EC1A (district).

## `nameKeywords` (type: `array`):

Case-insensitive, e.g. travel, tours, holidays.

## `excludeNameKeywords` (type: `array`):

e.g. holdings, property.

## `companyTypes` (type: `array`):

Companies House type codes: ltd, plc, llp, private-limited-guarant-nsc... Empty = all.

## `companyStatus` (type: `array`):

Usually active.

## `minOfficers` (type: `integer`):

Optional. Needs 1 extra API request per company (your key's rate limit, not money).

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

Optional, e.g. 1 = sole-director companies.

## `includeOfficerCount` (type: `boolean`):

Adds activeOfficerCount (1 extra request per company).

## `includeDirectorNames` (type: `boolean`):

OFF by default. Adds active officers' names, role and appointment date exactly as published on the public register. Never dates of birth, nationality, addresses or contact details. See the UK GDPR/PECR note in the README.

## `onlyNewSinceLastRun` (type: `boolean`):

Remembers delivered company numbers (and the stream timepoint) in a named key-value store so a daily schedule only returns new companies.

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

Use one name per feed (stored as siteverdict-ukfeed-<name>).

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

Max companies per run.

## `hubspotPush` (type: `boolean`):

OFF by default. Creates each new company in your HubSpot CRM (name, address, city, postcode, region, description). A HubSpot import CSV is always saved anyway.

## `hubspotToken` (type: `string`):

Private app with crm.objects.companies.write scope. Stored encrypted, never logged.

## `slackWebhookUrl` (type: `string`):

Optional daily digest of new matches.

## `webhookUrl` (type: `string`):

Optional HTTPS endpoint (Zapier, Make, n8n).

## `streamListenSeconds` (type: `integer`):

Stream: listen for (seconds).

## `requestsPer5Min` (type: `integer`):

Companies House allows 600 per 5 minutes per key.

## `maxConcurrency` (type: `integer`):

Reserved: requests are currently made one at a time (rate-limited per key), so this setting has no effect yet.

## Actor input object example

```json
{
  "source": "advanced-search",
  "sampleMode": false,
  "incorporatedLastDays": 7,
  "sicKeywords": [
    "software"
  ],
  "companyTypes": [
    "ltd"
  ],
  "companyStatus": [
    "active"
  ],
  "includeOfficerCount": false,
  "includeDirectorNames": false,
  "onlyNewSinceLastRun": true,
  "stateName": "default",
  "maxItems": 500,
  "hubspotPush": false,
  "streamListenSeconds": 120,
  "requestsPer5Min": 550,
  "maxConcurrency": 4
}
```

# Actor output Schema

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

No description

## `output` (type: `string`):

No description

## `files` (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 = {
    "sicKeywords": [
        "software"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("siteverdict/siteverdict-uk-new-companies-feed").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 = { "sicKeywords": ["software"] }

# Run the Actor and wait for it to finish
run = client.actor("siteverdict/siteverdict-uk-new-companies-feed").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 '{
  "sicKeywords": [
    "software"
  ]
}' |
apify call siteverdict/siteverdict-uk-new-companies-feed --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,siteverdict/siteverdict-uk-new-companies-feed"
        }
    }
}
```

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/ZgkozeyKI682vXXBQ/builds/nT5eGhN3eBcYeglQ3/openapi.json
