What it returns
Open US federal contracting opportunities from SAM.gov, the official system for federal bids, in clean JSON. Refreshed daily.
Notice ID, title, solicitation number, notice type (solicitation, sources sought, presolicitation, award, special notice), posted date, **response deadline**, agency / sub-tier / office, NAICS and PSC codes, **set-aside** (small business, 8(a), HUBZone, SDVOSB, WOSB), place of performance, **award number, date, amount and awardee**, primary and secondary contracting officer contacts, the SAM.gov link and the full description.
Common uses
Daily bid feeds for your NAICS codes and states. Small-business set-aside alerts. Competitive intelligence from award notices: who won, for how much. Contracting-officer contact lists by agency.
Request
POST https://api.pushbuild.com/sam-gov-opportunities/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
keywords | string | All words must appear in the title (or description, if enabled below). |
searchDescription | boolean | Match keywords against the full description as well as the title. Default: false. |
naicsCodes | list of strings | Prefix match, e.g. 5415 or 541512. |
pscCodes | list of strings | Product/service code prefix, e.g. D3 or R4. |
agencies | list of strings | Text matched against department, sub-tier and office, e.g. army, veterans affairs. |
states | list of strings | Two-letter codes, e.g. VA, TX. |
setAsideCodes | list of strings | SBA, SBP, 8A, 8AN, HZC, SDVOSBC, WOSB, EDWOSB, NONE. |
noticeTypes | list of strings | e.g. Solicitation, Combined Synopsis/Solicitation, Sources Sought, Presolicitation, Award Notice, Special Notice. |
postedFrom | string | YYYY-MM-DD. Defaults to the last 7 days when no other filter is set. |
postedTo | string | YYYY-MM-DD. |
respondByFrom | string | YYYY-MM-DD; use today to keep only biddable notices. |
noticeIds | list of strings | Look up specific notices. |
awardsOnly | boolean | Only notices carrying an award (awardee, amount, date). Default: false. |
activeOnly | boolean | Skip archived notices. Default: true. |
includeDescription | boolean | Full notice text. Default: true. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/sam-gov-opportunities/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"keywords": "software", "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.24 per 1,000 opportunitys. No charge for errors or empty searches.
Related APIs
Bank of England API: Bank Rate, SONIA, Gilts & Mortgages API
Bank of England statistics from its official database: Bank Rate, SONIA, gilt yields, implied inflation, mortgage rates and approvals, M4 money, lending and sterling FX.
BLS Data API: Any Bureau of Labor Statistics Series API
Any US Bureau of Labor Statistics time series by id (CPI, payrolls by industry, unemployment, wages, PPI, JOLTS, import prices) plus state unemployment and labor force from plain state codes, with month-over-month and year-over-year changes..
Cboe Put/Call Ratios & VIX Futures Term Structure API
Daily Cboe options statistics: total, equity, index, SPX and VIX put/call ratios with call and put volume and open interest by product, plus the VIX futures curve with settlements, open interest and contango versus spot VIX..
CFPB Consumer Complaints: Banks, Lenders, Fintech API
Search 18 million+ official CFPB consumer complaints against banks, lenders, card issuers, debt collectors, credit bureaus and fintechs.
CFTC Commitments of Traders (COT) Reports API
Weekly CFTC Commitments of Traders positioning for every futures market: legacy, disaggregated (managed money, producers, swap dealers) and financial (leveraged funds, asset managers).
ClinicalTrials.gov API
Search 500,000+ clinical studies from ClinicalTrials.gov by condition, drug, sponsor, location, phase and status.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com