USAspending Scraper - US Federal Contract, Grant & Loan Awards

Search and export US federal awards from USAspending.gov, the official public record of federal spending, as clean, normalized JSON, CSV or Excel. Get contract awards, IDVs (GWAC, IDC, FSS schedules), grants, loans and other assistance and filter by keyword, awarding agency, recipient name or UEI, NAICS, PSC, state of performance, amount and date. Results come newest first. No API key, no proxy, no browser and no login needed.

The Actor calls the official, documented USAspending open API. Each result follows the same tender schema v1 used by the other Actors of this procurement family (EU TED, UK Find a Tender / Contracts Finder), with the winner in awardInfo, so US awards and European tenders can be loaded into one table.

Who is it for

• Government contractors and subcontractors looking for who just won which federal contract (competitor and teaming-partner intelligence), by NAICS, PSC, agency or state.
• Business development and sales teams selling to the federal government: find the buyers, offices and contract vehicles that purchase what you sell, and recipients with fresh awards.
• Analysts, journalists and researchers following federal spending, grants and loans by agency, recipient, program or place.
• AI agents and MCP users: the dataset schema describes every field, so an agent can ask in plain language (see API, MCP and AI agents).

What you get

One dataset item per award, with:

• award id (PIID or FAIN), USAspending id, award type (contract: BPA call, purchase order, delivery order, definitive contract; grants, loans, IDVs), description and the link to the USAspending award page
• recipient (winner) name, UEI and location, awarded amount in USD, signing date and period of performance
• awarding agency and sub-agency (with codes), funding agency
• NAICS and PSC codes with descriptions (contracts and IDVs), Assistance Listing programs (grants and loans), place of performance (state, city, county, ZIP)
• optional award details (includeDetails): extent of competition, solicitation procedures, set-aside, pricing type, number of offers, potential total value with options, parent contract, awarding office, recipient business categories

Street addresses and executive officer names or compensation are not copied. The full field reference is in ./SCHEMA.md and in the Actor's dataset schema.

Input

All filters are optional and combined with AND. The defaults return the 20 most recently updated contract awards of the last 7 days in a few seconds.

Field	Description
awardCategory	contracts (default), idvs, grants, direct-payments, other-assistance, loans. The API cannot mix categories, so a run reads one
awardTypeCodes	Optional subset of the category, e.g. ["C","D"] (delivery orders and definitive contracts)
keyword	Words or phrases; comma-separated alternatives match any (solar, photovoltaic)
daysBack	Active in the last N days (default 7, 0 = no limit)
dateFrom / dateTo	Explicit period YYYY-MM-DD (earliest supported date 2007-10-01), overrides daysBack
dateType	action_date (default: any new award or modification in the period), new_awards_only, date_signed, last_modified_date
awardingAgency / awardingSubAgency	Exact agency names, e.g. Department of Homeland Security / U.S. Coast Guard
recipient	Recipient name or 12-character UEI
naicsCodes / pscCodes	NAICS (prefix match, 5415) and PSC (D302) codes, contracts and IDVs
placeOfPerformanceStates	Two-letter state / territory codes
minAmount / maxAmount	Amount range in USD
sortBy	lastModified (default, newest update first), baseDate (newest signed first), amount (largest first)
includeDetails	Add the award detail block (usaDetails), one extra request per award, about 0.6 s each
maxItems	Maximum results (default 20, maximum 50,000)

Example: new IT-services contracts in Virginia and Texas above 100,000 USD

{
  "naicsCodes": ["5415"],
  "placeOfPerformanceStates": ["VA", "TX"],
  "minAmount": 100000,
  "dateType": "new_awards_only",
  "daysBack": 30,
  "maxItems": 200
}

Example: what has a competitor won recently

{ "recipient": "Booz Allen Hamilton", "daysBack": 90, "maxItems": 100, "includeDetails": true }

Example: cybersecurity awards at the Department of Homeland Security

{ "keyword": "cybersecurity, zero trust", "awardingAgency": "Department of Homeland Security", "daysBack": 60, "maxItems": 100 }

Example: grants from one agency

{ "awardCategory": "grants", "awardingAgency": "National Science Foundation", "daysBack": 120, "maxItems": 100 }

Output example

Real record (delivery order updated on 3 November 2026), abridged:

{
  "schemaVersion": "1.0",
  "source": "usaspending",
  "sourceId": "CONT_AWD_47QSSC27F0RQS_4732_47QSWA22D0009_4732",
  "url": "https://www.usaspending.gov/award/CONT_AWD_47QSSC27F0RQS_4732_47QSWA22D0009_4732",
  "noticeType": "contract-award",
  "noticeTypeCode": "C",
  "contractNature": "supplies",
  "title": "TOWEL,MACHINERY WIP",
  "buyer": { "name": "General Services Administration", "country": "US", "city": null, "nutsCode": null, "buyerType": "central-government" },
  "cpvCodes": [],
  "publicationDate": "2026-11-03",
  "awardInfo": {
    "winners": [{ "name": "NATIONAL INDUSTRIES FOR THE BLIND", "country": "US" }],
    "awardedValue": { "amount": 208.44, "currency": "USD" },
    "awardDate": "2026-11-01"
  },
  "placeOfPerformance": { "country": "US", "city": "ALEXANDRIA", "nutsCode": null },
  "usaAwardId": "47QSSC27F0RQS",
  "usaAwardingSubAgency": "Federal Acquisition Service",
  "usaRecipientUei": "E8QNBC287DY4",
  "usaNaics": { "code": "423850", "description": "SERVICE ESTABLISHMENT EQUIPMENT AND SUPPLIES MERCHANT WHOLESALERS" },
  "usaPsc": { "code": "7910", "description": "FLOOR POLISHERS AND VACUUM CLEANING EQUIPMENT" },
  "usaPlaceOfPerformance": { "country": "US", "state": "VA", "city": "ALEXANDRIA", "county": "ALEXANDRIA CITY", "zip5": "22305" },
  "usaPeriodOfPerformance": { "startDate": "2026-11-01", "endDate": "2026-11-08", "lastDateToOrder": null },
  "usaLastModified": "2026-11-03 00:04:25"
}

