USAspending Scraper

Every US federal contract, grant, loan and direct payment on USAspending.gov — searchable by keyword, agency, recipient, state and date — as clean JSON.

USAspending.gov is the official source of US federal spending data: every contract, contract vehicle, grant, loan and direct payment the government awards, with who received it, which agency paid, how much, and where the work happens. This Actor scrapes USAspending awards by keyword, award type, awarding agency, recipient, place of performance and date, or straight from USAspending award and recipient pages. Each award comes back with its award ID, amount obligated and outlays (or face value and subsidy cost for loans), recipient name, UEI and location, awarding and funding agency and sub-agency, start and end dates, place of performance, NAICS and PSC codes for contracts, assistance listings (CFDA) for grants, and disaster-funding codes. Optionally add the full award record: competition and pricing, options value, subawards, parent contract, offices and the funding opportunity. Scrape federal spending data with no API key, no login and no proxy. Built for government-contracting business development, competitive intelligence, grant research, journalists and watchdogs, and anyone tracking where public money goes.

⚡ Quick start

{
  "startUrls": [
    {
      "url": "https://www.usaspending.gov/recipient/ea75ddee-2d00-ac7f-5e72-6f42d7c88c8c-C/latest"
    }
  ],
  "searchTerms": ["cybersecurity"],
  "maxItems": 5
}

🧩 Input

