# Government Tenders & Public Procurement API: SAM.gov, TED, UK (`blueberry_rainstorm/public-tenders-feed`) Actor

Government tenders, RFPs and contract awards in one feed: SAM.gov (US), TED tenders (EU), UK Find a Tender + Contracts Finder, CanadaBuys and World Bank. Filter by keyword, country, CPV/NAICS/UNSPSC, deadline, value. Daily alerts return only new notices. $2 per 1,000 notices.

- **URL**: https://apify.com/blueberry_rainstorm/public-tenders-feed.md
- **Developed by:** [Pandapi](https://apify.com/blueberry_rainstorm) (community)
- **Categories:** Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$2.00 / 1,000 notice returneds

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Government Tenders & Public Procurement API: SAM.gov, TED (EU), UK, Canada, World Bank

Find government tenders, RFPs, RFQs and contract awards from **six official procurement portals in one run**, with **one clean, identical format** for every country. Built for bid teams, B2G sales, consultants and anyone who sells to the public sector.

**Price example:** a daily alert on your keywords that finds 30 new tenders costs about **$0.06 a day**. No API keys, no start fee.

| Source | Coverage | What you get |
|---|---|---|
| **SAM.gov** | US federal government | Solicitations, combined synopsis/solicitations, presolicitations, sources sought, awards, with NAICS, PSC, set-aside, place of performance |
| **TED (Tenders Electronic Daily)** | 27 EU countries + Norway, Switzerland, Iceland, candidate countries | Contract notices, prior information notices, contract awards with winner and value, CPV codes |
| **Find a Tender** | UK above-threshold (Procurement Act 2023) | Tender, planning and award notices, CPV codes, values in GBP |
| **Contracts Finder** | UK below-threshold (England) | Open opportunities and awards from councils, NHS trusts, schools |
| **CanadaBuys** | Government of Canada | Open tenders (RFP, RFSO, RFSA, ITQ, RFI), UNSPSC/GSIN codes, trade agreements |
| **World Bank** | Bank-financed projects in 100+ countries | Invitations for bids, requests for expressions of interest, awards |

No API keys, no login, no proxies: every source is an official open-data API. Most sources answer in seconds. UK Find a Tender limits how fast it can be read, so a window of a week or more can take 2 to 4 minutes; daily alerts (1 to 2 days) finish in well under a minute. If Find a Tender is still busy, you get the UK notices fetched so far instead of an error.

### Why use this feed

- **All major portals, one schema.** Every notice has the same fields (title, buyer, country, deadline, days left, value, codes, link), whatever the source. No more stitching five scrapers together.
- **Alerts mode: pay only for new notices.** Turn on *Only new notices*, schedule the actor daily, and each run returns just the tenders you haven't seen. Connect it to email, Slack, Google Sheets or your CRM with Apify integrations.
- **Values converted to USD and EUR** with the European Central Bank's daily rates, so you can filter by size across countries.
- **Days left to bid** on every open tender, and expired tenders hidden by default.
- **Real industry codes:** CPV (EU/UK), NAICS and PSC (US), UNSPSC and GSIN (Canada), with prefix matching (`72000000` = all IT services).
- **Who to contact:** the official procurement contact (name, work email, phone) published with the notice, when the portal gives one.
- **Robust:** if one portal is slow or down, the others still deliver, and the run summary tells you exactly what happened per source.
- **Fair price, no start fee:** $2 per 1,000 notices.

### Use cases

- **Daily tender alerts** for your company's keywords and codes, delivered to Slack, email or a spreadsheet.
- **Pipeline building for B2G sales:** who is buying what, in which country, with what budget and deadline.
- **Competitor and market research** with contract awards: who won, for how much, from which buyer.
- **Feeding an AI agent or RAG system** with structured procurement data (bid/no-bid triage, proposal drafting).
- **Consultants and bid writers** watching several countries for clients.

### Input example

```json
{
  "keywords": ["software", "cloud", "cybersecurity"],
  "excludeKeywords": ["hardware maintenance"],
  "countries": ["US", "GB", "DE", "FR", "CA"],
  "noticeTypes": ["tender", "pre-notice"],
  "postedWithinDays": 7,
  "minDaysLeft": 10,
  "minValueUsd": 50000,
  "onlyNew": true,
  "stateKey": "it-tenders",
  "maxResultsPerSource": 100
}
```

Tips:

- **Keywords** match any of the words or phrases in the title, description or buyer. On TED they are matched against titles and descriptions in every EU language plus the notice's CPV category name, so non-English notices are found too: `software development` finds notices in the category "IT services: consulting, software development, Internet and support". SAM.gov's own search also hits attachments and the standard clause lists in nearly every US defense notice, so with **Strict keyword match** (on by default) a SAM notice is kept only when your keyword is in its title, the opening of its real description (first 1,500 characters, clause lists removed: that is where SAM notices say what is being bought) or the buyer name. Turn it off to use each portal's full-text search (finds more, including notices that only mention your keyword in annexes or standard terms).
- For EU notices in other languages, **CPV codes** are more precise than English keywords.
- If you set **CPV**, **NAICS** or **UNSPSC** codes, only the sources that use those codes are searched (CPV: TED and UK; NAICS: SAM.gov; UNSPSC: CanadaBuys). Combine them to cover several countries.
- If you set **countries**, sources that cannot cover them are skipped (for example, `["DE"]` searches TED and the World Bank only).

### Output example

```json
{
  "title": "Equals Trust - Provision of ICT Managed Services Stage 1",
  "buyerName": "Equals Trust",
  "country": "GB",
  "countryName": "United Kingdom",
  "noticeType": "tender",
  "deadline": "2027-02-26T12:00:00.000Z",
  "daysLeft": 105,
  "valueAmount": 3000000,
  "valueCurrency": "GBP",
  "valueUsd": 3976673,
  "valueEur": 3588731,
  "publishedAt": "2026-11-12T15:02:14.000Z",
  "url": "https://www.find-tender.service.gov.uk/Notice/107634-2026",
  "source": "uk-fts",
  "sourceName": "Find a Tender (UK)",
  "id": "uk-fts:ocds-h6vhtk-06b394",
  "noticeId": "107634-2026",
  "noticeTypeLabel": "tenderUpdate (Competitive flexible procedure)",
  "status": "active",
  "category": "services",
  "procedure": "Competitive flexible procedure",
  "cpvCodes": ["72000000", "72510000"],
  "naicsCodes": [],
  "buyerCity": "Nottingham",
  "contactName": "Procurement Team",
  "contactEmail": "procurement@example.org",
  "contactPhone": null,
  "description": "This Procurement is being conducted in accordance with the Procurement Act 2023 using the competitive flexible procedure...",
  "matchedKeywords": ["software"],
  "fetchedAt": "2026-11-13T00:52:31.042Z"
}
```

### Output fields

| Field | Meaning |
|---|---|
| `title`, `description` | Notice title and plain-text description (HTML removed). TED titles are in the original language. |
| `buyerName`, `buyerParent`, `buyerCity`, `buyerRegion` | The contracting authority (and its department for SAM.gov). |
| `country`, `countryName` | Buyer country (ISO 2-letter code). For the World Bank, the project country. |
| `noticeType` | `tender`, `pre-notice`, `award` or `other`. `noticeTypeLabel` keeps the portal's own wording. |
| `deadline`, `daysLeft` | Bid deadline (UTC) and whole days left. Empty when the portal publishes none. |
| `valueAmount`, `valueCurrency`, `valueUsd`, `valueEur` | Estimated value (tenders) or awarded value (awards), plus conversions. |
| `publishedAt` | Publication date (UTC). |
| `url`, `documentsUrl` | Link to the official notice, and to tender documents when published. |
| `cpvCodes`, `naicsCodes`, `pscCode`, `unspscCodes`, `gsinCodes` | Classification codes, depending on the source. |
| `setAside` | US small-business set-aside (SBA, 8A, SDVOSBC, WOSB, HZC...). |
| `contactName`, `contactEmail`, `contactPhone` | The procurement contact point printed in the notice (SAM.gov, UK, CanadaBuys, World Bank), for questions and bids. Turn off with *Include buyer contact*. |
| `placeOfPerformance` | US place of performance. |
| `category`, `procedure` | Goods / services / works, and the procurement procedure. |
| `awardedTo`, `awardDate` | Winning suppliers for award notices. |
| `matchedKeywords` | Which of your keywords the notice matched. |
| `matchedInTitle` | `true` when a keyword is in the title: the strongest matches. Sort or filter on it for a short list. |
| `id` | Stable unique id (`source:nativeId`), used by alerts mode. |

Canada adds `tradeAgreements` and `regionsOfDelivery`; World Bank adds `projectId`, `projectName` and `language`; UK adds the OCDS `ocid`.

A per-source run summary (notices scanned, kept, why others were dropped, errors) is saved as `OUTPUT` in the run's key-value store.

### How to set up tender alerts

1. Fill in your keywords and/or codes, turn on **Only new notices** and give the alert a name (e.g. `it-tenders`).
2. Save it as a task and add a **schedule** (for example every weekday at 7:00).
3. Add an integration (email, Slack, Google Sheets, Zapier, Make, n8n or a webhook) to receive each run's new notices.

The first run returns everything that matches in the date window; later runs return only notices that are new to that alert. Use a different alert name for each saved search.

### Pricing

Pay per event: **$2 per 1,000 notices** returned ($0.002 per notice). No start fee and no charge for notices filtered out. A daily alert that finds 30 new notices costs about $0.06 per day. You can cap the cost of any run with Apify's maximum cost per run setting: the actor stops at your limit and returns the newest notices first.

### FAQ

**Do I need a SAM.gov API key or any account?** No. All six sources are public open-data services.

**How fresh is the data?** Each run reads the portals live. SAM.gov, TED and the UK portals update throughout the day; CanadaBuys publishes its open-data file daily; World Bank notices appear as they are released.

**Why do some notices have no value or deadline?** The portal didn't publish one (common for early notices, qualification stages and US notices). Filters keep these by default so you don't miss opportunities.

**Can I get older notices?** Yes, up to 365 days with *Posted in the last N days* or a *Posted on or after* date. Open tenders from CanadaBuys are those still open today.

**Does it download tender documents?** It gives you the link (`documentsUrl` or `url`). Many documents sit behind the buyer's e-tendering portal and need a free supplier registration.

**Is this a TED tenders API / SAM.gov API alternative?** Yes: it calls TED's and SAM.gov's official open-data services for you (no SAM.gov key needed) and returns the same clean fields as every other portal, so one integration covers the US, EU, UK and Canada.

**Can you add another country?** Probably. Open an issue on this actor with the portal you need and we'll look at it.

### Acceptable use of contact data

Contact fields contain the work contact details that public bodies publish in their own notices so suppliers can ask questions and bid. Use them for that purpose:

- Contact a buyer about the tender it published. Don't add these addresses to marketing lists or send bulk unsolicited email: anti-spam laws (CAN-SPAM, CASL, GDPR/ePrivacy, PECR) apply to you.
- Keep only what you need and delete contact data you no longer use, as GDPR, UK GDPR and PIPEDA require.
- If you don't need contacts, switch off *Include buyer contact*.
- Removal requests: if you are a listed contact and want your details removed from this actor's output, open an issue on this actor's Issues tab. We act on requests within 30 days.

### Data sources and terms

The actor only calls official public APIs and open-data files at a polite rate: SAM.gov (US government work, public domain), TED (© European Union, reuse authorised), Find a Tender and Contracts Finder (Open Government Licence v3.0), CanadaBuys (Open Government Licence - Canada) and the World Bank (CC BY 4.0). When you republish the data, credit the original source as those licences require. Notices describe public purchases by government bodies; please use the data for business purposes and respect each portal's terms.

### More from Pandapi 🐼

Pandapi makes friendly, no-nonsense data tools: simple input, clean output, and fair pay-per-result prices. Found a bug or need a feature? Open an issue on the Issues tab and we answer fast.

- [Web Page to Markdown](https://apify.com/blueberry_rainstorm/web-page-to-markdown): clean, chunked Markdown from any URL or sitemap, ready for AI and RAG
- [PDF to Text, Markdown & Excel](https://apify.com/blueberry_rainstorm/pdf-to-text-markdown): text, Markdown and real Excel tables from any PDF, with OCR
- [Website Contact Details Scraper](https://apify.com/blueberry_rainstorm/website-contact-finder): business emails, phones and social links, one row per website
- [Website Screenshot](https://apify.com/blueberry_rainstorm/website-screenshot): full-page and mobile screenshots or PDFs of many URLs at once
- [Broken Link Checker](https://apify.com/blueberry_rainstorm/broken-link-checker): every 404, dead link and redirect on a site, with the page it is on
- [App Store Reviews Scraper](https://apify.com/blueberry_rainstorm/app-store-reviews-scraper): iOS reviews, ratings and app details from about 180 countries
- [Google Play Reviews Scraper](https://apify.com/blueberry_rainstorm/google-play-reviews-scraper): Android reviews with developer replies, ratings and app data, many languages
- [HTML to PDF](https://apify.com/blueberry_rainstorm/html-to-pdf): web pages, HTML or a template plus JSON rows (invoices, certificates) to PDF
- [Hacker News Scraper](https://apify.com/blueberry_rainstorm/hacker-news-scraper): stories, comments, Show HN and job posts, filtered your way

# Actor input Schema

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

Return notices that mention ANY of these words or phrases (title, description or buyer). Leave empty for all notices. SAM.gov and TED search the full notice text on their side; TED matches all EU languages, so CPV codes are more precise there.

## `excludeKeywords` (type: `array`):

Drop notices whose title or description mentions any of these words (e.g. "catering", "vehicle").

## `strictKeywordMatch` (type: `boolean`):

SAM.gov's own search also matches attachments and standard contract clauses (e.g. every DoD notice mentions cybersecurity certification). On: a SAM notice is kept only when a keyword is in its title, the first 1,500 characters of its description (clause lists removed), or the buyer name. On TED, keywords must be in a title, description or the CPV category name, not only in annexes or standard terms. Off: use each portal's full-text search.

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

Official procurement portals to search. Leave empty to search all six.

## `noticeTypes` (type: `array`):

Which stage of the buying process to return.

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

Two-letter country codes of the buyer, e.g. US, GB, CA, DE, FR, IT, ES, PL, KE. Sources that cannot cover these countries are skipped automatically.

## `cpvCodes` (type: `array`):

EU Common Procurement Vocabulary codes. Prefix match: 72000000 = all IT services, 45000000 = all construction work, 79400000 = consulting. When set, only TED and UK sources are searched (plus SAM/CanadaBuys if you also give NAICS/UNSPSC).

## `naicsCodes` (type: `array`):

US industry codes for SAM.gov, e.g. 541511 (custom programming), 541512 (systems design), 236220 (commercial building). Exact codes.

## `unspscCodes` (type: `array`):

UNSPSC codes for CanadaBuys. Prefix match: 43000000 = all IT hardware and software, 81110000 = computer services.

## `postedWithinDays` (type: `integer`):

Only notices published in the last N days (today counts as day 1).

## `postedAfter` (type: `string`):

Only notices published on or after this date (YYYY-MM-DD).

## `minDaysLeft` (type: `integer`):

Hide tenders whose deadline is closer than this many days. 0 = hide only expired ones. Notices without a published deadline are kept.

## `minValueUsd` (type: `integer`):

Hide notices whose estimated value is known and below this amount (converted to USD with today's ECB rates). Notices without a published value are kept.

## `onlyNew` (type: `boolean`):

Remember what earlier runs returned and output only notices you have not received yet. Schedule the actor daily for a tender alert feed: you pay only for new notices.

## `stateKey` (type: `string`):

Name of the alerts memory. Use a different name for each saved search (e.g. "it-uk", "construction-us").

## `maxResultsPerSource` (type: `integer`):

Newest notices first. Keeps one busy portal from crowding out the others.

## `maxResults` (type: `integer`):

Hard cap for the whole run (newest first).

## `includeDescription` (type: `boolean`):

Add the notice description (plain text, HTML removed).

## `descriptionMaxLength` (type: `integer`):

Longer descriptions are cut to this many characters.

## `includeContacts` (type: `boolean`):

Add the procurement contact point printed in the notice (contactName, contactEmail, contactPhone) where the portal publishes one (SAM.gov, UK, CanadaBuys, World Bank). Use it only to respond to the tender; see Acceptable use.

## Actor input object example

```json
{
  "keywords": [
    "software",
    "cloud"
  ],
  "strictKeywordMatch": true,
  "sources": [],
  "noticeTypes": [
    "tender",
    "pre-notice"
  ],
  "countries": [],
  "postedWithinDays": 7,
  "minDaysLeft": 0,
  "onlyNew": false,
  "stateKey": "default",
  "maxResultsPerSource": 25,
  "maxResults": 1000,
  "includeDescription": true,
  "descriptionMaxLength": 4000,
  "includeContacts": true
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# 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",
        "cloud"
    ],
    "countries": [],
    "maxResultsPerSource": 25
};

// Run the Actor and wait for it to finish
const run = await client.actor("blueberry_rainstorm/public-tenders-feed").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",
        "cloud",
    ],
    "countries": [],
    "maxResultsPerSource": 25,
}

# Run the Actor and wait for it to finish
run = client.actor("blueberry_rainstorm/public-tenders-feed").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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",
    "cloud"
  ],
  "countries": [],
  "maxResultsPerSource": 25
}' |
apify call blueberry_rainstorm/public-tenders-feed --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,blueberry_rainstorm/public-tenders-feed"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/UlFXg8l7TIxmbfFpN/builds/nTx3Wx33eMZ4NLOZr/openapi.json