Fields starting with usa are USAspending-specific extras; all other fields are shared with the other procurement Actors (cpvCodes is always empty here: US awards use NAICS and PSC).

Use cases

• Competitor tracking: every new award and modification of a given recipient, with agency, amount and period.
• Lead generation: companies that just won federal contracts (subcontracting, teaming, financing, insurance, recruiting offers).
• Market sizing: spending by agency, NAICS, PSC or state over a period.
• Recompete and renewal planning: period of performance end dates and potential end date with options (includeDetails).
• Grant and loan research: recipients, programs (Assistance Listings) and amounts.
• AI agents (MCP): ask in natural language, get structured awards back.

Pricing

Pay only for the results you get. Set Maximum results (and the run's maximum cost) to control spending: the Actor stops as soon as either limit is reached. Runs that find no awards return no results and charge nothing. See the Pricing tab of this Actor for the current price.

API, MCP and AI agents

Apify API (Python)

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("nexus-scrapers/usaspending-awards").call(run_input={
    "naicsCodes": ["5415"], "daysBack": 7, "minAmount": 500000, "maxItems": 50,
})
for award in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(award["publicationDate"], award["awardInfo"]["winners"][0]["name"], award["awardInfo"]["awardedValue"]["amount"])

Apify API (JavaScript)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('nexus-scrapers/usaspending-awards').call({ keyword: 'drone', maxItems: 50 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();

MCP and AI agents. Apify exposes Actors as MCP tools through the Apify MCP server. Add https://mcp.apify.com (with ?actors=nexus-scrapers/usaspending-awards) to Claude, Cursor, VS Code or any MCP client, authorize with your Apify account, and ask for example: "Which companies won NASA contracts above 1 million dollars this month?" or "List grants awarded by the National Science Foundation in Texas in the last 90 days". The input and dataset schemas tell the agent every parameter and field.

FAQ

Do I need an API key? No. USAspending's API is open and needs no registration.

Is the data official? Yes. It comes from the Bureau of the Fiscal Service's USAspending.gov API. Every record links to the official award page.

What does "amount" mean? For contracts, IDVs and grants it is the total obligated to date on the award (Award Amount), which grows with modifications; it is not the contract ceiling. The potential value with all options is in usaDetails.potentialTotalValue (with includeDetails). For loans it is the loan value. Many IDVs show 0 because orders carry the money.

What do the date options mean? The default action_date returns awards with any action (new award or modification) in the period, ordered by the time the award record was last updated. new_awards_only returns only awards first signed in the period. publicationDate is the date of the last update; awardInfo.awardDate is the signing date of the base award.

Why are there so few Department of Defense awards in the last weeks? DoD contract awards are published with a delay. In our check on 4 November 2026 new DoD contracts appeared only up to late July 2026. Use older periods to see them.

How fresh is the data? USAspending is updated daily; the Actor queries it live.

Can I get more than 10,000 results? Yes, up to 50,000 per run. The API stops paging at 10,000 results per query, so for larger requests the Actor first counts matches and splits the date range into windows that fit, reading newest first. If a single day alone has more than 10,000 matches (for example the end of the fiscal year), it keeps paging beyond the documented limit, which works in practice but is not guaranteed; the run status says when this happened. You can also split by date range or add filters yourself.

Can I mix contracts and grants in one run? No, the API does not allow it. Run once per awardCategory.

What is the difference between PIID, FAIN and UEI? PIID is the contract number, FAIN the grant number, UEI the 12-character Unique Entity ID of the recipient (it replaced the DUNS number in 2022).

Does it include subawards? No. Only prime awards.

Does it include personal data? Only what USAspending publishes about organisations. Street addresses and officer names or pay are left out. USAspending redacts individual recipients of assistance itself.

Data source, licence and terms

Data come from USAspending.gov and its open API, run by the US Department of the Treasury (Bureau of the Fiscal Service) under the DATA Act. Federal government data published for public use; USAspending's source code is released under CC0. USAspending asks for no key and publishes no fixed rate limit, and the Actor is a polite client (descriptive User-Agent, request pacing, back-off on 429/5xx). The Actor is an independent tool and is not affiliated with or endorsed by the US Government. Check USAspending's data sources and notes for caveats about data quality and delays.

Limitations

• Prime awards only; subawards are not included.
• The API cannot mix award categories in one search; one category per run.
• Award Amount is the amount obligated so far, not the contract ceiling.
• Agency filters need the exact agency name as in USAspending.
• The API does not return the action date of the latest transaction, so results are ordered by the last-modified time of the award record, which is the closest available measure.
• Department of Defense awards appear with a delay of about three months.
• Some assistance records have no award type text (noticeTypeCode is then null).
• includeDetails adds one request per award and is much slower (about 0.6 s per award).