🏛️ SAM.gov Opportunities Scraper

Pull US federal contract opportunities from SAM.gov as one flat row each: solicitations, combined synopses, sources-sought notices and award notices, with NAICS, PSC, set-aside, contracting-officer contact, place of performance, attachment links and the full cleaned description already resolved. Search the board, run a change-detection monitor for a daily feed of what is new or amended, or run awards mode to track every contract a company or an agency has won. No API key, no login.

Here is one real row (trimmed), a US Air Force combined synopsis:

{
  "notice_id": "b9166d40f0264cbca811fd73bce06885",
  "solicitation_number": "FA860126Q0074",
  "title": "Brand Name Agilent High-Performance Liquid Chromatograph-Mass Spectrometer",
  "notice_type_code": "k",
  "notice_type": "Combined Synopsis/Solicitation",
  "status": "active",
  "posted_date": "2026-09-01T13:00:00Z",
  "response_deadline": "2026-09-19T17:00:00Z",
  "last_modified": "2026-09-08T18:22:00Z",
  "amendment_count": 1,
  "agency_department": "DEPT OF DEFENSE",
  "agency_subtier": "DEPT OF THE AIR FORCE",
  "agency_office": "FA8601 AFLCMC PZIO",
  "naics_primary": "334516",
  "naics_codes": ["334516"],
  "psc_code": "6630",
  "set_aside_code": null,
  "set_aside": null,
  "pop_city": "Wright Patterson AFB",
  "pop_state": "OH",
  "pop_zip": "45433",
  "pop_country": "USA",
  "contact_name": "Alejandro Quiles",
  "contact_email": "alejandro.quiles_sanchez.1@us.af.mil",
  "contact_secondary_email": "candice.snow@us.af.mil",
  "description": "Combined Synopsis/Solicitation: Brand Name Agilent High-Performance Liquid Chromatograph-Mass Spectrometer ...",
  "award_amount": null,
  "awardee_name": null,
  "attachments": [
    { "name": "Solicitation - FA860126Q0074.pdf", "url": "https://sam.gov/api/prod/opps/v3/opportunities/resources/files/04aa11e0.../download", "type": ".pdf", "size": 556871 }
  ],
  "url": "https://sam.gov/opp/b9166d40f0264cbca811fd73bce06885/view",
  "scraped_at": "2026-09-09T15:43:35.748Z"
}

What it does

Reads SAM.gov's own opportunity search and detail endpoints (the same ones the sam.gov website calls). Four modes:

• Search - filter the board by keyword, NAICS, notice type and set-aside, and get a full row for every match, including the resolved detail record (NAICS, PSC, set-aside, contracting-officer contact, place of performance, award data) and the cleaned description.
• Monitor - give it a date or a relative window ("2 days", "1 week") and it returns only the opportunities posted or amended since then, each flagged new or modified. Built for a scheduled run that feeds a "what changed today" digest.
• Awards - filter to award notices for a company (by name or UEI), a keyword or a NAICS code, and get the award number, amount, date and awardee UEI on every row. A competitor-intelligence feed: who is winning what, at which agency, for how much.
• Look up - paste exact SAM.gov notice ids and get the full record for each.

Why this scraper

• A real monitor mode. Point it at "modified since yesterday" on a schedule and it stops walking the board as soon as it passes your cutoff, so a daily feed is a few seconds and a handful of rows, not a full re-scrape. Every row is tagged new or modified.
• A dedicated awards / competitor-intelligence mode. One input - a company name - returns every federal contract that company has been awarded through SAM.gov, with dollar amounts and the awarding office. Server-side pre-filtered, so it is fast even against the full board.
• Detail resolved, not just the search snippet. NAICS, PSC, set-aside, place of performance, the contracting officer's name, email and phone, and the full description - all on the row.
• Attachment links. The SOW, specs and amendment PDFs with direct, working download URLs and file sizes.
• Descriptions cleaned. HTML stripped, entities decoded, whitespace collapsed - not a wall of <p> tags.
• One row per look-up input. A notice id that does not resolve comes back as an error row so your output lines up with your list.
• No API key. SAM.gov's public endpoints, no registration, no rate-limit token.

How it compares

Capability	This actor	Other SAM.gov scrapers on Apify
Search opportunities by keyword / NAICS / type	yes	yes
Full detail record (NAICS, PSC, set-aside, place of performance)	yes	some
Contracting-officer name + email + phone	yes	some
Attachment links with download URLs + sizes	yes	rare
Cleaned plain-text description	yes	often raw HTML
Monitor mode (only new / modified since a date, tagged)	yes	no
Awards mode (contracts won by a company or agency, with $)	yes	no
Look up by notice id, with error rows for bad ids	yes	rare
Declared dataset schema + free-plan preview	yes	rare

Use cases

• Pipeline / capture. A daily monitor feed of new solicitations in your NAICS codes, straight into a CRM or a Slack channel, with the contracting officer's email already on the row.
• Competitor intelligence. Awards mode on a rival's name: every contract they have won, the agency, the amount, the date - a win/loss picture over time.
• Market sizing. Search a NAICS code across the whole board and total the award amounts to size an agency's spend in your space.
• Teaming. Find set-aside opportunities (8(a), HUBZone, SDVOSB, WOSB) you qualify for, or find the small businesses winning them to team with.
• Compliance / archive. Look-up mode to snapshot the full record and attachments of a solicitation you are bidding, before it is amended or archived.

Quickstart

Search - IT solicitations open now:

