# SAM.gov Federal Contract Opportunities Scraper (`scrapers_lat/sam-gov-opportunities-scraper`) Actor
Scrape US federal contract opportunities and solicitations from SAM.gov (ex-FedBizOpps). Export notice ID, agency, NAICS, set-aside, deadlines, award amount, point of contact and place of performance to JSON, CSV or Excel.
- **URL**: https://apify.com/scrapers\_lat/sam-gov-opportunities-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Lead generation, Business, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars
## Pricing
from $10.00 / 1,000 opportunities
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".
## 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.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
[](https://console.apify.com/actors/gofbmUlpirrL9uB5k/input)
## SAM.gov Federal Contract Opportunities Scraper
> Extract US federal contract opportunities and solicitations from SAM.gov (the system that replaced FedBizOpps), across all federal agencies and 47,000+ active notices.
23 fields per opportunity
US Federal all agencies
JSON / CSV / Excel output formats
Updated 2026-06-27
### What you get
Each record is one federal contract opportunity (solicitation, presolicitation, combined synopsis, sources sought, award notice or special notice) with the buyer, the requirement, the deadline and the contact you need to respond.
- **title**: the notice title
- **type**: notice type (Solicitation, Combined Synopsis/Solicitation, Presolicitation, Sources Sought, Award Notice, Special Notice and more)
- **baseType**: the original base notice type
- **uiLink**: direct link to the opportunity on SAM.gov
- **noticeId**: the unique SAM.gov notice identifier
- **solicitationNumber**: the agency solicitation or reference number
- **fullParentPathName**: full department and agency hierarchy (for example Department of Defense.Department of the Navy.NAVSUP)
- **parentNoticeId**: the parent notice ID when the notice is an update or amendment
- **postedDate**: when the notice was published
- **responseDeadLine**: the offer due date and time
- **modifiedDate**: when the notice was last updated
- **isActive**: whether the opportunity is currently active
- **isCanceled**: whether the notice was canceled
- **award**: award amount, award number, award date and awardee (name, UEI, CAGE code) when the notice is an award
- **naicsCode\***: the primary NAICS industry code
- **classificationCode\***: the product or service classification (PSC) code
- **setAside\***: small business or socio-economic set-aside program (8(a), HUBZone, SDVOSB, WOSB and others)
- **archiveDate\***: when the notice will be archived
- **placeOfPerformance\***: city, state, country and zip where the work is performed
- **pointOfContact\***: name, email, phone and fax of the contracting contacts
- **description\***: the full notice description as plain text
- **observedAt**: when this opportunity was last seen by the scraper
*\*These fields only appear when withDetails is set to true.*
### Who is it for
| Use case | Who benefits |
|---|---|
| Find open bids to respond to | Government contractors and bid teams |
| Build a pipeline of agency requirements | Business development and capture managers |
| Monitor competitors and award winners | Market intelligence and pricing analysts |
| Source set-aside opportunities | Small, 8(a), HUBZone, SDVOSB and WOSB firms |
| Feed a CRM or alerting workflow | GovCon software and data vendors |
### Frequently Asked Questions
**What does the SAM.gov opportunities scraper cover?**
It covers US federal contract opportunities posted on SAM.gov, the official system that replaced FedBizOpps. That includes solicitations, combined synopsis/solicitations, presolicitations, sources sought, special notices and award notices from every federal department and agency, with more than 47,000 active notices at any time.
**Do I need a SAM.gov API key?**
No. The scraper reads the same public data service that powers the SAM.gov search interface, so no API key, account or registration is required.
**How many opportunities can I scrape in one run?**
Set the Max Items input to whatever you need. You can pull a handful of recent notices or thousands across a date range. Use the search term, NAICS, set-aside, notice type and posted date filters to target exactly the opportunities you want.
**Can I filter by NAICS code, set-aside or agency?**
Yes. You can filter by free-text keyword, six-digit NAICS code, set-aside program, notice type and a posted/updated date window. Leave filters blank to get the most recently updated notices across all agencies.
**Why are NAICS, place of performance or description sometimes empty?**
Some notice types, especially award notices and simplified repair notices, do not carry a NAICS code, place of performance or full description on SAM.gov. The scraper returns every field the notice actually has and leaves the rest null rather than inventing data. Enable Fetch opportunity details to pull the richest possible record for each notice.
### Example use cases
Ready-to-run example tasks, each preconfigured for a common scenario. Open one and press run, or use it as a template:
- [SAM.gov Construction Opportunities](https://apify.com/scrapers_lat/sam-gov-opportunities-scraper/examples/sam-gov-construction-opportunities): Monitor active federal construction solicitations on SAM.gov with agency, set-aside, deadline and point of contact.
- [SAM.gov Cybersecurity Contracts](https://apify.com/scrapers_lat/sam-gov-opportunities-scraper/examples/sam-gov-cybersecurity-contracts): Find active federal cybersecurity contract opportunities on SAM.gov with agency, NAICS code, deadline and contact.
- [SAM.gov Software Contracts](https://apify.com/scrapers_lat/sam-gov-opportunities-scraper/examples/sam-gov-software-contracts): Track active US federal software contract opportunities on SAM.gov with agency, NAICS, deadline and contact.
### Related scrapers
Need data from the same space? Here are other scrapers we build and maintain:
- [USAspending Federal Award Scraper](https://apify.com/scrapers_lat/usaspending-awards-scraper): every US federal prime award with recipient, amount and agency.
- [USAspending Sub-Award Scraper](https://apify.com/scrapers_lat/usaspending-subawards-scraper): federal sub-awards and the subcontractors behind prime contracts.
- [Grants.gov Opportunity Scraper](https://apify.com/scrapers_lat/grants-gov-scraper): federal grant funding opportunities by agency, CFDA and status.
- [SEC EDGAR Company Filings Scraper](https://apify.com/scrapers_lat/sec-edgar-filings-scraper): SEC filings and documents for any US public company.
- [New York Business Entity Scraper](https://apify.com/scrapers_lat/ny-dos-business-scraper): New York company registrations, status, type and registered agent.
- [OFAC Sanctions List Scraper](https://apify.com/scrapers_lat/ofac-sanctions-scraper): US Treasury OFAC sanctioned individuals and entities for vendor screening.
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for Latin American and US public platforms: real estate, jobs, e-commerce, company registries and government data. Browse the full catalog, see live sample output for each one, or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with SAM.gov or the US General Services Administration. It only accesses data that is publicly available on the platform. Use it in accordance with SAM.gov's terms of service.
# Actor input Schema
## `maxItems` (type: `integer`):
Maximum number of opportunities to collect. Optional.
## `withDetails` (type: `boolean`):
When enabled, the scraper opens each notice to add NAICS, classification code, set-aside, response deadline, archive date, award amount, point of contact, place of performance and the full description. Adds one request per opportunity.
## `searchTerm` (type: `string`):
Free-text keyword searched across notice title and content (for example: cybersecurity, janitorial, ambulance, software).
## `noticeTypes` (type: `array`):
Types of notice to include. Leave empty to include every type.
## `naics` (type: `string`):
Six-digit NAICS industry code to filter by (for example: 541511 for custom computer programming).
## `setAside` (type: `string`):
Restrict to a small-business or socio-economic set-aside program.
## `postedFrom` (type: `string`):
Earliest updated/posted date (MM/DD/YYYY or YYYY-MM-DD). Filters by the date a notice was last published or updated on SAM.gov.
## `postedTo` (type: `string`):
Latest updated/posted date (MM/DD/YYYY or YYYY-MM-DD).
## `activeOnly` (type: `boolean`):
When enabled, only currently active (not archived) notices are returned. Disable to include archived and award notices.
## Actor input object example
```json
{
"maxItems": 10,
"withDetails": true,
"searchTerm": "software",
"setAside": "",
"activeOnly": true
}
````
# Actor output Schema
## `results` (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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxItems": 10,
"searchTerm": "software"
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/sam-gov-opportunities-scraper").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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"maxItems": 10,
"searchTerm": "software",
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/sam-gov-opportunities-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxItems": 10,
"searchTerm": "software"
}' |
apify call scrapers_lat/sam-gov-opportunities-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/sam-gov-opportunities-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "SAM.gov Federal Contract Opportunities Scraper",
"description": "Scrape US federal contract opportunities and solicitations from SAM.gov (ex-FedBizOpps). Export notice ID, agency, NAICS, set-aside, deadlines, award amount, point of contact and place of performance to JSON, CSV or Excel.",
"version": "0.1",
"x-build-id": "E86y6UmcbMOujsgMQ"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~sam-gov-opportunities-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-sam-gov-opportunities-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/scrapers_lat~sam-gov-opportunities-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-sam-gov-opportunities-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/scrapers_lat~sam-gov-opportunities-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-sam-gov-opportunities-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of opportunities to collect. Optional."
},
"withDetails": {
"title": "Fetch opportunity details",
"type": "boolean",
"description": "When enabled, the scraper opens each notice to add NAICS, classification code, set-aside, response deadline, archive date, award amount, point of contact, place of performance and the full description. Adds one request per opportunity.",
"default": true
},
"searchTerm": {
"title": "Search term",
"type": "string",
"description": "Free-text keyword searched across notice title and content (for example: cybersecurity, janitorial, ambulance, software)."
},
"noticeTypes": {
"title": "Notice types",
"type": "array",
"description": "Types of notice to include. Leave empty to include every type.",
"items": {
"type": "string",
"enum": [
"o",
"k",
"p",
"r",
"a",
"s",
"g",
"i",
"u"
],
"enumTitles": [
"Solicitation",
"Combined Synopsis/Solicitation",
"Presolicitation",
"Sources Sought",
"Award Notice",
"Special Notice",
"Sale of Surplus Property",
"Intent to Bundle Requirements",
"Justification (J&A)"
]
}
},
"naics": {
"title": "NAICS code",
"type": "string",
"description": "Six-digit NAICS industry code to filter by (for example: 541511 for custom computer programming)."
},
"setAside": {
"title": "Set-aside",
"enum": [
"",
"SBA",
"SBP",
"8A",
"8AN",
"HZC",
"HZS",
"SDVOSBC",
"SDVOSBS",
"WOSB",
"WOSBSS",
"EDWOSB",
"EDWOSBSS",
"VSA",
"VSS",
"LAS",
"IEE"
],
"type": "string",
"description": "Restrict to a small-business or socio-economic set-aside program.",
"default": ""
},
"postedFrom": {
"title": "Posted from",
"type": "string",
"description": "Earliest updated/posted date (MM/DD/YYYY or YYYY-MM-DD). Filters by the date a notice was last published or updated on SAM.gov."
},
"postedTo": {
"title": "Posted to",
"type": "string",
"description": "Latest updated/posted date (MM/DD/YYYY or YYYY-MM-DD)."
},
"activeOnly": {
"title": "Active opportunities only",
"type": "boolean",
"description": "When enabled, only currently active (not archived) notices are returned. Disable to include archived and award notices.",
"default": true
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```