# UK Tenders Scraper (Find a Tender + Contracts Finder) (`fetchwerk/uk-tenders-scraper`) Actor Scrape UK public procurement notices from Find a Tender and Contracts Finder in one run. Above and below-threshold contracts the EU TED database no longer carries post-Brexit. Filter by CPV, keywords and notice type. Normalized output + digest mode. - **URL**: https://apify.com/fetchwerk/uk-tenders-scraper.md - **Developed by:** [Fetchwerk](https://apify.com/fetchwerk) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 tender records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## UK Tenders Scraper (Find a Tender + Contracts Finder) This **UK tenders scraper** collects public procurement notices from the two official UK sources in one run: **Find a Tender** (FTS, the post-Brexit replacement for TED, above-threshold contracts) and **Contracts Finder** (below-threshold and lower-value contracts). You get one clean, normalized JSON format across both, filtered by CPV, keywords and notice type. No API keys, no login, no personal-data scraping. ### Why a dedicated UK scraper? Since Brexit, the UK is **no longer published on the EU's TED database**. If you rely on a TED-based feed, you miss UK public contracts entirely. This actor reads the UK's own official OCDS APIs directly, run by the Cabinet Office under the Procurement Act 2023. This is the only Apify actor that combines both official UK sources: | | TED-based feeds | This actor | |---|---|---| | UK contracts (post-Brexit) | no | yes | | Above-threshold (Find a Tender) | n/a | yes | | Below-threshold (Contracts Finder) | n/a | yes | | One normalized schema | n/a | yes | | Cross-source deduplication | n/a | yes | ### What data does it return? ```json { "id": "fts:ocds-h6vhtk-06d3c7", "source": "fts", "title": "Technical and Operations Delivery Partner", "buyer": "Surrey County Council", "country": "GBR", "cpv_codes": ["71621000", "72224000"], "notice_type": "tender", "publication_date": "2026-07-25", "deadline": "2026-08-26", "url": "https://www.find-tender.service.gov.uk/Notice/070483-2026", "description": null } ```` `source` is `fts` (Find a Tender) or `contracts-finder`. ### How to use it Example input, all fields optional: ```json { "sources": ["fts", "contracts-finder"], "noticeTypes": ["tender"], "cpvCodes": ["72000000"], "keywords": ["cloud", "software"], "daysBack": 7, "maxItems": 200, "mode": "digest" } ``` - **sources**: `fts` (above-threshold) and/or `contracts-finder` (below-threshold). - **noticeTypes**: `tender` (open calls), `award` (who won), `planning`, `contract`. Default `tender`. - **cpvCodes**: prefix match. `72` matches all IT services, `60000000` matches exactly. - **keywords**: case-insensitive match on title and description. - **daysBack**: publication window, 1 to 90 days. - **mode**: `search` returns the dataset; `digest` also writes a ready-to-send markdown summary (grouped by notice type) to the key-value store under the key `DIGEST`. ### Tender monitoring and alerts Run the actor on a daily or weekly [schedule](https://docs.apify.com/platform/schedules) in `digest` mode and connect an Apify integration (Slack, email, webhook, Make, Zapier) to deliver the `DIGEST` wherever your team works. Notices that appear on both portals are merged automatically. ### Use cases - **Bid monitoring in the UK**: never miss a relevant public contract, above or below threshold. - **Post-Brexit coverage**: fill the gap left when the UK stopped publishing on TED. - **Market research**: track which UK public buyers purchase what, where, and how often. - **AI agents**: the normalized output makes this actor easy to consume from Claude, Cursor or your own agent stack. ### FAQ **Is this allowed?** Yes. Both sources are official UK government portals (Cabinet Office). This actor uses their public, documented OCDS APIs (Find a Tender and Contracts Finder) under the Open Government Licence, and collects no personal data beyond the organization-level procurement information the government itself publishes. **How fresh is the data?** As fresh as the portals: UK buyers publish continuously on business days. Run the actor on a schedule to stay current. **What is the difference between the two sources?** Find a Tender carries higher-value, above-threshold notices (the TED replacement); Contracts Finder carries below-threshold and lower-value opportunities. Together they cover the UK public procurement landscape. **How does pricing work?** Pay per event: a small fee per returned notice, and a flat fee per generated digest. `maxItems` caps your cost per run. ### Related Fetchwerk actors All Fetchwerk procurement actors share a normalized output schema, so you can merge them into one pipeline: - **[EU Tenders Scraper](https://apify.com/fetchwerk/eu-tenders-scraper)**: EU-wide open calls from TED plus Dutch tenders from TenderNed. - **[German Tenders Scraper](https://apify.com/fetchwerk/de-tenders-scraper)**: German national and below-threshold tenders. - **[EU Contract Award Radar](https://apify.com/fetchwerk/eu-award-radar)**: who won which EU public contract, for how much. *** Built and operated by **Fetchwerk**. # Actor input Schema ## `sources` (type: `array`): Which UK portals to fetch: Find a Tender (above-threshold) and/or Contracts Finder (below-threshold and lower value). ## `noticeTypes` (type: `array`): tender = open calls, award = contract awards, planning = prior information. Empty = all. ## `keywords` (type: `array`): Case-insensitive match on title/description. Empty = no keyword filter. ## `cpvCodes` (type: `array`): CPV codes, prefix match: 72 matches all IT services, 60000000 matches exactly. Empty = all categories. ## `daysBack` (type: `integer`): Only notices published in the last N days. ## `maxItems` (type: `integer`): Hard cap on returned notices (also caps your cost). ## `mode` (type: `string`): search = dataset only; digest = dataset + markdown digest in key-value store (key DIGEST). ## Actor input object example ```json { "sources": [ "fts", "contracts-finder" ], "noticeTypes": [ "tender" ], "keywords": [], "cpvCodes": [], "daysBack": 7, "maxItems": 200, "mode": "search" } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("fetchwerk/uk-tenders-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("fetchwerk/uk-tenders-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call fetchwerk/uk-tenders-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetchwerk/uk-tenders-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "UK Tenders Scraper (Find a Tender + Contracts Finder)", "description": "Scrape UK public procurement notices from Find a Tender and Contracts Finder in one run. Above and below-threshold contracts the EU TED database no longer carries post-Brexit. Filter by CPV, keywords and notice type. Normalized output + digest mode.", "version": "0.1", "x-build-id": "oi281NzDoy9Wi6WpQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetchwerk~uk-tenders-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetchwerk-uk-tenders-scraper", "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/fetchwerk~uk-tenders-scraper/runs": { "post": { "operationId": "runs-sync-fetchwerk-uk-tenders-scraper", "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/fetchwerk~uk-tenders-scraper/run-sync": { "post": { "operationId": "run-sync-fetchwerk-uk-tenders-scraper", "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": { "sources": { "title": "Sources", "type": "array", "description": "Which UK portals to fetch: Find a Tender (above-threshold) and/or Contracts Finder (below-threshold and lower value).", "items": { "type": "string", "enum": [ "fts", "contracts-finder" ] }, "default": [ "fts", "contracts-finder" ] }, "noticeTypes": { "title": "Notice types", "type": "array", "description": "tender = open calls, award = contract awards, planning = prior information. Empty = all.", "items": { "type": "string", "enum": [ "tender", "award", "planning", "contract" ] }, "default": [ "tender" ] }, "keywords": { "title": "Keywords", "type": "array", "description": "Case-insensitive match on title/description. Empty = no keyword filter.", "default": [], "items": { "type": "string" } }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "CPV codes, prefix match: 72 matches all IT services, 60000000 matches exactly. Empty = all categories.", "default": [], "items": { "type": "string" } }, "daysBack": { "title": "Days back", "minimum": 1, "maximum": 90, "type": "integer", "description": "Only notices published in the last N days.", "default": 7 }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Hard cap on returned notices (also caps your cost).", "default": 200 }, "mode": { "title": "Mode", "enum": [ "search", "digest" ], "type": "string", "description": "search = dataset only; digest = dataset + markdown digest in key-value store (key DIGEST).", "default": "search" } } }, "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 } } } } } } } } } } ```