USAspending Scraper - Federal Contracts & Grants API

Search the official USAspending.gov API for federal contracts, grants, loans, IDVs, other assistance, and recipient summaries. Use it for GovCon market research, vendor analysis, grant prospecting, competitor-award research, and reproducible federal-spending evidence.

No API key is required. The default run returns five source-linked cybersecurity contract records for at most $0.0101 at current pricing.

What each award result contains

• award ID, type, and USAspending award-type group;
• recipient name and UEI;
• reported award amount and total outlays;
• description, start/end dates, and last-modified date;
• awarding and funding agency/subagency;
• place-of-performance city, state, postal code, and country when reported;
• NAICS, PSC, or CFDA evidence when applicable;
• exact query scope, retrieval timestamp, official API endpoint, and direct award URL;
• USAspending source messages and mandatory coverage/interpretation notes.

Every valid run returns searchOutcome as FOUND, NO_MATCH, or SOURCE_UNAVAILABLE. Invalid inputs return an explicit INVALID_INPUT item instead of silently changing the buyer's query.

Input

Field	Type	Meaning
searchType	string	awards (default) or recipients
keywords	string[]	Terms matched by USAspending's award search
awardTypes	string[]	contracts, grants, loans, idvs, other; empty defaults to contracts
dateFrom, dateTo	string	USAspending award/action time-period filter, YYYY-MM-DD; earliest searchable start is 2007-10-01
agencies	string[]	Exact top-tier awarding agency names
recipients	string[]	Recipient names or UEIs for award search; the first value is used by recipient-summary search
states	string[]	Two-letter place-of-performance state/territory codes
naicsCodes	string[]	Required NAICS codes
maxResults	integer	Total response cap, 1-10,000; default 5

USAspending rejects award-type codes from different groups in one request. This actor queries each selected group separately, merges results by reported award amount, removes duplicates, and applies maxResults once to the combined response.

Default input

{
  "searchType": "awards",
  "keywords": ["cybersecurity"],
  "awardTypes": ["contracts"],
  "maxResults": 5
}

Recipient research

{
  "searchType": "awards",
  "recipients": ["Microsoft Corporation"],
  "awardTypes": ["contracts"],
  "maxResults": 5
}

Contracts and grants in one bounded result set

{
  "searchType": "awards",
  "keywords": ["cybersecurity"],
  "awardTypes": ["contracts", "grants"],
  "dateFrom": "2025-01-01",
  "maxResults": 10
}

Example award output

{
  "searchOutcome": "FOUND",
  "awardId": "FA862118F6251",
  "recipientName": "LOCKHEED MARTIN CORPORATION",
  "recipientUei": "KDT2YLB34NT6",
  "awardAmount": 653187539.71,
  "totalOutlays": 242708.65,
  "awardType": "DELIVERY ORDER",
  "awardTypeGroup": "contracts",
  "awardingAgency": "Department of Defense",
  "placeOfPerformanceState": "FL",
  "naics": "336413 - OTHER AIRCRAFT PARTS AND AUXILIARY EQUIPMENT MANUFACTURING",
  "resultRank": 1,
  "returnedResultCount": 5,
  "requestedMaxResults": 5,
  "sourceAwardUrl": "https://www.usaspending.gov/award/CONT_AWD_FA862118F6251_9700_FA862115D6276_9700/latest",
  "retrievedAt": "2026-07-26T09:02:42Z"
}

Source records change, so the exact ranking and values can change after this example.

Evidence limits

USAspending data is reported by federal agencies and can lag, be revised, contain blanks, or differ across award and transaction records. This actor performs a bounded search, not a complete bulk download.

A record is not:

• a solicitation or proof an opportunity is open;
• proof an award is final or all reported money was paid;
• proof performance is current, complete, or successful;
• a recipient responsibility, compliance, eligibility, or identity determination;
• evidence that similar spending will recur or that a buyer has current purchase intent.

Review the linked official record and relevant transactions, modifications, solicitations, exclusions, and agency materials before making a decision. The time-period filter is USAspending's award/action search filter; it is not the returned award startDate or endDate field.

Reliability and scale

• bounded retries cover transport errors, body-read failures, malformed JSON, HTTP 408/429, and 5xx responses;
• maxResults is enforced after multi-group merging;
• Apify's maximum-charge budget can reduce output before source requests;
• dataset writes are batched in groups of 100;
• no-match and temporary source failures remain explicit rather than looking like successful evidence of absence.

For data before 2007-10-01 or complete award/transaction exports, use USAspending's official custom download or bulk-download endpoints.

Pricing

Current Apify pricing is $0.0001 per start event per GB plus $0.002 per dataset item. The five-item default costs at most $0.0101 at the default memory setting. A no-match, invalid-input, or source-unavailable evidence item is one paid dataset item when the charge budget permits it.