{ "openapi": "3.0.1", "info": { "title": "UK Contracts Finder Scraper - Tenders & Awards", "description": "Scrape UK public contracts from Contracts Finder, one row per supplier: who won, for how much, from which buyer, the buyer's named contact, and the days until the contract expires, which tells you what goes back to tender soon. Filter by keyword, category, date.", "version": "0.1", "x-build-id": "i8v8JduFNGzSFUMku" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataio~uk-public-contract-awards/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataio-uk-public-contract-awards", "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/dataio~uk-public-contract-awards/runs": { "post": { "operationId": "runs-sync-dataio-uk-public-contract-awards", "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/dataio~uk-public-contract-awards/run-sync": { "post": { "operationId": "run-sync-dataio-uk-public-contract-awards", "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": { "stage": { "title": "Stage", "enum": [ "award", "tender" ], "type": "string", "description": "Awards name the winning supplier and the amount paid. Tenders are opportunities still open to bid on.", "default": "award" }, "keyword": { "title": "Keyword", "type": "string", "description": "Searches the notice title and description, for example software, catering, scaffolding." }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "EU procurement classification, for example 72000000 for IT services, 45000000 for construction. Leave empty for all.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "all", "services", "goods", "works" ], "type": "string", "description": "Services, goods or works. Measured split on recent awards: 72% services, 14% goods, 13% works.", "default": "all" }, "publishedWithinDays": { "title": "Published within (days)", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Rolling window, for a scheduled watch: 7 returns notices published in the last seven days. Unlike a fixed date, this moves on its own, so a weekly schedule returns only what is new instead of re-charging you for the same rows. Overrides Published from." }, "publishedFrom": { "title": "Published from", "type": "string", "description": "YYYY-MM-DD. Also makes the query much faster than an unfiltered search." }, "publishedTo": { "title": "Published to", "type": "string", "description": "YYYY-MM-DD." }, "minValue": { "title": "Minimum value (GBP)", "minimum": 0, "type": "integer", "description": "Filters at the source. Median award value is around £63,000, so £100,000 already removes most of the low-value routine." }, "endingWithinDays": { "title": "Contract ending within (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "The re-tender signal: a contract expiring soon is a procurement about to reopen. 180 is a typical sales horizon. Excludes contracts that have already ended." }, "smeSuitableOnly": { "title": "SME-suitable only", "type": "boolean", "description": "Keeps only contracts the buyer flagged as suitable for small and medium enterprises — 64% of recent awards.", "default": false }, "maxItems": { "title": "Maximum rows", "minimum": 1, "maximum": 20000, "type": "integer", "description": "One row per supplier per award. Highest-value awards are kept first, so truncation never removes the largest contracts.", "default": 1000 } } }, "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 } } } } } } } } } }