USAspending Subaward to Prime-Contractor Mapping Scraper

Extracts federal subaward records from USAspending.gov and maps each one to its prime contractor. Returns subawardee name and UEI, prime contractor name and UEI, awarding agency, NAICS code, PSC code, place of performance, and dollar amounts — structured JSON for the full subaward-to-prime graph.

USAspending Subaward Scraper Features

• Extracts subaward records with direct links to the prime award on USAspending.gov
• Maps subawardees to prime contractors — both name and SAM.gov UEI, so you can pivot in either direction
• Enriches from award detail — NAICS code and description, PSC code and description, prime award total obligation, and prime contractor state all come from the award detail endpoint when the search results omit them
• Filters by award type — contracts (A/B/C/D), grants (02–05), loans, direct payments, or any combination
• Filters by awarding agency — DoD, DoE, HHS, NASA, GSA, and 16 other top-tier federal agencies
• Filters by NAICS code — 2, 4, or 6-digit codes (the API is strict; 3 and 5-digit prefixes are silently skipped rather than returning HTTP 400)
• Filters by minimum dollar amount — useful when you only care about material subcontracts
• Filters by recipient UEI — track specific companies' subcontracting activity across the federal base
• No API key needed — USAspending.gov is a public government API, no auth required

What Can You Do With USAspending Subaward Data?

• Competitive intelligence analysts — map which small businesses are receiving work under specific prime contracts before those relationships show up elsewhere
• Federal BD teams — identify primes awarding subawards in your NAICS codes and reach out before the next recompete
• Teaming consultants — find small business subcontractors already working with target primes to assess teaming fit
• Grant researchers — trace which nonprofits and universities receive subawards under federal grants by agency and period
• Compliance and DCAA auditors — pull subaward activity for specific primes or recipients by contract type and date range
• Data vendors and GovTech platforms — build enriched federal contracting datasets that the standard USAspending exports don't include

How It Works

1. Configure your filters — set award type, awarding agency, NAICS code, date range, and minimum amount. Leave everything blank for all FY2025 contract and grant subawards.
2. The scraper queries the USAspending API — it calls POST /api/v2/search/spending_by_award/ with subawards: true, paginating through results 100 at a time. Award type groups are split into separate queries since the API requires codes from a single group per request.
3. Each record is enriched from the award detail endpoint — GET /api/v2/awards/<id>/ fills in NAICS, PSC, prime contractor UEI, prime contractor state, and total obligation when the search results don't include them. Results are cached per prime award to avoid redundant calls.
4. Clean JSON lands in your dataset — one record per subaward, ready to export.

USAspending Subaward Scraper Input

{
  "awardType": ["A", "B", "C", "D"],
  "awardingAgency": "Department of Defense",
  "naicsCode": "541330",
  "dateFrom": "2024-10-01",
  "dateTo": "2025-09-30",
  "minAmount": 25000,
  "maxItems": 100
}

Field	Type	Default	Description
awardType	array	all	Award type codes. Contracts: A, B, C, D. Grants: 02–05. Loans: 07, 08. Leave blank for contracts + grants.
awardingAgency	string	all	Top-tier federal awarding agency name.
naicsCode	string	—	NAICS code filter. Must be 2, 4, or 6 digits.
ueiList	array	—	SAM.gov UEIs to filter by (subaward recipient).
dateFrom	string	2024-10-01	Start date for subaward action date (YYYY-MM-DD).
dateTo	string	2025-09-30	End date for subaward action date (YYYY-MM-DD).
minAmount	integer	0	Minimum subaward dollar amount.
maxItems	integer	15	Maximum number of records to return.

USAspending Subaward Scraper Output Fields