{
  "mode": "search",
  "keyword": "cybersecurity",
  "naicsCodes": ["541512", "541519"],
  "noticeTypes": ["o", "k"],
  "activeOnly": true,
  "fetchDetails": true,
  "maxItems": 100
}

Monitor - everything new or amended in the last 2 days:

{ "mode": "monitor", "naicsCodes": ["236220"], "modifiedSince": "2 days", "maxItems": 500 }

Awards - every contract Booz Allen has won:

{ "mode": "awards", "awardee": "Booz Allen", "maxItems": 200 }

Look up - one notice by id:

{ "mode": "lookup", "noticeIds": ["b9166d40f0264cbca811fd73bce06885"], "includeAttachments": true }

Input reference

Field	Applies to	Description
maxItems	all	Ceiling on rows written.
mode	all	search, monitor, awards or lookup.
keyword	search, monitor, awards	Full-text search over title, description, solicitation number (and awardee name in awards mode).
naicsCodes	search, monitor, awards	Industry codes, e.g. 541512. A 2-digit prefix matches the whole sector.
noticeTypes	search, monitor	o Solicitation, k Combined, p Presolicitation, r Sources Sought, s Special Notice, a Award, u Justification.
setAsides	search, monitor	Small-business set-asides: SBA, 8A, HZC, SDVOSBC, WOSB, EDWOSB, ...
activeOnly	search, monitor	Exclude archived and closed opportunities.
fetchDetails	all	Resolve the full detail record (NAICS, PSC, set-aside, contact, place of performance, award). One extra request per opportunity.
includeAttachments	all	Add attachment links with download URLs. One extra request per opportunity.
modifiedSince	monitor	ISO date (2026-09-01) or a relative window ("2 days", "1 week"). Required for monitor mode.
awardee	awards	Company name to match on award notices. Partial, case-insensitive.
awardeeUei	awards	Exact SAM.gov Unique Entity ID of the awardee.
noticeIds	lookup	32-character SAM.gov notice ids. Required for look-up mode.

Output reference (selected)

One row per opportunity. Values are null when SAM.gov does not publish that field for the notice, never invented.

Field	Description
notice_id / solicitation_number / title	Identity.
notice_type_code / notice_type	o / k / r / a ... and the human label.
status	active, inactive, archived or cancelled.
posted_date / response_deadline / last_modified / amendment_count	Dates and revision count.
agency_department / agency_subtier / agency_office	The organisation hierarchy, split into three levels.
naics_primary / naics_codes / psc_code	Classification.
set_aside_code / set_aside	Small-business set-aside, code and label.
pop_city / pop_state / pop_zip / pop_country	Place of performance.
contact_name / contact_email / contact_phone / contact_secondary_email	Contracting officer.
award_number / award_amount / award_date / awardee_name / awardee_uei	Award notices.
description	Full text, HTML stripped and entities decoded.
attachments	List of { name, url, type, size } - url is a direct download link.
change_type	new or modified - monitor mode only.
query / error	Set on an unresolved look-up id row.
url	The sam.gov page for the opportunity.
scraped_at	ISO 8601 collection timestamp.

Run via API and CLI

curl -X POST "https://api.apify.com/v2/acts/USERNAME~sam-gov-opportunities-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"mode":"monitor","naicsCodes":["541512"],"modifiedSince":"1 day","maxItems":500}'

$apify call USERNAME/sam-gov-opportunities-scraper --input '{"mode":"awards","awardee":"Leidos","maxItems":200}'

Fetch results

$curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

<DATASET_ID> is defaultDatasetId on the run object.

Billing and limits

• Pay per result. Billed per opportunity row written. The current rate is on the Actor's Pricing tab.
• No charge on failure. A run that produces zero rows fails with a message and is not billed.
• An unresolved look-up id still writes one error: "not found" row and is billed as a base row.
• Free Apify plans run the built-in 10-row sample only. Upgrade to run your own settings.
• SAM.gov's search endpoint returns at most the first 10,000 rows of a result set. Narrow the filters (add a NAICS code, a date window, a notice type) if a search matches more than that.
• fetchDetails and includeAttachments each add one request per opportunity. Leaving both off gives a fast, shallow scrape from the search endpoint alone.

FAQ and troubleshooting

Do I need an API key or a SAM.gov account? No. This uses the public endpoints the sam.gov website itself calls. There is no key, no login and no captcha.

Is this the same as SAM.gov's official Get Opportunities API? No. The official API needs a registered api.data.gov key and rate-limits it. This Actor reads the site's own search and detail endpoints, so it needs no key - and it resolves the full detail record and attachments, which the basic official feed does not.

How does monitor mode know what changed? It sorts the board by most-recently-modified and walks from the top, stopping as soon as it reaches an opportunity older than your modifiedSince. Each row is tagged new if it was first posted in the window, modified if it was only amended.

Why is a field null? SAM.gov did not publish it for that notice. Presolicitation notices often have no set-aside or place of performance yet; only award notices have award data. Missing values are null, never guessed.

Can I get more than 10,000 results? Not in one run - that is SAM.gov's limit. Split the search by NAICS code, agency or a date window and run each slice.

Is this an official SAM.gov tool? No. Independent, not affiliated with SAM.gov or the US government. It reads only data SAM.gov publishes openly.

Local development

bun install
bun test              # offline: normalisation and input logic
bun run src/main.ts   # reads storage/key_value_stores/default/INPUT.json
bun scripts/verify-live.mjs   # hits sam.gov directly, checks all four modes