🏛️ Federal Contract Awards: USAspending, Expiring Contracts

Search U.S. federal contract awards from USAspending.gov by keyword, NAICS code, contractor or agency, and get clean rows with the contractor, their address, the amount, the agency, NAICS and PSC codes, start and end dates, and how many days are left. Find the contracts ending soon, the ones most likely to be recompeted.

• ✅ No API key needed: uses the official USAspending.gov API
• ✅ "Ending soon" mode: running contracts that end within the next N days, soonest first
• ✅ Contractor address (city, state, ZIP) on every row
• ✅ NAICS and PSC codes with descriptions, awarding and funding agency
• ✅ Scope tags from the description: cybersecurity, AI/ML, cloud/DevSecOps, data, software, help desk
• ✅ Optional SAM.gov enrichment: CAGE code, website, registration status and business types

What does it do?

1. Searches USAspending.gov for contract awards (definitive contracts, purchase orders, delivery orders and BPA calls) that match your keywords, NAICS codes, contractors and agencies, with activity in your date range.
2. Works out whether each contract is still running and how many days are left.
3. In ending soon mode, reads contracts in end-date order and keeps the running ones that end within your window.
4. Optionally looks up each contractor in SAM.gov with your own free API key.

Use cases

• 🎯 Capture and business development. Find contracts in your NAICS codes that end in the next six months, and who holds them.
• 🤝 Teaming and subcontracting. Find the primes winning work in your niche, with their addresses.
• 📈 Market research. Who wins what, from which agencies, for how much.
• 💼 B2B sales to government contractors. A list of active federal contractors in a field, by state.
• 🤖 AI agents. "Which zero-trust contracts at DHS end before June?"

What data can you get?

Field	What it is
awardId, contractType, awardUrl	The award ID (PIID), type (e.g. DELIVERY ORDER) and its USAspending page
recipientName, recipientUei	The contractor and its Unique Entity ID
recipientAddress, recipientCity, recipientState, recipientZip, recipientCountry	Where the contractor is registered
awardAmount, totalOutlays	Total obligated amount and outlays so far (USD)
awardingAgency, awardingSubAgency, fundingAgency	Who awarded and who pays
naicsCode, naicsDescription, pscCode, pscDescription	Industry and product/service codes
placeOfPerformanceCity, placeOfPerformanceState, placeOfPerformanceCountry	Where the work is done
startDate, endDate, daysUntilEnd, contractStatus	Period of performance, days left, and active or ended
description, scopeTags	The award description and the scope tags found in it
lastModified	When USAspending last updated the award
cageCode, vendorWebsite, samRegistrationStatus, samRegistrationExpires, businessTypes	From SAM.gov, only when you give a SAM.gov API key

How to use it

1. Click Try for free (or Start) at the top of this page.
2. Enter Keywords, NAICS codes, Contractor names or Awarding agencies. At least one is needed.
3. Choose Contracts to include: everything, only running contracts, or only those ending soon.
4. Optionally set a Minimum award amount and the Activity date range.
5. Press Start, then download the results from the Output tab as Excel, CSV or JSON.

Input examples

Cybersecurity contracts in IT services NAICS codes ending in the next 6 months.

{
  "keywords": ["cybersecurity"],
  "naicsCodes": ["541512", "541519"],
  "minAwardAmount": 1000000,
  "contractStatus": "ending",
  "endingWithinDays": 180
}

Everything a competitor is running at one agency.

{
  "vendorNames": ["Leidos"],
  "awardingAgencies": ["Department of Homeland Security"],
  "contractStatus": "active"
}

A whole NAICS family, by keyword, over two years.

{
  "naicsCodes": ["5415"],
  "keywords": ["help desk"],
  "startDate": "2024-10-01",
  "maxResults": 1000
}

Output example

{
  "awardId": "FA822226FB007",
  "recipientName": "CYKOR LLC",
  "recipientUei": "...",
  "recipientCity": "ANNAPOLIS",
  "recipientState": "MD",
  "awardAmount": 6884161.01,
  "awardingAgency": "Department of Defense",
  "naicsCode": "541519",
  "pscCode": "7B20",
  "startDate": "...",
  "endDate": "2026-12-18",
  "daysUntilEnd": 64,
  "contractStatus": "active",
  "scopeTags": ["Cybersecurity"],
  "awardUrl": "https://www.usaspending.gov/award/CONT_AWD_..."
}

Statuses and errors

Situation	What happens	Charged?
Matching contract	Saved as one row	Yes
Contract filtered out by Contracts to include	Read but not saved	No
No search terms given	Run stops: "Add at least one keyword, NAICS code, vendor name or agency"	No
Keyword shorter than 3 characters, or a NAICS code that is not 2 to 6 digits	Run stops and names the bad value	No
USAspending is unavailable	Retried, then the run stops with USAspending's message	No
SAM.gov key rejected or daily limit reached	A warning in the log; the remaining contracts are saved without SAM.gov data	Only the contracts
More than 6,000 awards read without filling the request	The run stops and says so; narrow the search	Only what was saved

How much does it cost?

You pay per contract saved. Contracts that are read and filtered out are free. Platform usage is included.

Contracts	Price on the Free and Bronze tiers
100	$0.30
1,000	$3.00
10,000	$30.00

FAQ

Where does the data come from?

USAspending.gov, the official source for U.S. federal spending, run by the Department of the Treasury. Award data there comes from FPDS and agency reporting, usually within days of an action. Contract ceilings and option periods are not part of this search; endDate is the current end of the period of performance.

Does "ending soon" mean it will be recompeted?

Not always. Options can be exercised, contracts can be extended, and some work is not re-solicited. A contract ending soon is a lead to research, not a guarantee.

Do I need a SAM.gov API key?

No. Everything except the SAM.gov fields works without one. To add CAGE codes, websites and business types, request a free public API key in your SAM.gov account settings. Personal keys allow a limited number of lookups a day, so the Actor caches each contractor and stops asking once the limit is reached.

Can I use it through the API or from an AI agent?

Yes. Call it like any Apify Actor:

curl -X POST "https://api.apify.com/v2/acts/optimistical_lectern~federal-contract-vendor-enricher/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["zero trust"], "contractStatus": "ending", "endingWithinDays": 180}'

From Python: ApifyClient("YOUR_APIFY_TOKEN").actor("optimistical_lectern/federal-contract-vendor-enricher").call(run_input={...}). AI agents can use it through Apify's MCP server at mcp.apify.com. It runs with limited permissions, so it needs no approval step.

Can I run it every week?

Yes. Create a schedule in Apify Console and send new results to Google Sheets, Slack or a webhook with an integration.

Something looks wrong?

Open an issue on the Issues tab with your input. Every report is read.