{ "openapi": "3.0.1", "info": { "title": "UK New Companies Feed: Companies House Incorporations", "description": "Daily feed of new UK company incorporations and dissolutions from the official Companies House register. SIC codes + descriptions, sector, registered office postcode, company type. Filter by SIC, postcode, keyword; 'new since last run' mode. No API key.", "version": "0.1", "x-build-id": "AZC9f54dFBVhJJGZy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/moment-data~uk-new-companies-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-moment-data-uk-new-companies-feed", "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/moment-data~uk-new-companies-feed/runs": { "post": { "operationId": "runs-sync-moment-data-uk-new-companies-feed", "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/moment-data~uk-new-companies-feed/run-sync": { "post": { "operationId": "run-sync-moment-data-uk-new-companies-feed", "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": { "mode": { "title": "Mode", "enum": [ "window", "sinceLastRun" ], "type": "string", "description": "window (default): companies incorporated / dissolved in the last N days ending yesterday (UTC). sinceLastRun: only companies not delivered before for this State key (re-checks the last 3 days by default).", "default": "window" }, "eventTypes": { "title": "Events", "type": "array", "description": "Which register events to return.", "items": { "type": "string", "enum": [ "newIncorporations", "dissolutions" ], "enumTitles": [ "New incorporations", "Dissolutions (struck off / dissolved)" ] }, "default": [ "newIncorporations", "dissolutions" ] }, "daysBack": { "title": "Days back", "minimum": 1, "maximum": 31, "type": "integer", "description": "Number of days in the window, ending yesterday or at Date (default 1; 3 in sinceLastRun). Roughly 2,000-4,000 new incorporations per weekday." }, "date": { "title": "Window end date (optional)", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "YYYY-MM-DD. Last day of the window, for backfills. Default: yesterday (UTC)." }, "sicPrefixes": { "title": "SIC code prefixes", "type": "array", "description": "Keep companies with any SIC 2007 code starting with these digits, e.g. \"62\" (IT), \"56101\" (restaurants), \"4120\" (construction of buildings).", "items": { "type": "string" } }, "sicSections": { "title": "SIC sections", "type": "array", "description": "SIC 2007 section letters A-U, e.g. F (construction), I (accommodation & food), J (information & communication), M (professional services), Q (health).", "items": { "type": "string" } }, "postcodePrefixes": { "title": "Postcode prefixes", "type": "array", "description": "Registered-office postcode area or district, e.g. \"M\" (Manchester), \"EC1\", \"BS\", \"G\". A letters-only prefix matches the whole area (\"M\" does not match \"ML\").", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Keep companies whose name or SIC description contains any of these words (case-insensitive).", "items": { "type": "string" } }, "excludeKeywords": { "title": "Exclude name keywords", "type": "array", "description": "Drop companies whose name contains any of these words, e.g. \"HOLDINGS\", \"PROPERTY\".", "items": { "type": "string" } }, "companyTypes": { "title": "Company types", "type": "array", "description": "Restrict to these Companies House company types (default: all).", "items": { "type": "string", "enum": [ "ltd", "plc", "llp", "private-limited-guarant-nsc", "private-limited-guarant-nsc-limited-exemption", "private-limited-shares-section-30-exemption", "private-unlimited", "private-unlimited-nsc", "limited-partnership", "scottish-partnership", "charitable-incorporated-organisation", "scottish-charitable-incorporated-organisation", "registered-society-non-jurisdictional", "industrial-and-provident-society", "royal-charter", "uk-establishment", "registered-overseas-entity", "oversea-company", "european-public-limited-liability-company-se", "converted-or-closed", "protected-cell-company", "assurance-company", "old-public-company", "icvc-securities", "eeig", "further-education-or-sixth-form-college-corporation", "unregistered-company", "other" ], "enumTitles": [ "Private limited company", "Public limited company", "Limited liability partnership", "Private company limited by guarantee (no share capital)", "Private company limited by guarantee ('Limited' exemption)", "Private limited company ('Limited' exemption)", "Private unlimited company", "Private unlimited company (no share capital)", "Limited partnership", "Scottish qualifying partnership", "Charitable incorporated organisation", "Scottish charitable incorporated organisation", "Registered society", "Industrial and provident society", "Royal charter company", "UK establishment of an overseas company", "Registered overseas entity", "Overseas company", "European public limited company (SE)", "Converted / closed", "Protected cell company", "Assurance company", "Old public company", "Investment company with variable capital", "European economic interest grouping", "Further education / sixth form college corporation", "Unregistered company", "Other" ] } }, "excludeDormant": { "title": "Exclude dormant (SIC 99999)", "type": "boolean", "description": "Skip companies whose SIC code is 99999 'Dormant company'.", "default": true }, "includePersonNamedCompanies": { "title": "Include person-named companies", "type": "boolean", "description": "By default companies named only after a person (e.g. \"JOHN SMITH LTD\") are skipped as a privacy screen. Set true to include them.", "default": false }, "maxItems": { "title": "Max records", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Cap per run (also caps your spend). Default 30.", "default": 30 }, "stateKey": { "title": "State key (sinceLastRun)", "type": "string", "description": "Name of the saved state. Use a different key for each saved search.", "default": "default" } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }