SAM.gov Contract Opportunities Scraper

Scrape US federal government contract opportunities from SAM.gov — the official System for Award Management. Find solicitations, pre-solicitations, sources sought, awards, and more using keyword search, NAICS codes, set-aside types, and date filters.

What data does this actor extract?

Each record contains:

Field	Description
noticeId	Unique SAM.gov opportunity ID
title	Opportunity title
solicitationNumber	Solicitation/RFP number
department	Federal department (e.g. Department of Defense)
agency	Issuing agency
office	Contracting office
postedDate	Date the opportunity was posted
type	Notice type (Solicitation, Pre-Solicitation, etc.)
baseType	Base notice type code
archiveDate	Date the opportunity will be archived
archiveType	Archive type
setAside	Set-aside designation (e.g. Small Business)
setAsideCode	Set-aside code
naicsCode	NAICS industry code
classificationCode	Product/Service Code (PSC)
active	Whether the opportunity is active
awardDate	Award date (if awarded)
awardAmount	Award dollar amount
awardeeName	Name of awardee company
pointOfContact	List of contacts with name, email, and type
officeAddress	Contracting office address
placeOfPerformance	Location where work will be performed
description	Opportunity description or link
sourceUrl	Direct link to the opportunity on SAM.gov
recordType	Always "opportunity"
scrapedAt	ISO timestamp of when the record was scraped

Input

Field	Type	Description
mode	select	searchOpportunities (default) or getOpportunityDetail
apiKey	string	Free API key from sam.gov/content/sam-api (optional but recommended)
searchQuery	string	Keywords to search (e.g. "software development", "construction")
opportunityType	select	Filter by notice type: Solicitation, Pre-Solicitation, Sources Sought, Special Notice, Sale of Surplus
naicsCode	string	NAICS code filter (e.g. "541511")
setAside	select	Small business set-aside type (HUBZone, SBA, 8(a), WOSB, etc.)
postedFrom	string	Start date filter YYYY-MM-DD
postedTo	string	End date filter YYYY-MM-DD
noticeIds	array	Notice IDs for getOpportunityDetail mode
maxItems	integer	Maximum records to return (1–500, default 25)

Getting a Free API Key

1. Register at sam.gov/content/sam-api
2. Create a System Account or use a Personal API key
3. Pass the key as apiKey in the input

Without an API key, the actor will attempt requests but may receive a 403 Forbidden response from SAM.gov. When this happens, the actor emits a clear error record explaining how to get the free key.

Example Input

{
  "mode": "searchOpportunities",
  "searchQuery": "software development",
  "opportunityType": "k",
  "setAside": "SBA",
  "maxItems": 50
}

Example Output

{
  "noticeId": "abc123def456",
  "title": "Software Development Services",
  "solicitationNumber": "W91CRB-24-R-0001",
  "department": "Department of Defense",
  "agency": "Department of the Army",
  "office": "ACC-APG",
  "postedDate": "2024-01-15",
  "type": "k",
  "setAside": "Small Business",
  "setAsideCode": "SBA",
  "naicsCode": "541511",
  "active": true,
  "pointOfContact": [
    {"type": "primary", "name": "Jane Doe", "email": "jane.doe@army.mil"}
  ],
  "sourceUrl": "https://sam.gov/opp/abc123def456/view",
  "recordType": "opportunity",
  "scrapedAt": "2024-01-20T10:30:00+00:00"
}

Frequently Asked Questions

Q: Do I need an API key? A: An API key is strongly recommended. Without one, SAM.gov may return 403 errors. Get a free key at sam.gov/content/sam-api.

Q: What is the rate limit? A: SAM.gov public API has rate limits that vary by key tier. The actor handles rate limit responses with automatic retries.

Q: How do I find opportunities for my industry? A: Use the naicsCode filter. Find your NAICS code at naics.com.

Q: What does "Sources Sought" mean? A: A market research notice used by agencies to identify capable vendors before issuing a formal solicitation.

Q: Can I track new opportunities automatically? A: Yes — schedule this actor to run daily and filter by postedFrom to get only new postings.

Q: What set-aside types are available? A: HUBZone, Small Business, 8(a), HBCUs/MIs, Emerging Small Business, Indian Small Business, Veteran-Owned, and Woman-Owned Small Business.