SAM.gov Contract Opportunity Monitor

Monitor US federal contract opportunities published on SAM.gov with deep filters, incremental runs, and optional award-history enrichment. Built on the official SAM.gov Contract Opportunities API — no scraping, no proxies, near-zero platform cost.

What it does

• Deep filters — keywords (title), NAICS codes, set-aside types (8(a), HUBZone, SDVOSB, WOSB…), agencies, notice types (Solicitation, Pre-solicitation, Combined, Sources Sought, Award Notice), posting-date window, contract value, deadline window.
• Incremental mode — each scheduled run returns only notices not seen before. Built for daily schedules.
• Award-history enrichment (optional) — attaches past contract awards for the same solicitation number.
• Pay-per-result — charges one result event per notice returned.

Input

{
  "samGovApiKey": "YOUR_FREE_SAM_GOV_API_KEY",
  "keywords": ["cybersecurity"],
  "naicsCodes": ["541512"],
  "setAsideTypes": ["8(a)", "SDVOSB"],
  "agencies": ["Veterans Affairs"],
  "noticeTypes": ["Solicitation"],
  "postedFrom": "2026-09-01",
  "postedTo": "2026-10-01",
  "deadlineWithinDays": 30,
  "maxResults": 100,
  "incremental": true,
  "includeAwardHistory": false,
  "maxAwardLookups": 25
}

Notes:

• samGovApiKey can be left empty if you set the SAM_GOV_API_KEY actor secret instead (recommended — keeps the key out of run inputs).
• Get a free key: sam.gov → sign in → profile → Account Details → enter password → Public API Key.
• setAsideTypes accepts friendly names (8(a), HUBZone, SDVOSB, SBA, WOSB…) or official codes (8A, HZC, SDVOSBC, SBA…).
• The API accepts one value per query for title/NAICS/set-aside/type, so multi-value filters fan out into multiple sub-queries (capped at 16 — narrow filters if you hit the cap).

Output (dataset record)

{
  "noticeId": "fff7063befcc4554ac85243e4a90c472",
  "title": "…",
  "agency": "DEPT OF DEFENSE / …",
  "office": "…",
  "noticeType": "Solicitation",
  "postedDate": "2026-10-01",
  "responseDeadline": "2026-10-19T10:00:00-05:00",
  "daysUntilDeadline": 18,
  "naicsCode": "541512",
  "setAside": "SDVOSBC",
  "contractValue": { "min": null, "max": 1200000, "currency": "USD" },
  "placeOfPerformance": { "city": "Austin", "state": "TX" },
  "buyerContact": { "name": "…", "email": "…", "phone": "…" },
  "description": "…",
  "solicitationNumber": "36C10X26Q0001",
  "awardHistory": [{ "awardee": "…", "amount": 1100000, "awardDate": "2025-06-15" }],
  "sourceUrl": "https://sam.gov/opp/…/view"
}

Buyer contact fields come from the notice's publicly listed point of contact. No personal-data scraping.

Monetization (proposed, pending approval)

• Pay-per-result: $2 / 1,000 results (benchmark $1–5). One result event per notice.
• Official API → no proxy/residential-IP cost, so margin is high.

Local development

npm install            # apify-cli
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
# integration test against canned real API responses (no key needed):
.venv/bin/python tests/make_fixture.py   # needs the sam-gov skill credential
SAM_GOV_FIXTURE=tests/fixture.json ./node_modules/.bin/apify run --input '{…}'

Deploy

./node_modules/.bin/apify login     # your Apify account (run once)
./node_modules/.bin/apify push      # builds & deploys to your account

Then in Apify Console: set the SAM_GOV_API_KEY secret (Actor → Settings → Environment variables), add a daily Schedule with incremental: true, and configure monetization (Pay-per-result → result event at $0.002).

Limits & honesty

• Public-tier SAM.gov keys are rate-limited (~1,000 requests/day). This actor stays far below that for normal use; maxAwardLookups caps enrichment calls.
• Contract-value filtering only applies when the notice publishes amount data — solicitations often don't, and those are kept rather than silently dropped.
• Revenue figures depend on paid-plan users adopting the Actor; most new Actors see little traffic at first. Numbers in planning docs are estimates.