USASpending Federal Awards Normalizer

Search US federal contracts, grants, and loans from USASpending.gov with enriched, normalized data — recipient name deduplication, UEI entity resolution, industry classification, agency mapping, and amount tiering. Built on the official USASpending.gov REST API — no API key required.

What This Actor Does

• Fetches federal awards (contracts, grants, loans, IDVs) from USASpending.gov
• Normalizes recipient names — strips legal suffixes (INC, LLC, CORP), title-cases, cleans whitespace
• Resolves entities by UEI — the unique government entity identifier, so every spelling variant of a company is grouped together
• Aggregates spending by recipient — instantly see who's winning the most contracts and their total value
• Classifies industries — maps NAICS codes to 21 broad sectors (Manufacturing, IT, Construction, etc.)
• Classifies award types — contract, IDV, grant, loan, or direct payment
• Maps and shortens agencies — "Department of Defense" → "DoD", with canonical names
• Tiers award amounts — Micro (<$100K) through Mega ($100M+)
• Normalizes locations — US state codes → full names, country codes → full names

Input Parameters

Parameter	Type	Required	Default	Description
searchQuery	string	No	(empty)	Keyword to search awards (product, service, description)
recipientName	string	No	(empty)	Search by recipient/vendor company name
agencyName	string	No	(empty)	Filter by top-tier awarding agency
naicsCode	string	No	(empty)	Filter by NAICS industry code
awardType	select	No	contracts	contracts / idvs / grants / loans / direct_payments / all
dateFrom	string	No	(empty)	Award start date from (YYYY-MM-DD)
dateTo	string	No	(empty)	Award end date to (YYYY-MM-DD)
minAmount	number	No	(empty)	Minimum award amount (USD)
maxResults	integer	No	50	Maximum awards to return (1–500)

Example Input

{
  "searchQuery": "cybersecurity",
  "awardType": "contracts",
  "dateFrom": "2025-10-01",
  "minAmount": 1000000,
  "maxResults": 25
}

Example Output (Dataset Item)

{
  "awardId": "W91ZLK26FA022",
  "recipientName": "STERLING COMPUTERS CORPORATION",
  "recipientNameNormalized": "Sterling Computers",
  "recipientUei": "YZTLALWM4UC7",
  "awardType": "contract",
  "awardAmount": 181800.0,
  "amountTier": "Small ($100K–$1M)",
  "awardingAgency": "Department of Defense",
  "awardingAgencyShort": "DoD",
  "awardingSubAgency": "Department of the Army",
  "fundingAgency": "Department of Defense",
  "naicsCode": "334111",
  "naicsDescription": "Electronic Computer Manufacturing",
  "industrySector": "Manufacturing",
  "pscCode": "7B22",
  "pscDescription": "IT and Telecom - Compute: Servers (Hardware and Perpetual License Software)",
  "placeOfPerformanceState": "Maryland",
  "placeOfPerformanceStateCode": "MD",
  "placeOfPerformanceCountry": "United States",
  "startDate": "2026-03-16",
  "endDate": "2026-06-01",
  "usaspendingUrl": "https://www.usaspending.gov/award/CONT_AWD_W91ZLK26FA022_9700_..."
}

Use Cases

• Government contractors — competitive intelligence: who's winning contracts in your space, at what value
• Sales & business development — identify prime contractors and teaming partners by agency and NAICS
• Market research — size federal demand for a product or service category
• Journalists & watchdogs — track federal spending and recipient concentration
• Consultants — build opportunity pipelines with normalized, joinable data
• Supply chain — find subcontracting opportunities through prime award analysis

Normalization & Enrichment

Feature	Description
Recipient Name Dedup	Strips legal suffixes (INC, LLC, CORP, LTD), normalizes case
UEI Entity Resolution	Groups all awards by the unique government entity identifier
Spend Aggregation	Total award count + value per recipient, ranked
Industry Classification	NAICS 2-digit → 21 standard industry sectors
Award Type Classification	contract / IDV / grant / loan / direct payment
Agency Mapping	Canonical agency names + short codes (DoD, NASA, GSA…)
Amount Tiering	Micro → Mega buckets for quick filtering
Location Normalization	State & country codes → full names

Data Source

USASpending.gov — the official open data source for US federal spending, mandated by the DATA Act. Public domain government data. Free REST API, no key required. Updated daily.

Pricing

Pay-per-result pricing — you only pay when the actor returns data. See store page for current rates.

Output Structure

• Dataset: Full normalized award records (JSON)
• OUTPUT (KVS): Human-readable summary table with top recipients by value
• TOP_RECIPIENTS (KVS): Entity-resolved recipients ranked by total award value
• STATS (KVS): Aggregate statistics for dashboards