USAspending Awards Scraper

Search and export normalized U.S. federal prime-award records from the official, public USAspending data interface. This Actor is designed for procurement research, grant discovery, recipient analysis, agency monitoring, market intelligence, and agent workflows that need stable JSON instead of category-specific API fields.

The Actor supports contracts, grants, loans, direct payments, other financial assistance, and indefinite delivery vehicles (IDVs). It does not scrape subawards, transaction histories, attachments, or bulk files.

What it extracts

Field	Meaning
awardId, generatedAwardId	Public award ID and USAspending's stable generated ID
awardCategory, awardType	Normalized category and source award type
recipientName, recipientUei	Prime recipient name and UEI
awardAmount	Award Amount, or Loan Value for loans
loanValue, subsidyCost, totalOutlays	Category-specific financial values
awardingAgency, fundingAgency	Top-tier and sub-tier agency names
description, dates	Award purpose, start/issued date, end date, and last update
naicsCode, pscCode	Contract and IDV classification codes
assistanceListings	Assistance Listing/CFDA programs when supplied
locations	Recipient and primary place-of-performance geography
sourceUrl, retrievedAt	Public award page and retrieval provenance

Every dataset item uses the same schema. Fields that do not apply to a category are explicitly null or an empty array, which makes multi-category exports safe to ingest into databases and AI tools.

When to use it

Use this Actor to find awards by action-date period, recipient, exact top-tier agency name, U.S. state or territory, description keywords, known award IDs, or dollar range. It is especially useful when you need a bounded, normalized result set from several award categories.

Do not use it for pre-2007 award searches, subawards, individual transactions, federal account rollups, or a full warehouse export. USAspending recommends its download and bulk-download endpoints for older or very large extracts.

Input

The default run queries 2025 contract awards, orders them by amount, and returns at most 100 records. The Console prefill adds grants and lowers the result cap to 25 for a fast first run.

{
  "startDate": "2025-01-01",
  "endDate": "2025-12-31",
  "awardCategories": ["contracts", "grants"],
  "recipientSearchText": "Boeing",
  "placeOfPerformanceStates": ["CA", "WA"],
  "minAwardAmount": 1000000,
  "sortBy": "amount",
  "sortOrder": "desc",
  "maxResults": 100,
  "pageSize": 100
}

Agency filters use exact top-tier agency names such as Department of Defense, not abbreviations or codes. State filters use two-letter U.S. state or territory codes. All supplied filter groups are combined by USAspending; values inside a list follow USAspending's documented list semantics.

For multiple award categories, the Actor queries each category through its compatible field set, normalizes the records, then applies one combined sort and result cap. Loans use Loan Value as the normalized awardAmount.

Output example

{
  "awardId": "HT940216C0001",
  "generatedAwardId": "CONT_AWD_HT940216C0001_9700_-NONE-_-NONE-",
  "internalId": 307885715,
  "awardCategory": "contracts",
  "awardType": "DEFINITIVE CONTRACT",
  "recipientName": "HUMANA GOVERNMENT BUSINESS INC",
  "recipientUei": "ZE6ZM6NKSV43",
  "recipientId": "1068e466-707d-6b6f-367f-0255fab79b8c-C",
  "awardAmount": 51269205263.03,
  "loanValue": null,
  "subsidyCost": null,
  "totalOutlays": 0,
  "awardingAgency": "Department of Defense",
  "awardingSubAgency": "Defense Health Agency",
  "fundingAgency": "Department of Defense",
  "fundingSubAgency": "Defense Health Agency",
  "description": "IGF::OT::IGF",
  "startDate": "2016-08-01",
  "endDate": "2025-12-31",
  "lastModifiedDate": "2026-02-10 17:52:09",
  "naicsCode": "524114",
  "naicsDescription": "DIRECT HEALTH AND MEDICAL INSURANCE CARRIERS",
  "pscCode": "Q201",
  "pscDescription": "MEDICAL- MANAGED HEALTHCARE",
  "assistanceListings": [],
  "recipientLocation": { "countryCode": "USA", "stateCode": "KY", "cityName": "LOUISVILLE", "postalCode": "40202" },
  "placeOfPerformance": { "countryCode": "USA", "stateCode": "KY", "cityName": "LOUISVILLE", "postalCode": "40201" },
  "sourceUrl": "https://www.usaspending.gov/award/CONT_AWD_HT940216C0001_9700_-NONE-_-NONE-/",
  "retrievedAt": "2026-08-28T12:00:00.000Z"
}

The OUTPUT key-value-store record classifies the run as DATA, EMPTY, REJECTED, PARTIAL, or FAILED and reports category coverage, pages fetched, result counts, charged events, warnings, and whether the charge limit stopped output.

Pricing

This Actor uses pay per event.

Event	Price	Charged when
Actor start	$0.00005	A run starts; handled automatically by Apify
USAspending award result	$0.001	One normalized award is delivered to the default dataset

Examples: 25 delivered records cost $0.02505; 100 cost $0.10005. Empty and rejected runs have no result-event charge. The Actor checks the SDK charge result after each delivered record and stops when the run's charge limit is reached.

Reliability and limits

Data comes from USAspending's public endpoint, which currently requires no API key. Requests have a 30-second timeout and three bounded attempts with exponential backoff. Pagination uses the official response cursor, results are deduplicated by generated award ID, and partial valid data is preserved if one selected category fails.

maxResults is capped at 5,000 and the upstream page size at 100. A multi-category run may fetch up to maxResults candidates per category so the combined amount/date/ID sort remains correct. Narrow filters are faster and friendlier to the public service.

The action-date filter identifies awards with activity during the period; an award's original start date can therefore be earlier. USAspending may revise records after retrieval, and some fields are absent for some award categories.

Responsible use and support

USAspending publishes official U.S. federal spending data. Follow applicable laws, USAspending terms, and your organization's data-governance rules. Recipient addresses may be public business or government records; avoid repurposing data for harassment, discrimination, or unrelated personal profiling.

For a reproducible bug report, include the redacted Actor input, run ID, affected award category, expected result, and observed OUTPUT warning. Do not include private credentials or unrelated personal data.