{ "openapi": "3.0.1", "info": { "title": "UK Business Data Scraper: 1.4M Organisations, Renewal Dates", "description": "Extract UK business data from the official ICO register: 1.4M organisations with annual renewal dates, verified size tiers, postcodes and trading names. Includes limited companies, sole traders and charities. Filter by expiry, tier, postcode area or name. Updated daily, no API key.", "version": "0.1", "x-build-id": "clNvkGJGNW5nCDQuj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/uksignals~ico-signals/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-uksignals-ico-signals", "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/uksignals~ico-signals/runs": { "post": { "operationId": "runs-sync-uksignals-ico-signals", "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/uksignals~ico-signals/run-sync": { "post": { "operationId": "run-sync-uksignals-ico-signals", "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": { "expiringWithinDays": { "title": "Registration expires within (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only return organisations whose ICO registration ends within this many days. Registration is annual and mandatory, so this is a renewal window. Leave empty for no date filter." }, "tiers": { "title": "Payment tier", "type": "array", "description": "Tier 1 = micro/small. Tier 2 = more than 10 staff or ~£632k turnover. Tier 3 = more than 250 staff or ~£36m turnover. Tier is a reliable size proxy.", "items": { "type": "string", "enum": [ "Tier 1", "Tier 2", "Tier 3" ], "enumTitles": [ "Tier 1 (micro / small)", "Tier 2 (10+ staff or ~£632k+ turnover)", "Tier 3 (250+ staff or ~£36m+ turnover)" ] }, "default": [] }, "postcodeAreas": { "title": "Postcode areas", "type": "array", "description": "UK postcode areas, letters only, e.g. E, EC, RM, IG, M, B. Matching is exact: 'E' returns E1 and E14 but never EC1, EH3 or EN5.", "default": [], "items": { "type": "string" } }, "nameIncludesAny": { "title": "Name or trading name contains any of", "type": "array", "description": "Case-insensitive substrings. Matches the registered organisation name or any of its registered trading names. Example: solicitors, law, legal, llp", "default": [], "items": { "type": "string" } }, "nameExcludes": { "title": "Exclude names containing", "type": "array", "description": "Case-insensitive substrings to filter out.", "default": [], "items": { "type": "string" } }, "publicAuthority": { "title": "Public authority", "enum": [ "any", "only", "exclude" ], "type": "string", "description": "Restrict to public authorities, or exclude them. 51,611 of the 1.4M entries are public authorities.", "default": "any" }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 200000, "type": "integer", "description": "Stop after this many matches." } } }, "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 } } } } } } } } } }