{ "openapi": "3.0.1", "info": { "title": "UK Gazette Insolvency Notices Scraper – Winding-Up Petitions", "description": "UK insolvency notices from The Gazette as JSON: winding-up petitions, administrations, liquidations and creditor meetings with company number, address, petitioner (e.g. HMRC), nature of business, court, case number, hearing date and practitioner. Open Government Licence. From $2 per 1,000.", "version": "0.1", "x-build-id": "3Cxu2rfkX44Ueet39" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_daemon~uk-gazette-insolvency-notices/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_daemon-uk-gazette-insolvency-notices", "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/data_daemon~uk-gazette-insolvency-notices/runs": { "post": { "operationId": "runs-sync-data_daemon-uk-gazette-insolvency-notices", "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/data_daemon~uk-gazette-insolvency-notices/run-sync": { "post": { "operationId": "run-sync-data_daemon-uk-gazette-insolvency-notices", "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": { "service": { "title": "Gazette section", "enum": [ "insolvency", "all-notices", "wills-and-probate", "companies" ], "type": "string", "description": "Which Gazette search to query. Default `insolvency`.", "default": "insolvency" }, "noticeTypes": { "title": "Notice type codes", "type": "array", "description": "Optional Gazette notice type codes (verified Oct 2026): `2450` petitions to wind up (companies), `2451` petitions to wind up (partnerships), `2452` winding-up orders, `2441` resolutions for winding up, `2432` and `2443` appointment of liquidators, `2442` meetings of creditors, `2433` notices to creditors, `2410` appointment of administrators, `2503` bankruptcy orders. Default is petitions and administrations (`2450`, `2410`); pass an empty list for every type in the section.", "default": [ "2450", "2410" ], "items": { "type": "string" } }, "categoryCode": { "title": "Category code", "type": "string", "description": "Optional Gazette category code, e.g. `G205000000` corporate insolvency, `G206000000` personal insolvency, `G205010000` companies." }, "text": { "title": "Search text", "type": "string", "description": "Optional free-text search, e.g. `Revenue and Customs` for HMRC petitions, a company name, a town, or an insolvency practitioner firm." }, "publishedWithinDays": { "title": "Published within the last N days", "minimum": 1, "type": "integer", "description": "Relative date window for schedules: only notices published in the last N days, counted back from today (UTC). `1` = since yesterday, `7` = the last week. Ignored when `Published from` is set. Combine with `Only new notices` for a daily feed." }, "startPublishDate": { "title": "Published from", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "`YYYY-MM-DD`. Only notices published on or after this date. Leave empty to use `Published within the last N days` instead." }, "endPublishDate": { "title": "Published to", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "`YYYY-MM-DD`. Only notices published on or before this date." }, "sortBy": { "title": "Sort", "enum": [ "latest-date", "oldest-date", "relevance" ], "type": "string", "description": "Sort order. Default `latest-date`.", "default": "latest-date" }, "includeLinkedData": { "title": "Include structured notice data", "type": "boolean", "description": "Fetch each notice's linked-data record and add it as top-level fields: company number, registered office and trading address, postcode, nature of business, petitioner (and an HMRC flag), court and case number, hearing, petition, appointment and resolution dates, and the insolvency practitioner's name, firm, IP number and contact details. Charged as one extra `notice-details` event per notice where the record was retrieved. Default on.", "default": true }, "onlyNewSinceLastRun": { "title": "Only new notices (since the last run)", "type": "boolean", "description": "Deliver only notices that an earlier run with the same search (or the same `State key`) has not already delivered. Skipped notices are not charged. Delivered notice ids are remembered for 180 days in a key-value store named `uk-gazette-notices-state` in your account. Made for daily schedules.", "default": false }, "stateName": { "title": "State name", "type": "string", "description": "Optional name for this saved search's memory when `Only new notices` is on. Leave empty to derive it from the section, notice types, category and search text. Use a different key to track several feeds separately." }, "maxItems": { "title": "Maximum notices", "minimum": 1, "type": "integer", "description": "Stop after this many notices have been delivered. Default 40, about $0.20 with structured details at FREE prices.", "default": 40 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Not needed by default; the actor switches to Apify datacenter proxy by itself if The Gazette rate-limits the structured-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 }, "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 } } } } } } } } } }