# Global Government Contracts & Tenders Scraper (`fascinating_lentil/global-government-contracts-aggregator`) Actor Scrape public government contracts and tender notices from official sources: SAM.gov, EU TED, and UK Contracts Finder. Export normalized B2B procurement opportunity data. - **URL**: https://apify.com/fascinating\_lentil/global-government-contracts-aggregator.md - **Developed by:** [Md Jakaria Mirza](https://apify.com/fascinating_lentil) (community) - **Categories:** Automation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 contract scrapeds 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## Global Government Contracts & Tenders Scraper Scrape official public procurement notices from government sources and export normalized contract opportunity data for B2B research, tender monitoring, procurement analytics, and vendor sales workflows. This Actor currently supports: - **UK Contracts Finder** via the official OCDS API - **EU TED** via the official TED Search API - **SAM.gov** via the official Get Opportunities Public API when you provide your own SAM.gov API key It saves clean records to the Apify Dataset and charges only after a valid contract/tender record is saved. ### What This Actor Extracts - Source - Keyword used - Contract or tender ID - Contract title - Buyer / contracting authority - Country and region - Notice type and stage - Procurement method - Contract value and currency where available - Published date - Deadline date - Status - CPV, NAICS, or classification codes - Description - Official contract URL - Scraped timestamp ### Use Cases 1. B2B lead generation for suppliers selling into government procurement. 2. Tender monitoring for sales teams and bid managers. 3. Public-sector market research by category, region, buyer, and value. 4. Competitive intelligence for procurement consultants and vendors. 5. Contract analytics across the UK, EU, and US public-sector markets. ### Input ```json { "sources": ["uk_contracts_finder", "ted"], "keywords": ["software"], "dateFrom": "2026-06-01", "dateTo": "2026-06-13", "noticeStatus": "active", "maxResults": 10 } ```` To include SAM.gov, add `"sam_gov"` to `sources` and provide `samApiKey`. ```json { "sources": ["sam_gov"], "keywords": ["cybersecurity"], "dateFrom": "2026-06-01", "dateTo": "2026-06-13", "country": "CA", "samApiKey": "YOUR_SAM_GOV_API_KEY", "maxResults": 25 } ``` ### Output Example ```json { "source": "uk_contracts_finder", "keyword": "software", "contractId": "ocds-b5fd17-example", "title": "Software support services", "buyerName": "Example Council", "buyerCountry": "United Kingdom", "buyerRegion": "London", "noticeType": "tender", "stage": "tender", "procurementMethod": "Open procedure", "contractValue": 250000, "currency": "GBP", "publishedDate": "2026-06-12T10:00:00+01:00", "deadlineDate": "2026-07-12T12:00:00+01:00", "status": "active", "classificationCodes": ["CPV:72000000 IT services"], "description": "Public contract notice summary...", "contractUrl": "https://www.contractsfinder.service.gov.uk/Notice/...", "scrapedAt": "2026-06-13T17:00:00.000Z" } ``` ### Pricing | Event | Price | When charged | | --- | ---: | --- | | `contract-scraped` | `$0.004` | Once per clean contract/tender record saved | ### Responsible Use Use this Actor only for lawful purposes and in compliance with the source websites' terms, robots.txt, applicable privacy laws, and local regulations. This Actor is designed for official public procurement records and does not intentionally collect personal contact lists, private account data, or non-public information. ### Notes - SAM.gov requires a user-provided public API key. - EU TED Search API is public and does not require a key for published notices. - UK Contracts Finder returns OCDS data under the UK Open Government Licence. # Actor input Schema ## `sources` (type: `array`): Official procurement sources to search. SAM.gov requires a user-provided API key. ## `keywords` (type: `array`): Optional search terms. Leave empty to return recent tenders from selected sources. ## `dateFrom` (type: `string`): Publication start date in YYYY-MM-DD. Defaults to 30 days ago. ## `dateTo` (type: `string`): Publication end date in YYYY-MM-DD. Defaults to today. ## `country` (type: `string`): Optional country/region filter. For SAM.gov use a US state code like CA or NY. For UK/TED, this is applied as a text filter. ## `noticeStatus` (type: `string`): Which opportunity status to target where supported. ## `maxResults` (type: `integer`): Maximum total records saved across all selected sources and keywords. ## `samApiKey` (type: `string`): Optional SAM.gov public API key. Required only when SAM.gov is selected. ## `proxyConfiguration` (type: `object`): Not usually needed for official APIs, but available for enterprise network routing. ## Actor input object example ```json { "sources": [ "uk_contracts_finder", "ted" ], "keywords": [ "software" ], "noticeStatus": "active", "maxResults": 50, "proxyConfiguration": { "useApifyProxy": false } } ``` # 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("fascinating_lentil/global-government-contracts-aggregator").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("fascinating_lentil/global-government-contracts-aggregator").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 fascinating_lentil/global-government-contracts-aggregator --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fascinating_lentil/global-government-contracts-aggregator", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Global Government Contracts & Tenders Scraper", "description": "Scrape public government contracts and tender notices from official sources: SAM.gov, EU TED, and UK Contracts Finder. Export normalized B2B procurement opportunity data.", "version": "1.0", "x-build-id": "YdpPjSryqhNR0hjp6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fascinating_lentil~global-government-contracts-aggregator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fascinating_lentil-global-government-contracts-aggregator", "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/fascinating_lentil~global-government-contracts-aggregator/runs": { "post": { "operationId": "runs-sync-fascinating_lentil-global-government-contracts-aggregator", "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/fascinating_lentil~global-government-contracts-aggregator/run-sync": { "post": { "operationId": "run-sync-fascinating_lentil-global-government-contracts-aggregator", "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", "required": [ "sources", "maxResults" ], "properties": { "sources": { "title": "Sources", "uniqueItems": true, "type": "array", "description": "Official procurement sources to search. SAM.gov requires a user-provided API key.", "items": { "type": "string", "enum": [ "uk_contracts_finder", "ted", "sam_gov" ], "enumTitles": [ "UK Contracts Finder", "EU TED", "SAM.gov" ] }, "default": [ "uk_contracts_finder", "ted" ] }, "keywords": { "title": "Keywords", "type": "array", "description": "Optional search terms. Leave empty to return recent tenders from selected sources.", "items": { "type": "string" }, "default": [ "software" ] }, "dateFrom": { "title": "Published from", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Publication start date in YYYY-MM-DD. Defaults to 30 days ago." }, "dateTo": { "title": "Published to", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Publication end date in YYYY-MM-DD. Defaults to today." }, "country": { "title": "Country filter", "type": "string", "description": "Optional country/region filter. For SAM.gov use a US state code like CA or NY. For UK/TED, this is applied as a text filter." }, "noticeStatus": { "title": "Notice status", "enum": [ "active", "all" ], "type": "string", "description": "Which opportunity status to target where supported.", "default": "active" }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum total records saved across all selected sources and keywords.", "default": 50 }, "samApiKey": { "title": "SAM.gov API key", "type": "string", "description": "Optional SAM.gov public API key. Required only when SAM.gov is selected." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not usually needed for official APIs, but available for enterprise network routing.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```