Field	Type	Required	Default	Description
startUrls	array	no	—	USAspending pages: an award page (https://www.usaspending.gov/award/CONT_AWD_…) or a recipient page (https://www.usaspending.gov/recipient/<id>/latest), which returns that recipient's awards. A recipient page for one fiscal year (…/2025) keeps to that year.
searchTerms	array	no	—	Keywords to find in award descriptions, recipients and programs, one search per line, at least 3 characters each, such as cybersecurity or broadband.
awardTypes	array	no	—	Only return these kinds of award: contracts, idvs (contract vehicles), grants, loans, directPayments or other. Leave empty for every kind.
agencies	array	no	—	Only return awards made by these agencies, by name or abbreviation, such as Department of Defense, DOD, NASA or HHS.
recipients	array	no	—	Only return awards to these recipients, by name, UEI or DUNS number. A parent company's UEI also matches its subsidiaries.
states	array	no	—	Only return awards performed in these US states or territories, as two-letter codes such as CA, TX or DC.
dateFrom	string	no	—	Only return awards with spending on or after this date (YYYY-MM-DD). Award search starts at fiscal year 2008.
dateTo	string	no	—	Only return awards with spending on or before this date (YYYY-MM-DD).
sortBy	string	no	amount	amount for the largest awards first (loans by face value), or newest for the most recently awarded first.
includeDetails	boolean	no	false	Add the full award record to every row. Adds one request per award. Award pages always include it.
maxItems	integer	no	—	Maximum number of awards per URL or search term. The input form starts at 5; leave it empty for every matching award.
proxyConfiguration	object	no	{ "useApifyProxy": false }	Proxy settings. USAspending needs no proxy.

Add award pages, recipient pages, search terms, or any mix. The filters (award types, agencies, recipients, states and dates) narrow every search term and recipient page. With no search terms and no URLs, the filters run as one search of their own: for example, NASA's largest grants in fiscal year 2025. Award types are searched one after another in the order above, each sorted by sortBy, until maxItems is reached.

USAspending's advanced-search page keeps its filters out of the address bar, so its URLs cannot be pasted here: set the same filters in the input instead.

📤 Output

Each award is one dataset row, marked by source: search for a search-term or filter match, recipient for an award found from a recipient page, award for an award page. Every row links to the award's USAspending page and the recipient's profile. Amounts are in US dollars.

Fields

Field	Type	Description
source	string	search, recipient or award.
searchQuery	string	The search term that matched the award. null for recipient and award pages and filter-only searches.
awardId	string	The award's own ID: the contract number (PIID) or the assistance award number (FAIN or URI).
generatedId	string	USAspending's unique award key, as in the award page URL.
url	string	The award's page on usaspending.gov.
awardCategory	string	contract, idv, grant, loan, direct payment or other.
awardType	string	Specific type, such as DELIVERY ORDER, DEFINITIVE CONTRACT, PROJECT GRANT (B) or DIRECT LOAN (E).
description	string	The award description.
recipientName	string	Recipient name.
recipientUei	string	Recipient's Unique Entity Identifier (SAM.gov).
recipientDuns	string	Recipient's DUNS number, on awards from before the switch to UEI.
recipientId	string	USAspending's recipient key, as in the recipient page URL.
recipientUrl	string	The recipient's profile on usaspending.gov.
awardAmount	number	Total amount obligated. null for loans.
totalOutlays	number	Total amount actually paid out so far.
loanValue	number	Face value of a loan. null for other awards.
subsidyCost	number	Estimated cost of a loan to the government. null for other awards.
awardingAgency	string	Agency that made the award, such as Department of Defense.
awardingSubAgency	string	Sub-agency that made the award, such as Department of the Air Force.
fundingAgency	string	Agency whose money pays for the award.
fundingSubAgency	string	Sub-agency whose money pays for the award.
startDate	string	Start of the period of performance (YYYY-MM-DD); a loan's issue date.
endDate	string	End of the current period of performance. null for IDVs and loans.
lastDateToOrder	string	Last date orders can be placed against an IDV. null for other awards.
baseObligationDate	string	Date the award was first obligated (signed).
lastModifiedDate	string	Date the award was last modified.
placeOfPerformance	object	Where the work happens: city, county, state, stateName, zip, country, countryName and congressionalDistrict.
recipientLocation	object	The recipient's address: address plus the same fields as placeOfPerformance.
naicsCode	string	Industry code (NAICS) of a contract.
naicsDescription	string	Industry description.
pscCode	string	Product or service code (PSC) of a contract.
pscDescription	string	Product or service description.
cfdaNumber	string	Main assistance listing (CFDA) number of a grant, loan or payment, such as 93.243.
assistanceListings	array	Every assistance listing on the award, each with number and title. Empty for contracts.
defCodes	array	Disaster emergency fund codes of the money spent on the award (COVID-19 and infrastructure laws among them).
covid19Obligations	number	Amount obligated from COVID-19 relief funds. null for award pages.
infrastructureObligations	number	Amount obligated from Infrastructure Investment and Jobs Act funds. null for award pages.
details	object	With includeDetails and on award pages: awardTypeCode, dateSigned, potentialEndDate, totalObligation, baseExercisedOptions, baseAndAllOptions, totalFunding, nonFederalFunding, subawardCount, totalSubawardAmount, awardingOffice, fundingOffice, parentAwardId and parentAwardUrl (the contract vehicle an order sits under), parentRecipientName, parentRecipientUei, businessCategories, contract competition (extentCompeted, solicitationProcedures, numberOfOffers, setAside, contractPricing), the grant's fundingOpportunityNumber and fundingOpportunityGoals (plain text), programs (each assistance listing's number, title, popularName, objectives and url) and executives (the recipient's top-paid officers, when reported). null when off.

💡 Use cases

• Government contracting business development — find the largest contracts and contract vehicles in your NAICS or PSC area, who holds them and when they end, to plan recompetes.
• Competitive intelligence — pull every award a competitor or partner has won, subsidiaries included, with agencies, amounts and competition details.
• Grant research — see which organisations win which grants from which programs, in your state or field.
• Journalism and accountability — trace where federal money goes by agency, recipient, place or keyword, including COVID-19 and infrastructure funds.
• Market sizing — total federal spending on a topic, agency or region over time.

❓ FAQ

• Do I need an API key or an account? No. USAspending is public government data.
• Do I need a proxy? No. It runs without one by default.
• How far back does it go? Searches cover fiscal year 2008 (October 2007) onwards. Award pages work for any award USAspending has.
• What does the date filter match? Awards with spending activity (an obligation or modification) inside the window, so a long-running contract signed years ago still appears when it was funded in the window.
• Why are some fields empty? Each award type publishes different data: contracts have NAICS and PSC codes, grants and loans have assistance listings, loans have a face value instead of an obligation, and recipients have a UEI or, on older awards, a DUNS number.
• Can I paste a USAspending search URL? No. The site keeps its search filters out of the address bar. Set the same filters in the input, or paste award and recipient pages.
• Why did a run return fewer awards than expected? An agency name may not be recognised (use its full name or abbreviation; the log names any it could not match), or the filters may be narrower than you think. Open an issue if something looks off.

🔗 More scrapers by Anyx

• SEC EDGAR Scraper
• Google Search Scraper
• Web Content Scraper
• Google News Scraper

🤝 Anyx Solutions

We build custom scrapers and data-extraction pipelines.

• Email: tantosthor@gmail.com

🖼 Image credit

Image credit: usaspending.gov