{
  "subaward_id": "2025-ESC02395-0005",
  "prime_award_id": "W912DY-24-C-0017",
  "subaward_type": "sub-contract",
  "subawardee_name": "ACME ENVIRONMENTAL SERVICES LLC",
  "subawardee_uei": "MK3G7QQTZXP6",
  "subawardee_state": "VA",
  "prime_contractor_name": "PRIME DEFENSE CONTRACTOR INC",
  "prime_contractor_uei": "J4WB9PHQLXK7",
  "prime_contractor_state": "MD",
  "awarding_agency": "Department of Defense",
  "awarding_subagency": "Dept of the Army",
  "subaward_amount_usd": 485000,
  "prime_award_amount_usd": 12400000,
  "naics_code": "562910",
  "naics_description": "Remediation Services",
  "psc_code": "F109",
  "psc_description": "ENVIRONMENTAL PROTECTION/RESTORATION: HAZARDOUS MATERIAL CONTROL",
  "place_of_performance_state": "VA",
  "subaward_action_date": "2025-01-15",
  "description": "Environmental remediation services at Fort Belvoir",
  "source_url": "https://www.usaspending.gov/award/CONT_AWD_W912DY24C0017"
}

Field	Type	Description
subaward_id	string	Subaward number / identifier
prime_award_id	string	Prime award PIID (contracts) or FAIN (grants)
subaward_type	string	"sub-contract" or "sub-grant"
subawardee_name	string	Sub-awardee (sub-recipient) name
subawardee_uei	string	Sub-awardee SAM.gov Unique Entity Identifier
subawardee_state	string	Sub-awardee location state code
prime_contractor_name	string	Prime contractor / prime recipient name
prime_contractor_uei	string	Prime contractor SAM.gov Unique Entity Identifier
prime_contractor_state	string	Prime contractor location state code
awarding_agency	string	Federal agency that made the prime award
awarding_subagency	string	Sub-agency within the awarding agency
subaward_amount_usd	number	Subaward dollar amount
prime_award_amount_usd	number	Prime award total obligation
naics_code	string	NAICS industry code (from prime award)
naics_description	string	NAICS industry description
psc_code	string	Product/Service Code (from prime award)
psc_description	string	Product/Service Code description
place_of_performance_state	string	Place of performance state code
subaward_action_date	string	Subaward action date (YYYY-MM-DD)
description	string	Award description
source_url	string	Link to the prime award on USAspending.gov

🔍 FAQ

How do I scrape subaward data from USAspending.gov?

USAspending Subaward Scraper calls the public USAspending REST API — no login, no API key. Configure your filters (agency, NAICS, date range, amount), set maxItems, and run it. Results appear in the dataset within seconds for small queries; longer date ranges or unfiltered runs take a few minutes.

What data can I get from USAspending subawards?

USAspending Subaward Scraper returns subawardee name and UEI, prime contractor name and UEI, awarding agency, NAICS and PSC codes, subaward and prime award dollar amounts, place of performance, and a direct link to the prime award record — the full graph for analyzing federal subcontracting relationships.

Can I filter by NAICS code?

USAspending Subaward Scraper accepts 2, 4, or 6-digit NAICS codes (for example, "54", "5413", or "541330"). The USAspending API rejects 3 and 5-digit prefixes with HTTP 400, so the scraper validates the length before sending the request. Enter a valid length and it works. Enter an odd-length code and the NAICS filter is silently skipped rather than failing the run.

Does USAspending Subaward Scraper need proxies?

USAspending Subaward Scraper does not use proxies. USAspending.gov is a public government API that accepts datacenter IPs at a reasonable request pace. No residential proxies, no browser — just direct API calls with a 200ms courtesy delay between pages.

How much does it cost to run?

USAspending Subaward Scraper charges $0.10 per start plus $0.001 per record. A run returning 500 subawards costs around $0.60. The enrichment calls (award detail endpoint) don't add to record count — you pay per subaward saved, not per API request made.

---

Need More Features?

Need custom fields, additional filter types, or a bulk export mode? File an issue or get in touch.

Why Use USAspending Subaward Scraper?

• Subaward-to-prime graph — returns both sides of the relationship (subawardee and prime contractor, with UEIs for both) in a single record, which is what you actually need for competitive analysis
• Enriched output — NAICS, PSC, total obligation, and prime contractor state come from the award detail endpoint when the search results omit them, so you get complete records even when the base API returns partial data
• No infrastructure needed — no API keys, no proxies, no browser automation; it calls a public government API at a courteous pace and returns structured JSON