USAspending.gov Awards Scraper

Scrape U.S. federal award records — contracts, grants, loans and other financial assistance — from the official USAspending.gov API (https://api.usaspending.gov/api/v2/search/spending_by_award), the U.S. Treasury's public system of record for federal spending. No API key, no login. One clean dataset record per award, with a unified set of normalized columns plus the complete raw award object so nothing is lost.

What it does

Pick an award category (awardGroup) — USAspending requires every award type in a single query to belong to one category — then filter it any way you like (the API ANDs the filters together):

Input	API filter	Example
awardGroup	award category	contracts, grants, loans
keywords	free-text over the whole award	cybersecurity, cloud
recipientSearch	recipient (company/org) name	Lockheed Martin
awardingAgency	awarding top-tier agency	Department of Defense
naicsCodes	NAICS industry code(s)	541519
pscCodes	PSC product/service code(s)	D319
awardTypeCodes	specific type codes within the category	D (definitive contracts)
startDate / endDate	award action-date window	2020-01-01 → 2023-12-31
minAmount / maxAmount	award-amount range (USD)	1000000 → …
sort / order	result ordering	amount / desc

maxResults caps how many awards you get; the actor paginates automatically (up to 100 per request) until it reaches the cap or the result set is exhausted.

Award categories

• contracts — BPA calls, purchase orders, delivery orders, definitive contracts
• idvs — indefinite-delivery vehicles (GWAC, IDC, FSS schedules, BOA, BPA)
• grants — block / formula / project grants + cooperative agreements
• loans — direct & guaranteed/insured loans
• other_financial_assistance — direct payments for specified / unrestricted use
• direct_payments — insurance, other financial assistance, etc.

Output

One dataset record per award. The source columns differ by category (contracts carry NAICS/PSC + a contract award type; assistance awards carry a CFDA program

• an assistance award type; loans carry a loan value / subsidy cost instead of an obligated amount) — so every record is flattened onto one unified schema:

awardId, awardGroup, awardType, recipientName, recipientUei, recipientId, awardAmount, totalOutlays, loanValue, subsidyCost, awardingAgency, awardingSubAgency, fundingAgency, fundingSubAgency, periodOfPerformanceStart, periodOfPerformanceEnd, lastModifiedDate, baseObligationDate, description, naicsCode, naicsDescription, pscCode, pscDescription, cfdaNumber, cfdaProgramTitle, assistanceListings, recipientLocation (city / state / country), placeOfPerformance (city / state / country), defCodes, covid19Obligations, covid19Outlays, infrastructureObligations, infrastructureOutlays, awardUrl, generatedInternalId

…plus raw — the complete, untouched award object from the API — so any field not surfaced above is still available.

Example input

{
  "awardGroup": "contracts",
  "keywords": ["cloud"],
  "awardingAgency": "Department of Defense",
  "startDate": "2020-01-01",
  "minAmount": 1000000,
  "sort": "amount",
  "order": "desc",
  "maxResults": 200
}

A query that matches nothing returns 0 records and succeeds (never an error).

Notes & limits

• USAspending's searchable award history starts at 2007-10-01. For older data (back to 2000-10-01) use USAspending's bulk-download endpoints.
• Deep paging is capped at roughly 10,000 records per query — refine your filters (agency, date window, amount) to reach the rest.
• NAICS/PSC codes are only populated on contract-type awards; CFDA program info only on assistance awards. Non-applicable columns come back null.

Pricing

Pay-per-event: charged per award returned.

Source

Data comes from the U.S. Department of the Treasury's USAspending.gov API (https://api.usaspending.gov/docs/endpoints). USAspending.gov data is in the public domain. This actor is an independent tool and is not affiliated with or endorsed by the U.S. Treasury or any federal agency.