{ "openapi": "3.0.1", "info": { "title": "UK Companies House New Companies + Contacts Finder", "description": "Newly incorporated UK companies from Companies House — filtered by SIC code, region and incorporation date — with directors and the website, email and phone the register does not publish. Weekly feed for accountants, banks, insurers, SaaS and agencies. Monitoring mode returns only what is new.", "version": "0.1", "x-build-id": "wlHjWBJb2sppupATv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/northvane~uk-companies-house-new-companies-contacts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-northvane-uk-companies-house-new-companies-contacts", "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/northvane~uk-companies-house-new-companies-contacts/runs": { "post": { "operationId": "runs-sync-northvane-uk-companies-house-new-companies-contacts", "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/northvane~uk-companies-house-new-companies-contacts/run-sync": { "post": { "operationId": "run-sync-northvane-uk-companies-house-new-companies-contacts", "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", "properties": { "lastNDays": { "title": "Incorporated in the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Companies incorporated within this many days of today. Ignored when explicit dates are given below. With the free bulk snapshot (no API key) the window is relative to the snapshot date, which is monthly.", "default": 7 }, "incorporatedFrom": { "title": "Incorporated from (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Explicit start date. Overrides lastNDays." }, "incorporatedTo": { "title": "Incorporated to (YYYY-MM-DD)", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Explicit end date (inclusive)." }, "sicCodes": { "title": "SIC codes", "type": "array", "description": "UK SIC 2007 codes or prefixes, one per line: `62012` (software development), `43` (all construction), `56101` (restaurants). Empty = every industry.", "items": { "type": "string" } }, "regions": { "title": "Regions", "type": "array", "description": "Post town, county, country or postcode prefix, one per line: `London`, `Manchester`, `Greater Manchester`, `SW1`, `Scotland`. Matched against the registered office address. Empty = all of the UK.", "default": [], "items": { "type": "string" } }, "companyStatus": { "title": "Company status", "enum": [ "active", "dissolved", "liquidation", "any" ], "type": "string", "description": "`active` is what you want for a lead feed.", "default": "active" }, "excludeDormant": { "title": "Exclude dormant companies", "type": "boolean", "description": "Drop SIC 99999 / dormant registrations — the single largest junk bucket in new incorporations.", "default": true }, "includeOfficers": { "title": "Include directors / officers", "type": "boolean", "description": "Adds current officers (name, role, appointed date, nationality, occupation). Needs a Companies House API key.", "default": true }, "enrichContacts": { "title": "Find website, email and phone", "type": "boolean", "description": "The register publishes no contact details. When on, the Actor guesses the company's domain from its name, verifies the page actually names the company, and extracts published emails, phones, socials and booking links. Confidence is reported per row; nothing is guessed without verification.", "default": true }, "checkEmailMx": { "title": "Check email domains have MX records", "type": "boolean", "description": "Cheap deliverability signal on every address found.", "default": true }, "maxCompanies": { "title": "Max companies", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop after this many matching companies.", "default": 200 }, "companiesHouseApiKey": { "title": "Companies House API key (optional)", "type": "string", "description": "Your own free REST API key from developer.company-information.service.gov.uk. Gives day-fresh results and officers, and your own rate limit (600 requests / 5 min). Without it the Actor uses the free monthly bulk snapshot (no officers, up to a month stale)." }, "dataSource": { "title": "Data source", "enum": [ "auto", "api", "bulk" ], "type": "string", "description": "`auto` = API when a key is available, else the bulk snapshot.", "default": "auto" }, "monitoringMode": { "title": "Monitoring mode (only new since last run)", "type": "boolean", "description": "Remembers every company number already returned and skips it next time. Schedule the Actor weekly and you get a clean feed of what is new.", "default": false }, "maxConcurrency": { "title": "Concurrency for website checks", "minimum": 1, "maximum": 30, "type": "integer", "description": "How many companies are enriched in parallel.", "default": 10 }, "proxyConfiguration": { "title": "Proxy for website checks (optional)", "type": "object", "description": "Not needed for the register itself. Only for the website-discovery fetches, if many come back blocked." } } }, "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 } } } } } } } } } }