# SAM.gov Contract Opportunities: Federal Bids & RFP Leads (`spriggs-data/sam-gov-contract-opportunities`) Actor

New federal contract opportunities from SAM.gov's official public data: solicitations, RFPs, sources sought, awards. Filter by date, NAICS, PSC, set-aside, state, agency, keyword. Contact emails, deadlines, links. No API key.

- **URL**: https://apify.com/spriggs-data/sam-gov-contract-opportunities.md
- **Developed by:** [Thomas Spriggs](https://apify.com/spriggs-data) (community)
- **Categories:** Lead generation, Business
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.30 / 1,000 contract 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## SAM.gov Contract Opportunities: Federal Bids, RFPs & Contracting Officer Contacts

Get **new U.S. federal contract opportunities** (solicitations, RFPs, RFQs, sources sought, presolicitations and award notices) from **SAM.gov's official public data extract**, filtered and normalized into one clean table, newest first.

- **Official source, no API key:** reads the public *Contract Opportunities* extract that SAM.gov (GSA) publishes for download every night. You don't need a SAM.gov account, an API key or a login, and the actor doesn't need a browser or proxies.
- **Fast and cheap:** the file is newest-first, so the actor reads only the part your date window needs. The last 7 days (about 5,000–6,000 notices) take a few seconds.
- **Contacts included:** about 99% of notices carry the contracting officer's **name, email and phone**.
- **Real filters:** notice type, keywords, **NAICS** and **PSC** codes (prefix match), **set-asides** (SBA, 8(a), SDVOSB, WOSB, HUBZone...), place-of-performance **state**, **agency**, open-only and with-email-only.

Use it for:

- **Bid alerts:** schedule a daily run for your NAICS codes and states, and get every new solicitation before your competitors do.
- **Small-business set-aside hunting:** every new SBA, 8(a), SDVOSB, WOSB or HUBZone opportunity in your trade.
- **Market research & capture:** sources-sought and presolicitation notices show what agencies plan to buy, months ahead.
- **Competitor and award tracking:** award notices with awardee, amount and date.
- **B2B lead lists:** contracting offices and officers buying roofing, janitorial, IT, construction, medical supplies and more.

### How much data is there?

Measured on the live file (November 2026): about **700 new notices per day**, 21,000+ per 30 days. In a typical week, combined synopsis/solicitations are about 43% of notices, awards 21%, solicitations 17%, sources sought 7%, presolicitations 5% and special notices 5%.

### Input

| Field | What it does |
|---|---|
| `daysBack` | Notices posted in the last N days (default 3, max 365). Or set an exact window with `postedAfter` / `postedBefore` (YYYY-MM-DD). |
| `noticeTypes` | `solicitation`, `combined`, `presolicitation`, `sources_sought`, `special_notice`, `award`, `justification`, `bundle`, `surplus`. Empty = all. |
| `keywords` | Words in the title or description, any of them (case-insensitive): `roofing`, `janitorial`, `cybersecurity`... |
| `naicsCodes` | NAICS codes or prefixes: `238160` (roofing), `5415` (IT services), `236` (building construction). |
| `pscCodes` | Product/service codes or prefixes: `Z2` (building repair), `DA` / `DB` (IT), `S2` (housekeeping). |
| `setAsideCodes` | Exact SAM set-aside codes: `SBA`, `SBP`, `8A`, `8AN`, `SDVOSBC`, `WOSB`, `EDWOSB`, `HZC`... |
| `states` | Place-of-performance states (`TX`, `VA`, `CA`...). |
| `agencies` | Words matched against department, sub-tier and office (`veterans affairs`, `army`, `GSA`). |
| `onlyOpen` | Only notices whose response deadline hasn't passed. |
| `onlyWithEmail` | Only notices with a primary contact email. |
| `includeDescription` | Include the full notice description text (default `true`; turn off for smaller output). |
| `maxItems` | Cap on notices saved and charged (default 100). |

#### Examples

Open small-business IT solicitations from the last 7 days:

```json
{ "daysBack": 7, "naicsCodes": ["5415"], "setAsideCodes": ["SBA", "SBP"], "noticeTypes": ["solicitation", "combined"], "onlyOpen": true }
```

Roofing and building-repair bids in Texas, still open:

```json
{ "daysBack": 14, "keywords": ["roof"], "pscCodes": ["Z2"], "states": ["TX"], "onlyOpen": true, "maxItems": 500 }
```

Every sources-sought notice from the last 2 days (market research):

```json
{ "daysBack": 2, "noticeTypes": ["sources_sought"], "maxItems": 1000 }
```

Veterans Affairs award notices this week (competitor tracking):

```json
{ "daysBack": 7, "noticeTypes": ["award"], "agencies": ["veterans affairs"], "maxItems": 500 }
```

### Output

One record per notice. A real record (November 2026, description shortened):

```json
{
  "noticeId": "5104403adcd7447ba835e779f185df6b",
  "title": "Tungsten Software",
  "solicitationNumber": "N6328527QS010",
  "noticeType": "Solicitation",
  "noticeTypeKey": "solicitation",
  "postedDate": "2026-11-13",
  "responseDeadline": "2026-11-17T10:00:00-05:00",
  "active": true,
  "department": "DEPT OF DEFENSE",
  "subTier": "DEPT OF THE NAVY",
  "office": "NCIS QUANTICO VA",
  "setAsideCode": "SBA",
  "setAside": "Small Business Set Aside - Total",
  "naicsCode": "541519",
  "pscCode": "7A21",
  "placeOfPerformance": { "city": "Quantico", "state": "VA", "zip": "22134", "country": "USA" },
  "award": null,
  "primaryContactName": "Felice Walker",
  "primaryContactEmail": "felice.walker@ncis.navy.mil",
  "primaryContactPhone": "571-305-9561",
  "url": "https://sam.gov/workspace/contract/opp/5104403adcd7447ba835e779f185df6b/view",
  "description": "The NCIS Records Department Imaging Specialists require software to ...",
  "fileLastModified": "Mon, 16 Nov 2026 04:30:18 GMT"
}
```

Award notices also fill `award` with `number`, `date`, `amount` and `awardee`. Each run also saves a `RUN_SUMMARY` record (window, rows scanned, MB read, notices saved).

### Pricing

Pay per result: **$2.00 per 1,000 notices** on the Free plan, going down to **$1.30 per 1,000** on Gold and higher plans, plus a tiny actor-start fee. A daily 3-day alert of 100 notices costs about $0.20. You can cap the cost with `maxItems` or with the run's maximum cost setting; the actor stops cleanly when the cap is reached.

### Freshness and limits

- SAM.gov regenerates the extract **once a night** (around 10:30 PM US Central). Notices posted today show up after the next refresh, so set `daysBack` to at least 1–2.
- Notices are as published by the agencies. Amendments appear as separate notices with the same solicitation number.
- Attachments (PDFs) aren't included. Use the `url` to open the notice on SAM.gov.
- This actor is not affiliated with SAM.gov or the U.S. General Services Administration. SAM.gov data is U.S. government public data.

### FAQ

**Do I need a SAM.gov API key?** No. The actor uses the public data extract, which needs no key and no account.

**How is this different from the SAM.gov search site?** You get structured data with contact emails for a whole time window in one run, with filters SAM's site can't combine (for example NAICS prefix + set-aside + state + keyword), ready for spreadsheets, CRMs or AI agents.

**Can I get alerts?** Yes. Save your input as a task and schedule it daily with `daysBack: 2`. Duplicate notices between runs share the same `noticeId`, so they're easy to drop.

### Related actors by Spriggs Data

- [US Building Permits](https://apify.com/spriggs-data/us-building-permits): construction, roofing and solar permit leads from 30+ US cities.
- [US Contractor License Lookup](https://apify.com/spriggs-data/us-contractor-license-lookup): contractor licenses across 9 states.
- [US New Business Filings](https://apify.com/spriggs-data/us-new-business-filings): new LLC and corporation leads (FL, NY, CO, CT, OR).

# Actor input Schema

## `daysBack` (type: `integer`):

Notices posted in the last N days (the file is newest first, so short windows are fast and cheap). Ignored when Posted after is set.

## `postedAfter` (type: `string`):

Optional. Earliest posted date (YYYY-MM-DD, inclusive).

## `postedBefore` (type: `string`):

Optional. Latest posted date (YYYY-MM-DD, inclusive). Defaults to today.

## `noticeTypes` (type: `array`):

Keep only these notice types. Empty = all. Bidders usually want solicitation, combined and presolicitation; market research teams want sources_sought; competitor tracking wants award.

## `keywords` (type: `array`):

Keep notices whose title or description contains any of these words (case-insensitive), e.g. 'roofing', 'janitorial', 'cybersecurity'.

## `naicsCodes` (type: `array`):

NAICS codes or prefixes, e.g. '238160' (roofing contractors) or '5415' (computer systems design). A prefix matches every code under it.

## `pscCodes` (type: `array`):

Product/service codes or prefixes, e.g. 'Z2' (repair of buildings) or 'D3' (IT services).

## `setAsideCodes` (type: `array`):

Exact SAM set-aside codes, e.g. SBA (total small business), 8A, HZC (HUBZone), SDVOSBC (service-disabled veteran), WOSB, EDWOSB, ISBEE.

## `states` (type: `array`):

Two-letter state codes for the place of performance, e.g. TX, VA.

## `agencies` (type: `array`):

Department, sub-tier or office name contains any of these, e.g. 'army', 'veterans affairs', 'NAVFAC'.

## `onlyOpen` (type: `boolean`):

Skip notices whose response deadline is in the past or missing.

## `onlyWithEmail` (type: `boolean`):

Skip notices without a primary contact email (about 99% have one).

## `includeDescription` (type: `boolean`):

The full notice text. Turn off for smaller, lighter rows.

## `maxItems` (type: `integer`):

Hard cap on notices saved (and charged) per run.

## Actor input object example

```json
{
  "daysBack": 3,
  "keywords": [
    "roofing"
  ],
  "onlyOpen": false,
  "onlyWithEmail": false,
  "includeDescription": true,
  "maxItems": 100
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "daysBack": 3,
    "keywords": [
        "roofing"
    ],
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("spriggs-data/sam-gov-contract-opportunities").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "daysBack": 3,
    "keywords": ["roofing"],
    "maxItems": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("spriggs-data/sam-gov-contract-opportunities").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "daysBack": 3,
  "keywords": [
    "roofing"
  ],
  "maxItems": 100
}' |
apify call spriggs-data/sam-gov-contract-opportunities --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,spriggs-data/sam-gov-contract-opportunities"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/KaXNJzpofg8uPcgdl/builds/59tOwafyOCbVQRFgE/openapi.json
