{ "openapi": "3.0.1", "info": { "title": "UK New Companies Feed: Companies House Daily", "description": "Get newly incorporated UK companies from the official Companies House API, yesterday by default. Filter by date range, sector presets, SIC codes, location or postcode, and get company number, name, status, type, SIC codes with descriptions, registered office address and a Companies House link.", "version": "1.0", "x-build-id": "aigNHNs9T8FTeTLgZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/offerastudio~uk-new-companies-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-offerastudio-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/offerastudio~uk-new-companies-feed/runs": { "post": { "operationId": "runs-sync-offerastudio-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/offerastudio~uk-new-companies-feed/run-sync": { "post": { "operationId": "run-sync-offerastudio-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": { "apiKey": { "title": "Companies House API key", "type": "string", "description": "Your free REST API key from the Companies House Developer Hub (developer.company-information.service.gov.uk: register, create an application, create an API key). It is stored encrypted. Leave it empty to use the Actor owner's default key if one is set, or to see sample data." }, "incorporatedFrom": { "title": "Incorporated from", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$", "type": "string", "description": "First incorporation date (UK date), e.g. 2026-09-01, or a relative date like \"7 days\" (7 days ago). Leave both dates empty for yesterday's new companies. With only this date set, the range runs to today. At most 366 days per run." }, "incorporatedTo": { "title": "Incorporated to", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$", "type": "string", "description": "Last incorporation date (UK date), inclusive. Companies House usually lists a day's new companies by the next morning." }, "sectors": { "title": "Sectors", "type": "array", "description": "Ready-made groups of SIC codes, for example Tech = software development, IT consultancy, data processing and web portals. Combined with the SIC codes below: a company matches if it has any of the codes.", "items": { "type": "string", "enum": [ "tech", "construction", "food", "hospitality", "beauty", "ecommerce", "retail", "real-estate", "consulting", "accounting-legal", "marketing", "creative-media", "health", "fitness", "transport-logistics", "finance", "education", "cleaning", "automotive", "recruitment", "care-services" ], "enumTitles": [ "Tech: software, IT services, data and web", "Construction and building trades", "Food and drink: production, food shops, restaurants, takeaways, pubs", "Hospitality: hotels, holiday lets, restaurants, bars", "Beauty, hair and wellbeing", "Online retail (e-commerce)", "Shops and retail", "Real estate: letting, buying and selling, agents", "Management consultancy and PR", "Accounting, bookkeeping, tax and legal", "Marketing, advertising and market research", "Creative and media: design, photography, film, music, arts", "Health care", "Fitness and sport", "Transport, delivery and storage", "Finance and insurance", "Education and training", "Cleaning services", "Motor trade and car repair", "Recruitment and staffing", "Care homes, home care and childcare" ] } }, "sicCodes": { "title": "SIC codes", "type": "array", "description": "SIC 2007 codes as used by Companies House: 5 digits (62012) or a prefix of 2 to 4 digits (62 = every code starting with 62). Leave empty, together with Sectors, for all industries.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Passed to Companies House's own location filter, which searches the registered office address, e.g. Manchester or Cardiff." }, "postcodePrefixes": { "title": "Postcode prefixes", "type": "array", "description": "Keep only companies whose registered office postcode starts with one of these: an area (M = Manchester area, not ME), a district (M1, SW1A) or a longer start (SW1A 1).", "items": { "type": "string" } }, "companyStatus": { "title": "Company status", "type": "array", "description": "Default: active. New companies are almost always active.", "items": { "type": "string", "enum": [ "active", "dissolved", "liquidation", "receivership", "administration", "voluntary-arrangement", "insolvency-proceedings", "converted-closed", "open", "closed", "registered", "removed" ], "enumTitles": [ "Active", "Dissolved", "Liquidation", "Receiver action", "In administration", "Voluntary arrangement", "Insolvency proceedings", "Converted / closed", "Open", "Closed", "Registered", "Removed" ] }, "default": [ "active" ] }, "companyTypes": { "title": "Company types", "type": "array", "description": "Leave empty for all types, or pick e.g. Private limited company and Limited liability partnership.", "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", "old-public-company", "converted-or-closed", "protected-cell-company", "assurance-company", "oversea-company", "eeig", "icvc-securities", "icvc-warrant", "icvc-umbrella", "investment-company-with-variable-capital", "northern-ireland", "northern-ireland-other", "royal-charter", "unregistered-company", "european-public-limited-liability-company-se", "uk-establishment", "further-education-or-sixth-form-college-corporation", "registered-overseas-entity", "other" ], "enumTitles": [ "Private limited company", "Public limited company", "Limited liability partnership", "Private limited by guarantee without share capital", "Private limited by guarantee without share capital, use of 'Limited' exemption", "Private limited company, use of 'Limited' exemption", "Private unlimited company", "Private unlimited company without share capital", "Limited partnership", "Scottish qualifying partnership", "Charitable incorporated organisation", "Scottish charitable incorporated organisation", "Registered society", "Industrial and provident society", "Old public company", "Converted or closed", "Protected cell company", "Assurance company", "Overseas company", "European Economic Interest Grouping (EEIG)", "Investment company with variable capital", "Investment company with variable capital", "Investment company with variable capital", "Investment company with variable capital", "Northern Ireland company", "Credit union (Northern Ireland)", "Royal charter company", "Unregistered company", "European public limited liability company (SE)", "UK establishment company", "Further education or sixth form college corporation", "Overseas entity", "Other company type" ] } }, "companyNameIncludes": { "title": "Company name includes", "type": "string", "description": "Optional word the company name must contain, e.g. BAKERY." }, "maxResults": { "title": "Maximum companies", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many companies (newest days first). Each company returned costs $0.002.", "default": 100 }, "includeOfficers": { "title": "Include officers' names and roles (personal data)", "type": "boolean", "description": "Adds the current officers of each company: only the name and role (e.g. Director) as published on the public register. No dates of birth, nationalities or addresses. Names are personal data under UK GDPR: you are responsible for having a lawful basis and for how you use them. Costs one extra API request per company, so runs are slower; the price stays $0.002 per company.", "default": false }, "useSampleDataWithoutKey": { "title": "Show sample data when no API key is set", "type": "boolean", "description": "Without a key, return 10 made-up sample companies (clearly marked isSampleData = true) so you can see the output format. Sample rows are free.", "default": true } } }, "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 } } } } } } } } } }