Combined Synopsis/Solicitation
…", "contacts": [ { "type": "primary", "name": "1st Lt Shane Yurkus", "email": "shane.yurkus@us.af.mil", "phone": "3077734750", "title": null } ], "attachments": [ { "name": "Attachment 5 - PWS 1 Sep 26.pdf", "url": "https://sam.gov/api/prod/opps/v3/opportunities/resources/files/faf6da35ff9c4552b2bace4f6bb5bca2/download", "type": "file", "sizeBytes": 585939, "mimeType": "application/pdf", "postedDate": "2026-09-01T22:28:46Z", "access": "public" } ], "award": null, "parentNoticeId": null, "url": "https://sam.gov/opp/a4465f9866914944bcc89ad83ac6b023/view", "scrapedAt": "2026-09-02T20:41:03Z" } ``` Award example (shortened): ```json { "recordType": "award", "source": "usaspending.gov", "id": "CONT_AWD_36C24222P1517_3600_-NONE-_-NONE-", "title": "EMS MACHINE MAINTENENCE", "awardId": "36C24222P1517", "solicitationNumber": "36C24222Q1079", "awardType": { "code": "B", "name": "Purchase Order" }, "status": "active", "recipient": { "name": "AMERICAN CUSTODIAL INC", "uei": "CSNWZH2EKLJ9", "parentName": "AMERICAN CUSTODIAL INC", "parentUei": "CSNWZH2EKLJ9", "city": "BUFFALO", "state": "NY", "country": "USA", "recipientId": "d8c83545-…-C" }, "agency": { "department": "Department of Veterans Affairs", "subTier": "Department of Veterans Affairs", "office": "242-NETWORK CONTRACT OFFICE 02 (36C242)", "organizationId": null }, "fundingAgency": { "department": "Department of Veterans Affairs", "subTier": "Department of Veterans Affairs" }, "amounts": { "obligated": 85265.0, "baseAndAllOptions": 85265.0, "baseAndExercisedOptions": 85265.0, "totalOutlays": null }, "dates": { "start": "2022-09-20", "end": "2027-08-31", "lastModified": "2026-08-31", "signed": "2022-09-20" }, "naicsCodes": ["811310"], "naicsName": "COMMERCIAL AND INDUSTRIAL MACHINERY AND EQUIPMENT (EXCEPT AUTOMOTIVE AND ELECTRONIC) REPAIR AND MAINTENANCE", "pscCode": "J079", "pscName": "MAINT/REPAIR/REBUILD OF EQUIPMENT- CLEANING EQUIPMENT AND SUPPLIES", "setAside": { "code": "SBA", "name": "Total Small Business Set-Aside (FAR 19.5)" }, "extentCompeted": "FULL AND OPEN COMPETITION", "pricingType": "FIRM FIXED PRICE", "parentAwardId": null, "placeOfPerformance": { "city": "BUFFALO", "state": "NY", "zip": "14215", "country": "USA" }, "url": "https://www.usaspending.gov/award/CONT_AWD_36C24222P1517_3600_-NONE-_-NONE-", "scrapedAt": "2026-09-02T20:45:12Z" } ``` #### Opportunity fields | Field | Description | |---|---| | `id`, `url` | SAM.gov notice id and public notice page. | | `title`, `solicitationNumber`, `noticeType` | Notice title, solicitation number and type (`o` Solicitation, `k` Combined Synopsis/Solicitation, `p` Presolicitation, `r` Sources Sought, `a` Award Notice, `s` Special Notice, `u` Justification, `g` Sale of Surplus Property, `i` Intent to Bundle). | | `status` | `active`, `inactive`, `cancelled`, `archived` or `deleted`. | | `postedDate`, `modifiedDate`, `responseDeadline`, `archiveDate` | ISO-8601 timestamps (UTC). | | `agency` | Department, sub-tier, contracting office and SAM.gov organization id. | | `naicsCodes`, `pscCode`, `setAside` | Industry and product/service codes, set-aside code and name. | | `placeOfPerformance` | City, state, ZIP and country. | | `description`, `descriptionHtml` | Full notice text (plain and original HTML). | | `contacts` | Points of contact with name, email, phone and title. | | `attachments` | Name, direct download URL, type, size, MIME type, posted date and access level of each attachment. | | `award` | For award notices: contract number, date, amount and awardee (name, UEI, CAGE, location). | #### Award fields | Field | Description | |---|---| | `id`, `awardId`, `url` | USASpending internal id, contract number (PIID) and award page. | | `title` | Award description. | | `awardType` | BPA Call, Purchase Order, Delivery Order, Definitive Contract, or the IDV type. | | `status` | `active` while the period of performance is open, `completed` afterwards. | | `recipient` | Name, UEI, parent company, location; with details also business categories and officers. | | `agency`, `fundingAgency` | Awarding and funding department / sub-agency (office with details). | | `amounts` | Obligated amount, base and all options, exercised options, outlays. | | `dates` | Period of performance start/end, last modified, date signed. | | `naicsCodes`, `naicsName`, `pscCode`, `pscName` | Industry and product/service codes with descriptions. | | `setAside`, `extentCompeted`, `pricingType`, `parentAwardId`, `solicitationNumber` | Competition details (require `includeAwardDetails`). | | `placeOfPerformance` | City, state, ZIP and country. | ### How much does it cost to scrape SAM.gov and USASpending? The Actor uses pay-per-event pricing: | Event | Price | |---|---| | Actor start | $0.01 per run | | Opportunity scraped | $0.002 per record (details and attachments included) | | Award scraped | $0.001 per record (award details included) | A daily monitor returning 50 new notices costs about $0.11 per run; a 1,000-award research pull costs about $1.01. Apify's free plan includes enough monthly credit to try the Actor. ### Tips - **Keep `maxItems` reasonable for exploratory runs**, then raise it. Every opportunity with details costs two requests (detail + attachment list); turning off `includeAttachments` halves that. - **Use NAICS and set-aside filters instead of only keywords** — they run server-side and cut the number of notices to enrich. - **Search API limit**: a single SAM.gov query returns at most 10,000 notices. The Actor automatically splits wide date windows into smaller ones; for a full snapshot use **bulk mode** with `postedWithinDays: 0`. - **Bulk mode** reads the daily extract of *active* notices (refreshed nightly). Attachments still require one request per notice, so combine bulk mode with narrow filters or disable `includeAttachments`. - **Keyword modes**: on SAM.gov `any` matches any single word, `all` requires every word, `exact` matches the phrase. USASpending keywords must be at least 3 characters; `all`/`exact` are applied after fetching. - **Agency names**: departments and the main sub-tiers are resolved to server-side filters; anything else is matched by name after fetching, which uses a few more requests but stays correct. - **Department of Defense awards appear with a ~90-day delay** on USASpending (DoD withholds contract data for 90 days). A DoD award search over the last few weeks will legitimately return nothing — widen the window to 90+ days. - **`onlyNew` state** is stored in the named key-value store `usa-gov-contracts-state`, keyed by a hash of your filters (dates and `maxItems` excluded). Delete that record to reset a monitor. - The run's key-value store contains a `RUN_SUMMARY` record with request counts and how many records each filter dropped. ### FAQ, disclaimers and support **Is this legal?** SAM.gov and USASpending publish this data as public information of the U.S. Government. The Actor reads the same endpoints the public websites use, at a polite rate, and stores only what the agencies publish (including contracting officers' business contact details, which agencies publish so vendors can respond to solicitations). Make sure your own use of the data complies with the sites' terms and applicable law. **Why did my run return fewer records than expected?** Check the `RUN_SUMMARY` record: filters that can't run server-side (state, PSC on SAM.gov; exact phrases on USASpending) are applied after fetching and reported there. `onlyNew` also hides records returned by earlier runs. **Are attachment files downloaded?** Not in this version — you get direct download URLs that work without a login. File storage and an FPDS award-modification feed are on the roadmap. **Does it cover state and local procurement, or grants?** No — federal contracts only. Grants.gov and state portals are separate sources. Found an issue or need a custom field, source or integration? Open a ticket in the **Issues** tab of the Actor, or contact the author for a custom solution. # Actor input Schema ## `dataSource` (type: `string`): Contract opportunities are open solicitations, pre-solicitations, sources-sought and award notices from SAM.gov. Contract awards are awarded contracts (who won what, for how much) from USASpending.gov. ## `keywords` (type: `array`): Search terms matched against title and description, e.g.cybersecurity, janitorial services. Multiple terms are combined according to Keyword mode.
## `keywordMode` (type: `string`):
Any – at least one term must match. All – every term must match. Exact – the exact phrase must appear.
## `naicsCodes` (type: `array`):
Industry codes, 2 to 6 digits. Shorter codes act as prefixes, e.g. 5415 matches 541511, 541512, 541519.
## `pscCodes` (type: `array`):
Product/Service Codes, 1 to 4 characters. Shorter codes act as prefixes, e.g. DA matches all IT and telecom services, 70 all IT products.
## `setAsideCodes` (type: `array`):
Only include notices/awards set aside for these small-business categories.
## `agencies` (type: `array`):
Department or sub-agency names or common abbreviations, e.g. Department of Defense, VA, Army, NASA, Bureau of Prisons. Any of the listed agencies matches.
## `states` (type: `array`):
Two-letter US state/territory codes (e.g. VA, TX) or full names. Matches the place of performance.
## `postedWithinDays` (type: `integer`):
Rolling date window. Opportunities: last modified date; awards: action date. Set 0 for no date limit (ignored when an absolute date range is given).
## `postedFrom` (type: `string`):
Absolute start of the date window. Overrides Posted within last N days.
## `postedTo` (type: `string`):
Absolute end of the date window (inclusive). Defaults to today when only Posted from is set.
## `maxItems` (type: `integer`):
Stop after this many records across all sources. 0 = no limit (the SAM.gov search API returns at most 10,000 results per query; use Bulk mode for more).
## `noticeTypes` (type: `array`):
Which SAM.gov notice types to include.
## `activeOnly` (type: `boolean`):
Skip archived/expired notices.
## `responseDeadlineFrom` (type: `string`):
Only notices whose response deadline is on or after this date.
## `responseDeadlineTo` (type: `string`):
Only notices whose response deadline is on or before this date.
## `includeDetails` (type: `boolean`):
Fetch each notice's detail page for the full description, points of contact, NAICS, PSC, set-aside and place of performance (one extra request per notice). When off, only the fields available in search results are returned and state/PSC filters cannot be applied.
## `includeAttachments` (type: `boolean`):
List each notice's attachments (name, size, type and direct download URL). Adds one request per notice. Files themselves are not downloaded.
## `awardTypes` (type: `string`):
Contracts – definitive contracts, purchase orders, delivery orders and BPA calls. IDVs – indefinite delivery vehicles (IDIQs, GWACs, BPAs, FSS).
## `awardAmountMin` (type: `integer`):
Only awards with an obligated amount at or above this value.
## `awardAmountMax` (type: `integer`):
Only awards with an obligated amount at or below this value.
## `recipientSearch` (type: `string`):
Recipient (vendor) name, UEI or DUNS, e.g. Leidos.
## `includeAwardDetails` (type: `boolean`):
Fetch each award's detail record for competition type, pricing type, parent IDV, recipient parent company and officers (one extra request per award).
## `onlyNew` (type: `boolean`):
Remember which records were already returned by previous runs with the same filters and output only new ones. Combine with a schedule and an integration (email, Slack, webhook) to get alerts for new opportunities.
## `bulkMode` (type: `boolean`):
Read opportunities from SAM.gov's daily public CSV extract (all ~50,000+ active notices, refreshed nightly) instead of the search API. Best for full snapshots or when a query would exceed 10,000 results. All filters are applied locally; details are included automatically.
## `proxyConfiguration` (type: `object`):
Proxy is optional; both data sources answer without one. Enable Apify Proxy if you see rate limiting.
## Actor input object example
```json
{
"dataSource": "opportunities",
"keywords": [],
"keywordMode": "any",
"naicsCodes": [],
"pscCodes": [],
"setAsideCodes": [],
"agencies": [],
"states": [],
"postedWithinDays": 7,
"maxItems": 500,
"noticeTypes": [
"o",
"k",
"p",
"r"
],
"activeOnly": true,
"includeDetails": true,
"includeAttachments": true,
"awardTypes": "contracts",
"includeAwardDetails": false,
"onlyNew": false,
"bulkMode": false,
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
# 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 '