SAM.gov & UK Contracts Finder Tenders Scraper – US Federal & UK Public Procurement

Search US federal contract opportunities on SAM.gov and UK public tenders on Contracts Finder through their official public APIs, and get clean, structured notices: title, buyer, country, dates, deadlines, value, CPV/NAICS, procedure type and a direct notice URL. Filter by keywords and publication window, or turn on Only new notices for a daily tender alert feed.

Why this one: no fragile HTML scraping — SAM.gov Get Opportunities Public API and the UK Contracts Finder OCDS Search API only. Pay per notice saved (~$2.50 / 1,000). Empty or failed runs are free apart from the tiny start fee; notices skipped as already seen are free.

Why this scraper

• Official sources. US: SAM.gov Get Opportunities Public API. UK: Contracts Finder OCDS Search under the Open Government Licence v3.0.
• One Actor, two markets. Pull US and UK public procurement in the same schema, or run either source alone.
• Fields that matter. source, noticeId, title, description, publication and deadline dates, isOpen, buyer, value, currency, CPV/NAICS, procedure and notice type, notice URL.
• Tender alerts. Enable Only new notices and schedule the Actor — each run returns only notices you have not seen under that state key.
• Companion to TED. Pair with TED EU Tenders Scraper and EU Grants Scraper for EU + US + UK coverage.

What you get

Field	Example
source, noticeId	contracts-finder, ocds-b5fd17-…
title, description	Northampton College – Media planning & Buying Services
publicationDate, deadlineDate, isOpen	2026-10-09, 2026-11-04, true
buyerName, buyerCountry	Northampton College, United Kingdom
estimatedValue, currency	250000, GBP
cpvOrNaics / naicsCode	79340000 or 541511
procedureType, noticeType	Open procedure, tender
noticeUrl, documentsUrl	https://www.contractsfinder.service.gov.uk/Notice/…

Use cases

• Bid and BD teams. Daily feed of new US federal and UK public opportunities in your keywords or NAICS/CPV area.
• Lead generation. Contracting authorities that are actively buying, with notice links.
• Market intelligence. Track awards and open solicitations across both markets in one pipeline.
• Tender portals and consultants. Feed your CRM or alerting product from official APIs.

How to use

1. Pick Sources: UK Contracts Finder (no key), SAM.gov (needs a free public API key), or both.
2. Optional: keywords, last N days (default 7), max notices (default 50).
3. For SAM.gov: create a free account at sam.gov, open Account Details, generate a public API key, paste it into SAM.gov public API key.
4. Run, or schedule daily with Only new notices on.

Example input (UK only – works without a SAM key)

{
  "sources": ["contracts-finder"],
  "keywords": ["software"],
  "publishedWithinDays": 14,
  "maxResults": 50,
  "cfStages": ["tender"]
}

Example input (both sources)

{
  "sources": ["sam.gov", "contracts-finder"],
  "keywords": ["cybersecurity"],
  "publishedWithinDays": 7,
  "maxResults": 100,
  "samApiKey": "YOUR_SAM_PUBLIC_API_KEY",
  "onlyNew": true,
  "stateKey": "cyber-us-uk"
}

Example output (shortened)

{
  "source": "contracts-finder",
  "noticeId": "ocds-b5fd17-eba856aa-b8d6-4d73-b794-8420ea10a3d9",
  "title": "CA18543 - Northampton College - Media planning & Buying Services",
  "publicationDate": "2026-10-09",
  "deadlineDate": "2026-11-04",
  "isOpen": true,
  "buyerName": "Northampton College",
  "buyerCountry": "United Kingdom",
  "estimatedValue": 250000,
  "currency": "GBP",
  "cpvOrNaics": "79340000",
  "procedureType": "Open procedure",
  "noticeType": "tender",
  "noticeUrl": "https://www.contractsfinder.service.gov.uk/Notice/d2301388-4ca6-48fc-805d-eb2e5793377e",
  "scrapedAt": "2026-10-10T07:00:00.000Z"
}

Run totals and per-source stats are saved to the SUMMARY record in the run key-value store.

Pricing

Pay per event:

• Notice (notice): charged once per notice saved to your dataset (~$0.0025 each, see Pricing tab).
• Free: notices skipped as already seen (Only new), duplicates in a run, and runs that save nothing (apart from the tiny actor-start fee).

Limitations

• SAM.gov requires your own free public API key. Without it, the Actor skips SAM.gov and still returns UK Contracts Finder results when that source is selected.
• SAM.gov date ranges must be at most one year (API rule). This Actor defaults to the last 7 days.
• Contracts Finder keyword matching is applied client-side on title/description after the official date/stage search.
• Values and descriptions are only as complete as the publishing authority’s notice.
• Respect API rate limits; Contracts Finder may return HTTP 403 if you request too aggressively (the Actor backs off and retries).

Licence / legal

• UK Contracts Finder: public sector information under the Open Government Licence v3.0. Attribution: Contains public sector information licensed under the Open Government Licence v3.0.
• SAM.gov: this Actor uses only the Get Opportunities Public API. It does not scrape the SAM.gov website (scraping is prohibited in the SAM.gov Terms of Use). Share only data from the public API. U.S. federal government works are generally not protected by copyright in the U.S.; cite SAM.gov / GSA.
• Full licence notes: see PRICING.md in the Actor source.

Related actors

• TED EU Tenders Scraper — EU public tenders and awards from TED.
• EU Grants Scraper — Horizon Europe and other EU funding calls.
• Contact Details Extractor — emails, phones and socials from buyer websites.
• Tech Stack Detector — technologies behind buyer or winner sites.

FAQ

Do I need API keys? Only for SAM.gov (free public key from sam.gov Account Details). Contracts Finder needs none.

Is this legal? Yes for the intended use: official public APIs, OGL (UK) and public-domain / government-work norms for SAM public opportunity data. Do not scrape the SAM.gov HTML site.

How fresh is the data? Both portals publish continuously; a daily schedule with Only new notices catches new opportunities.