# UK Companies & Directors by Industry — Lead Generation (`quiet_scooter/uk-companies-by-industry`) Actor
Build UK B2B lead lists in seconds. Search the official Companies House registry by industry (SIC code), location, status & date — then enrich with active directors ready for outreach. No subscription, pay only for results.
- **URL**: https://apify.com/quiet\_scooter/uk-companies-by-industry.md
- **Developed by:** [Devin](https://apify.com/quiet_scooter) (community)
- **Categories:** Lead generation, Automation
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
$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/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## UK Companies & Directors by Industry 🇬🇧
**Build UK B2B lead lists in seconds.** Search the official Companies House registry by industry code, location, status, and date — then enrich every result with **active directors** ready for outreach. Pay only for what you use. No subscription.
> 💡 **Better than a scraper.** This Actor uses the **official Companies House API**, so data is live, accurate, and won't break when the website changes. Other "Companies House scrapers" on this store scrape HTML — slower, less reliable, and often missing fields.
---
### ⭐ Why use this Actor
Most UK Companies House scrapers make you start with a list of company names or a search URL. That's fine if you already know who you're looking for — but useless for prospecting.
**This Actor lets you discover companies you've never heard of.** Type an industry code (`43220` = plumbers) and a location (`Manchester`) and you'll get every active UK company that matches, with their decision-makers attached.
#### What makes this different
| Feature | This Actor | Other UK Companies House Actors |
| --- | --- | --- |
| Search by **industry (SIC code)** | ✅ Built-in | ❌ Need to construct a URL manually |
| Filter by **location** | ✅ Built-in | ❌ Need to construct a URL manually |
| Filter by **company status** | ✅ Built-in | ❌ Need to construct a URL manually |
| Filter by **incorporation date** | ✅ Built-in | Sometimes |
| **Active-only** director filter | ✅ | ❌ |
| **One row per director** (for mail-merge) | ✅ | ❌ |
| Pricing | **Pay per result, no minimum** | Mostly $20–30/month subscription |
| Setup time | 60 seconds (free API key) | 60 seconds |
---
### 📊 What you get per company
- Company name & registration number
- Registered office address (full, with postcode)
- All SIC codes (industry classifications)
- Company status (active, dissolved, etc.)
- Company type (Ltd, PLC, LLP)
- Incorporation date
- Direct link to the official Companies House record
**With director enrichment turned on, every row also gets:**
- Director full name & role (director / secretary / LLP member)
- Date of appointment
- Occupation (when registered)
- Nationality & country of residence
- Date of birth (year + month, as published by Companies House)
- Director's registered correspondence address
Export as **JSON, CSV, Excel, or XML** — or pipe straight into your CRM, Make/Zapier/n8n workflow, or another Actor.
---
### 🎯 Example use cases
#### Lead-gen agency targeting trades
> **Target:** Active UK plumbing companies in Greater Manchester incorporated in the last 3 years, with current directors for cold outreach.
> **Input:** `SIC codes: 43220`, `Location: Manchester`, `Incorporated from: 2023-01-01`, `Include directors: ☑`, `Active directors only: ☑`, `One row per director: ☑`
> **Result:** A mail-merge-ready CSV with director names, occupations, and addresses.
#### Recruitment firm
> **Target:** Every active solicitors' firm in Birmingham, with managing partners' details.
> **Input:** `SIC codes: 69102`, `Location: Birmingham`, `Include directors: ☑`
#### Competitor analysis / market sizing
> **Target:** All active UK web development companies.
> **Input:** `SIC codes: 62012, 62020, 63120`, `Status: Active`
#### New business pipeline for accountants
> **Target:** Companies incorporated this month — they all need an accountant.
> **Input:** `Incorporated from: 2026-05-01`, `Status: Active`, `Include directors: ☑`
#### Distressed-asset / M&A sourcing
> **Target:** Companies in administration in your sector.
> **Input:** `SIC codes: [your industry]`, `Status: Administration, Liquidation`
---
### ⚡ Getting started (under 2 minutes)
#### Step 1 — Get a free Companies House API key (60 sec)
> 📘 **Follow the [60-second API key setup guide](./API_KEY_SETUP.md)** in the Information tab.
**TL;DR:** Register at [find-and-update.company-information.service.gov.uk/signin](https://find-and-update.company-information.service.gov.uk/signin) → create a **Live** application → generate a **REST** key → paste it into the Actor.
The key is free, never expires, and supports 600 requests every 5 minutes — far more than you'll ever need.
#### Step 2 — Run the Actor
1. Paste your API key into the **Companies House API key** field
2. Choose your filters (SIC code, location, etc.)
3. *(Optional)* Tick **Include directors** to enrich every row with decision-makers
4. Click **Start** — your data appears in the **Output** tab
---
### 🏭 SIC code reference
SIC stands for **Standard Industrial Classification**. Every UK company is assigned one or more 5-digit SIC codes describing what they do.
#### 🔨 Construction & trades
| SIC Code | Industry |
| --- | --- |
| 41100 | Development of building projects |
| 41201 | Construction of commercial buildings |
| 41202 | Construction of domestic buildings |
| 43110 | Demolition |
| 43120 | Site preparation |
| 43210 | Electrical installation |
| 43220 | Plumbing, heat & air-conditioning installation |
| 43290 | Other construction installation |
| 43310 | Plastering |
| 43320 | Joinery installation |
| 43330 | Floor and wall covering |
| 43341 | Painting |
| 43342 | Glazing |
| 43390 | Other building completion and finishing |
| 43910 | Roofing activities |
| 43991 | Scaffold erection |
| 43999 | Other specialised construction activities |
#### 🏠 Property & real estate
| SIC Code | Industry |
| --- | --- |
| 41100 | Development of building projects |
| 68100 | Buying and selling of own real estate |
| 68201 | Renting and operating of Housing Association real estate |
| 68202 | Letting and operating of conference and exhibition centres |
| 68209 | Other letting and operating of own or leased real estate |
| 68310 | Real estate agencies |
| 68320 | Management of real estate on a fee or contract basis |
#### 🍽️ Food, hospitality & retail
| SIC Code | Industry |
| --- | --- |
| 47110 | Retail sale in non-specialised stores (supermarkets) |
| 47220 | Retail sale of meat and meat products |
| 47710 | Retail sale of clothing |
| 47910 | Retail sale via mail order houses or via Internet |
| 55100 | Hotels and similar accommodation |
| 55201 | Holiday centres and villages |
| 55300 | Campsites |
| 56101 | Licensed restaurants |
| 56102 | Unlicensed restaurants and cafes |
| 56103 | Take-away food shops and mobile food stands |
| 56210 | Event catering activities |
| 56301 | Licensed clubs |
| 56302 | Public houses and bars |
#### 💻 Tech, IT & digital
| SIC Code | Industry |
| --- | --- |
| 62011 | Ready-made interactive leisure and entertainment software |
| 62012 | Business and domestic software development |
| 62020 | Information technology consultancy activities |
| 62030 | Computer facilities management activities |
| 62090 | Other information technology service activities |
| 63110 | Data processing, hosting and related activities |
| 63120 | Web portals |
#### 📈 Professional services
| SIC Code | Industry |
| --- | --- |
| 69101 | Barristers at law |
| 69102 | Solicitors |
| 69109 | Activities of patent and copyright agents |
| 69201 | Accounting and auditing activities |
| 69202 | Bookkeeping activities |
| 69203 | Tax consultancy |
| 70210 | Public relations and communications activities |
| 70221 | Financial management |
| 70229 | Management consultancy activities (other) |
| 73110 | Advertising agencies |
| 73120 | Media representation services |
| 73200 | Market research and public opinion polling |
| 74201 | Portrait photographic activities |
| 74202 | Other specialist photography |
| 74300 | Translation and interpretation activities |
| 74909 | Other professional, scientific and technical activities |
#### 🏥 Healthcare & wellbeing
| SIC Code | Industry |
| --- | --- |
| 86101 | Hospital activities |
| 86210 | General medical practice activities |
| 86220 | Specialists medical practice activities |
| 86230 | Dental practice activities |
| 86900 | Other human health activities |
| 87100 | Residential nursing care activities |
| 96020 | Hairdressing and other beauty treatment |
| 96040 | Physical well-being activities |
#### 🚚 Transport & logistics
| SIC Code | Industry |
| --- | --- |
| 49410 | Freight transport by road |
| 49420 | Removal services |
| 52100 | Warehousing and storage |
| 52211 | Operation of rail freight terminals |
| 53201 | Licensed carriers |
| 53202 | Unlicensed carriers |
#### 🛠️ Manufacturing (common)
| SIC Code | Industry |
| --- | --- |
| 10710 | Manufacture of bread; fresh pastry and cakes |
| 14130 | Manufacture of other outerwear |
| 25110 | Manufacture of metal structures |
| 25120 | Manufacture of doors and windows of metal |
| 31090 | Manufacture of other furniture |
| 32500 | Manufacture of medical and dental instruments |
**Can't find your industry?** Browse the full list at the [ONS SIC 2007 reference](https://resources.companieshouse.gov.uk/sic/) (~700 codes in total).
---
### 📋 Output examples
#### Default mode (companies only)
```json
{
"companyName": "RICHARDS SIMMONS HEATING LTD",
"companyNumber": "11712768",
"companyStatus": "active",
"companyType": "ltd",
"dateOfCreation": "2018-12-05",
"sicCodes": "43220",
"addressLine1": "10 Example Street",
"locality": "Manchester",
"postalCode": "M46 0EF",
"country": "England",
"companiesHouseUrl": "https://find-and-update.company-information.service.gov.uk/company/11712768"
}
````
#### With directors, one row per company
```json
{
"companyName": "RICHARDS SIMMONS HEATING LTD",
"companyNumber": "11712768",
"...": "(company fields as above)",
"directorCount": 3,
"directors": "RICHARDS, Mark Daniel (director); RICHARDS, Thomas William (director); SIMMONS, Matthew David (director)",
"primaryDirectorName": "RICHARDS, Mark Daniel",
"primaryDirectorRole": "director",
"primaryDirectorAppointedOn": "2018-12-05",
"primaryDirectorNationality": "British",
"primaryDirectorDateOfBirthYear": 1987
}
```
#### With directors, one row per director (mail-merge ready)
Each director becomes their own row, with full company data duplicated. A company with 3 directors → 3 rows.
```json
{
"companyName": "RICHARDS SIMMONS HEATING LTD",
"companyNumber": "11712768",
"directorName": "RICHARDS, Mark Daniel",
"directorRole": "director",
"directorAppointedOn": "2018-12-05",
"directorNationality": "British",
"directorDateOfBirthYear": 1987,
"directorAddressLocality": "Manchester",
"directorAddressPostalCode": "M46 0EF"
}
```
***
### ⚙️ Performance notes
- **Companies-only mode:** ~30 results/sec. 1,000 companies in ~30 seconds.
- **With director enrichment:** ~3 results/sec. 1,000 companies (with avg 2 directors each) in ~7 minutes.
- The Companies House API caps any single search at **~10,000 results**. For larger jobs, split your search by location or date range.
- Data is pulled **live** from Companies House — no stale caches.
- Only **publicly available** information is fetched (everything Companies House publishes openly under the Open Government Licence v3.0).
***
### 🔗 Works with everything
The output is standard structured data, so you can plug it into:
- **CRMs:** HubSpot, Salesforce, Pipedrive (via CSV import)
- **Outreach tools:** Lemlist, Instantly, Apollo (via CSV import)
- **Workflow tools:** Make, Zapier, n8n (via Apify integration)
- **Spreadsheets:** Excel, Google Sheets, Numbers (via CSV / Excel export)
- **Your own scripts:** JSON / XML / API access
***
### 🛡️ Compliance
- Companies House data is published under the **[Open Government Licence v3.0](https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/)** — free for commercial use.
- This Actor calls the official Companies House public API. It does not scrape, bypass any access controls, or access non-public data.
- For outreach using director data, follow **UK GDPR** rules — particularly the legitimate-interest basis for B2B outreach and the right to unsubscribe.
***
### ❓ FAQ
Is the Companies House API really free?
Yes. It's a free public service provided by the UK government. There's no card to enter, no usage fee, and no paid tier. You can make up to 600 requests every 5 minutes — far more than you'll need.
How accurate is the data?
Same accuracy as the source — Companies House itself. Director names, addresses, status, and dates are exactly what's filed with the UK government. Note: occupation is often blank because most directors don't fill it in when registering.
Can I use this for cold email outreach?
Yes for B2B outreach to legal-entity directors under UK GDPR legitimate interest, with clear opt-out. Always honour unsubscribe requests and don't use it to mass-spam consumers.
What if I need more than 10,000 companies?
Split your search by location (e.g. one run per UK region) or date range, then merge the datasets. Companies House's 10k cap applies per search, not per Actor run.
What's the difference between 'companies only' and 'with directors' pricing?
Companies-only mode charges per company returned. With-directors mode charges per *row* returned — so if 'one row per director' is on and a company has 3 directors, you're charged for 3 rows. This naturally aligns price with value delivered.
Can I get filing history or persons with significant control (PSC) data?
Not yet — but I'm actively developing this Actor. Open an issue on the Actor's Issues tab if you'd like these added, or message me directly. Common requests get prioritised.
***
### 🛠️ Found a bug or want a feature?
Open an issue on the Actor's **Issues** tab, or message me through the Apify platform. Most issues are responded to within a day.
***
*Built for UK B2B sales teams, recruiters, market researchers, and anyone who needs to turn "I want to talk to plumbers in Manchester" into a clean CSV in seconds.*
# Actor input Schema
## `sicCodes` (type: `array`):
One or more 5-digit Standard Industrial Classification codes. Examples: '43220' = plumbing, heating and air-conditioning installation; '43210' = electrical installation; '43910' = roofing activities; '68310' = real estate agencies. See the Actor README for a full reference list.
## `location` (type: `string`):
Filter by registered office location. Accepts town, city, county, region, or postcode (e.g. 'London', 'Manchester', 'Surrey', 'SW1A').
## `companyStatus` (type: `array`):
Which company statuses to include. 'Active' is the default and what you'll want for B2B outreach.
## `incorporatedFrom` (type: `string`):
Only return companies incorporated on or after this date. Format: YYYY-MM-DD. Useful for finding newly registered businesses.
## `incorporatedTo` (type: `string`):
Only return companies incorporated on or before this date. Format: YYYY-MM-DD.
## `companyNameIncludes` (type: `string`):
Optional keyword that must appear in the company name (e.g. 'plumbing', 'electrical', 'consulting').
## `maxResults` (type: `integer`):
Maximum number of companies to return. The Companies House API caps the total at ~10,000 per search — if you need more, split your search by location or date range.
## `includeDirectors` (type: `boolean`):
Enrich each company with director names, roles, dates of appointment, and occupations. Perfect for sales outreach, recruitment, and decision-maker research. ⚠️ Adds one extra API call per company, so 1,000 companies takes ~5–10 minutes instead of ~1 minute.
## `activeDirectorsOnly` (type: `boolean`):
Exclude directors who have resigned. Recommended for outreach — you only want to contact people still at the company. Only used if 'Include directors' is on.
## `oneRowPerDirector` (type: `boolean`):
If a company has 3 directors, return 3 rows instead of 1. Each row has the full company data plus one director. Ideal for importing straight into CRMs and email-outreach tools. If off, the row contains a 'directors' summary column plus the primary director's details. Only used if 'Include directors' is on.
## `companiesHouseApiKey` (type: `string`):
Paste your free Companies House API key here. 👉 Don't have one yet? Follow the 60-second setup guide in the Information tab. The key is stored privately in your Apify account and is only sent to Companies House to authenticate your data requests.
## Actor input object example
```json
{
"sicCodes": [
"43220"
],
"location": "Manchester",
"companyStatus": [
"active"
],
"incorporatedFrom": "2024-01-01",
"incorporatedTo": "2025-12-31",
"maxResults": 1000,
"includeDirectors": false,
"activeDirectorsOnly": true,
"oneRowPerDirector": false
}
```
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"sicCodes": [
"43220"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("quiet_scooter/uk-companies-by-industry").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "sicCodes": ["43220"] }
# Run the Actor and wait for it to finish
run = client.actor("quiet_scooter/uk-companies-by-industry").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"sicCodes": [
"43220"
]
}' |
apify call quiet_scooter/uk-companies-by-industry --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=quiet_scooter/uk-companies-by-industry",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "UK Companies & Directors by Industry — Lead Generation",
"description": "Build UK B2B lead lists in seconds. Search the official Companies House registry by industry (SIC code), location, status & date — then enrich with active directors ready for outreach. No subscription, pay only for results.",
"version": "0.1",
"x-build-id": "yDgO9SPtro8TFUrTv"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/quiet_scooter~uk-companies-by-industry/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-quiet_scooter-uk-companies-by-industry",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/quiet_scooter~uk-companies-by-industry/runs": {
"post": {
"operationId": "runs-sync-quiet_scooter-uk-companies-by-industry",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/quiet_scooter~uk-companies-by-industry/run-sync": {
"post": {
"operationId": "run-sync-quiet_scooter-uk-companies-by-industry",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"companiesHouseApiKey"
],
"properties": {
"sicCodes": {
"title": "SIC codes (industry)",
"uniqueItems": true,
"type": "array",
"description": "One or more 5-digit Standard Industrial Classification codes. Examples: '43220' = plumbing, heating and air-conditioning installation; '43210' = electrical installation; '43910' = roofing activities; '68310' = real estate agencies. See the Actor README for a full reference list.",
"items": {
"type": "string"
}
},
"location": {
"title": "Location",
"type": "string",
"description": "Filter by registered office location. Accepts town, city, county, region, or postcode (e.g. 'London', 'Manchester', 'Surrey', 'SW1A')."
},
"companyStatus": {
"title": "Company status",
"uniqueItems": true,
"type": "array",
"description": "Which company statuses to include. 'Active' is the default and what you'll want for B2B outreach.",
"items": {
"type": "string",
"enum": [
"active",
"dissolved",
"liquidation",
"receivership",
"administration",
"voluntary-arrangement",
"converted-closed",
"insolvency-proceedings",
"registered",
"removed",
"open",
"closed"
],
"enumTitles": [
"Active",
"Dissolved",
"Liquidation",
"Receivership",
"Administration",
"Voluntary arrangement",
"Converted / closed",
"Insolvency proceedings",
"Registered",
"Removed",
"Open",
"Closed"
]
},
"default": [
"active"
]
},
"incorporatedFrom": {
"title": "Incorporated from (date)",
"type": "string",
"description": "Only return companies incorporated on or after this date. Format: YYYY-MM-DD. Useful for finding newly registered businesses."
},
"incorporatedTo": {
"title": "Incorporated to (date)",
"type": "string",
"description": "Only return companies incorporated on or before this date. Format: YYYY-MM-DD."
},
"companyNameIncludes": {
"title": "Company name contains",
"type": "string",
"description": "Optional keyword that must appear in the company name (e.g. 'plumbing', 'electrical', 'consulting')."
},
"maxResults": {
"title": "Maximum results",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "Maximum number of companies to return. The Companies House API caps the total at ~10,000 per search — if you need more, split your search by location or date range.",
"default": 1000
},
"includeDirectors": {
"title": "🎯 Include directors (premium — best for B2B outreach)",
"type": "boolean",
"description": "Enrich each company with director names, roles, dates of appointment, and occupations. Perfect for sales outreach, recruitment, and decision-maker research. ⚠️ Adds one extra API call per company, so 1,000 companies takes ~5–10 minutes instead of ~1 minute.",
"default": false
},
"activeDirectorsOnly": {
"title": "Active directors only",
"type": "boolean",
"description": "Exclude directors who have resigned. Recommended for outreach — you only want to contact people still at the company. Only used if 'Include directors' is on.",
"default": true
},
"oneRowPerDirector": {
"title": "One row per director (flat layout for mail-merge)",
"type": "boolean",
"description": "If a company has 3 directors, return 3 rows instead of 1. Each row has the full company data plus one director. Ideal for importing straight into CRMs and email-outreach tools. If off, the row contains a 'directors' summary column plus the primary director's details. Only used if 'Include directors' is on.",
"default": false
},
"companiesHouseApiKey": {
"title": "Companies House API key (free — 60 sec setup)",
"type": "string",
"description": "Paste your free Companies House API key here. 👉 Don't have one yet? Follow the 60-second setup guide in the Information tab. The key is stored privately in your Apify account and is only sent to Companies House to authenticate your data requests."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```