# Government Tender Finder: EU, UK & World Bank Contracts (`scrapemint/government-tender-finder`) Actor

Find live government tenders worldwide by keyword: EU TED (27+ countries), UK Contracts Finder, and World Bank projects in 140+ countries. One row per tender with buyer, deadline, value, and contact email when published. Official APIs, no key, no browser. Pay per tender.

- **URL**: https://apify.com/scrapemint/government-tender-finder.md
- **Developed by:** [Ken M](https://apify.com/scrapemint) (community)
- **Categories:** Business, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage

## 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

## Government Tender Finder: EU, UK & World Bank Contracts

Search live government tenders across three official procurement systems in one run and get one clean JSON row per tender: title, buyer organization, country, published date, submission deadline, estimated value, CPV categories, notice link, and the buyer contact email when published. Reads official public APIs (EU TED, UK Contracts Finder, World Bank): no key, no login, no browser.

Coverage is global: TED carries every above-threshold public tender from 27+ EU/EEA countries, Contracts Finder carries UK government contracts, and World Bank notices span development projects in 140+ countries across Africa, Asia, Latin America, and Eastern Europe. Built for any company that sells to governments: IT and software firms, construction and engineering, medical suppliers, consultants, logistics, training providers. Turn on cross-run dedupe, put it on a daily schedule, and each run returns only newly published tenders matching what you sell — the alert that tender portals charge $100 to $300 per month for.

### What you get

One row per tender, with:

- `source` (`eu-ted`, `uk-contracts-finder`, `world-bank`), `noticeId`
- `title`, `description` (plain text), `noticeType`
- `buyer`, `buyerCountry`, `country`
- `publishedDate`, `deadline` (submission deadline)
- `estimatedValue`, `currency`, `cpvCodes` (EU procurement categories)
- `projectId`, `projectName` (World Bank rows)
- `contactName`, `contactEmail`, `contactPhone` (when published)
- `url` (official notice page), `matchedKeyword`, `scrapedAt`

### Input

- `keywords` — what you sell; one search per keyword, merged and deduplicated
- `sources` — any of `ted`, `uk`, `worldbank` (default: all three)
- `countries` — ISO 3-letter codes for EU (DEU, FRA, ESP) or country names for World Bank (Kenya, Brazil, India); empty = everywhere
- `publishedWithinDays` — lookback window (default 14, up to 90)
- `activeOnly` — drop tenders whose deadline already passed (default on)
- `maxTenders` — cap on rows returned (default 25, up to 1000)
- `dedupe` — skip previously returned tenders; built for scheduled alerts

### Example input

```json
{
  "keywords": ["software development", "IT services"],
  "sources": ["ted", "worldbank"],
  "countries": ["DEU", "FRA", "Kenya"],
  "publishedWithinDays": 7,
  "maxTenders": 50,
  "dedupe": true
}
````

### Example output

```json
{
  "source": "world-bank",
  "noticeId": "OP00456175",
  "title": "Individual Consulting Services for IT Technician (Software Development)",
  "buyer": "Ministry of Economy",
  "country": "El Salvador",
  "publishedDate": "2026-07-10",
  "deadline": "2026-07-24",
  "noticeType": "Request for Expression of Interest / Individual Consultant Selection",
  "projectName": "Promoting Job Opportunities and Skills Development in El Salvador",
  "contactEmail": "procurement@economia.gob.sv",
  "url": "https://projects.worldbank.org/en/projects-operations/procurement-detail/OP00456175"
}
```

### Uses

- Daily new-tender alerts scoped to your keywords and countries, with dedupe so you only see what's new
- Bid pipelines: pull every open tender in your category closing in the next 30 days
- Bid consultancies: one scheduled run per client profile, rows straight into the client tracker
- Market entry research: see which governments buy what you sell, at what estimated values, before you invest in a region
- Outreach: buyer contact emails for clarification questions and expressions of interest

### Pricing

Pay per tender row. Searches that match nothing cost nothing. The first 2 rows of every run are free so you can validate output before you scale up.

### Notes

- Sources are the official public APIs: TED (Tenders Electronic Daily, the EU's procurement journal), Contracts Finder (UK Cabinet Office), and the World Bank procurement notice database.
- EU rows are above-threshold tenders (roughly EUR 143k+ for services), which is where the serious contracts live. UK rows include lower-value contracts too.
- World Bank notices often include the buyer's direct email, which most paid tender portals strip out.

# Actor input Schema

## `keywords` (type: `array`):

What you sell, one search per keyword (results merged and deduplicated). Example: software development, medical equipment, road construction, consulting.

## `sources` (type: `array`):

Which procurement systems to search.

## `countries` (type: `array`):

Restrict results by country. Use ISO 3-letter codes for EU tenders (DEU, FRA, ESP, ITA, POL) or country names for World Bank tenders (Kenya, Brazil, India). Empty = everywhere.

## `publishedWithinDays` (type: `integer`):

Only return tenders published in the last N days.

## `activeOnly` (type: `boolean`):

Drop tenders whose submission deadline has already passed.

## `maxTenders` (type: `integer`):

Cap on tender rows returned. Controls total cost.

## `dedupe` (type: `boolean`):

Remember returned tender IDs across runs and skip them. Turn on for scheduled new-tender alerts.

## Actor input object example

```json
{
  "keywords": [
    "software"
  ],
  "sources": [
    "ted",
    "uk",
    "worldbank"
  ],
  "countries": [],
  "publishedWithinDays": 14,
  "activeOnly": true,
  "maxTenders": 25,
  "dedupe": 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "software"
    ],
    "sources": [
        "ted",
        "uk",
        "worldbank"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapemint/government-tender-finder").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "keywords": ["software"],
    "sources": [
        "ted",
        "uk",
        "worldbank",
    ],
}

# Run the Actor and wait for it to finish
run = client.actor("scrapemint/government-tender-finder").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 '{
  "keywords": [
    "software"
  ],
  "sources": [
    "ted",
    "uk",
    "worldbank"
  ]
}' |
apify call scrapemint/government-tender-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scrapemint/government-tender-finder",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Government Tender Finder: EU, UK & World Bank Contracts",
        "description": "Find live government tenders worldwide by keyword: EU TED (27+ countries), UK Contracts Finder, and World Bank projects in 140+ countries. One row per tender with buyer, deadline, value, and contact email when published. Official APIs, no key, no browser. Pay per tender.",
        "version": "0.1",
        "x-build-id": "vGtwY5L3iTh686BUv"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapemint~government-tender-finder/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapemint-government-tender-finder",
                "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/scrapemint~government-tender-finder/runs": {
            "post": {
                "operationId": "runs-sync-scrapemint-government-tender-finder",
                "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/scrapemint~government-tender-finder/run-sync": {
            "post": {
                "operationId": "run-sync-scrapemint-government-tender-finder",
                "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": {
                    "keywords": {
                        "title": "Search keywords",
                        "type": "array",
                        "description": "What you sell, one search per keyword (results merged and deduplicated). Example: software development, medical equipment, road construction, consulting.",
                        "default": [
                            "software"
                        ],
                        "items": {
                            "type": "string"
                        }
                    },
                    "sources": {
                        "title": "Sources",
                        "type": "array",
                        "description": "Which procurement systems to search.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "ted",
                                "uk",
                                "worldbank"
                            ],
                            "enumTitles": [
                                "EU TED (all EU/EEA countries)",
                                "UK Contracts Finder",
                                "World Bank (projects in 140+ countries)"
                            ]
                        },
                        "default": [
                            "ted",
                            "uk",
                            "worldbank"
                        ]
                    },
                    "countries": {
                        "title": "Countries (optional)",
                        "type": "array",
                        "description": "Restrict results by country. Use ISO 3-letter codes for EU tenders (DEU, FRA, ESP, ITA, POL) or country names for World Bank tenders (Kenya, Brazil, India). Empty = everywhere.",
                        "default": [],
                        "items": {
                            "type": "string"
                        }
                    },
                    "publishedWithinDays": {
                        "title": "Published within (days)",
                        "minimum": 1,
                        "maximum": 90,
                        "type": "integer",
                        "description": "Only return tenders published in the last N days.",
                        "default": 14
                    },
                    "activeOnly": {
                        "title": "Open tenders only",
                        "type": "boolean",
                        "description": "Drop tenders whose submission deadline has already passed.",
                        "default": true
                    },
                    "maxTenders": {
                        "title": "Max tenders per run",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Cap on tender rows returned. Controls total cost.",
                        "default": 25
                    },
                    "dedupe": {
                        "title": "Skip tenders seen in previous runs",
                        "type": "boolean",
                        "description": "Remember returned tender IDs across runs and skip them. Turn on for scheduled new-tender alerts.",
                        "default": 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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
