USAspending Scraper — Federal Contracts & Grants

Every US federal contract, grant, loan and IDV on USAspending.gov, searchable by keyword, agency, recipient, state, amount or date — with contract duration and the recompete window already worked out.

No API key. No account. US federal spending data is public domain, read through the Treasury's own documented API.

Why this one

Most USAspending tools hand back the API's raw columns. The two fields a govcon seller actually sorts on aren't in the API at all:

• daysUntilEnd — how long before this award's period of performance ends
• expiringWithin180Days — the recompete window, ready to filter on

Set expiringSoonOnly with an agency filter and you have a list of incumbent contracts about to come up for renewal, largest first.

Example output record

{
  "awardId": "19AQMM20F1777",
  "recipientName": "PERATON INC.",
  "awardAmount": 338694143.24,
  "awardingAgency": "Department of State",
  "awardingSubAgency": "Department of State",
  "startDate": "2020-07-10",
  "endDate": "2027-06-03",
  "durationDays": 2519,
  "daysUntilEnd": 273,
  "expiringWithin180Days": false,
  "description": "CYBER SECURITY SUPPORT SERVICES",
  "placeOfPerformanceState": "VA",
  "recipientState": "VA",
  "url": "https://www.usaspending.gov/award/CONT_AWD_19AQMM20F1777"
}

Input options

Option	Default	What it does
keywords	—	Free-text across descriptions, recipients and identifiers
awardTypes	contracts	contracts, idvs, grants, direct_payments, loans, other
agencies	—	Top-tier agency names, e.g. Department of Defense
recipients	—	Recipient name or identifier, e.g. Peraton
recipientStates	—	Two-letter state codes for the recipient's location
awardedFrom / awardedTo	—	Award action date range
minAmount / maxAmount	—	Award value bounds in USD
expiringSoonOnly	false	Only awards ending within 180 days
sort / order	Amount, desc	Sort before paging
maxItems	500	Hard cap per run

Use cases

• Recompete pipeline. agencies + expiringSoonOnly gives every incumbent contract at your target agency coming up for renewal. Search terms: federal contract data, govcon leads.
• Competitor tracking. Put a rival in recipients and watch what they win, from which agency, for how long. Search terms: usaspending api, government contract awards.
• Grant prospecting. Switch awardTypes to grants and filter by state to see who funds work like yours. Search terms: federal grants data.

Honest limits

• Award search cannot go earlier than 2007-10-01. That is the API's own floor, reported in its response messages; earlier data exists only through the bulk download endpoints. An open-ended date range is anchored there rather than silently dropping the filter.
• Award types are not freely mixable. Contracts and assistance awards carry different columns, so a run takes one coherent set — this actor uses the field set the API accepts for every group.
• Amounts are the award's current total value, not outlays to date.
• Description is as filed by the agency, which means it is sometimes an acronym soup. That is the source data, not a parsing failure.

Pricing

Pay per event: $0.004 per award returned. A 500-award sweep is $2. Runs that match nothing cost nothing beyond the platform's start fee.

Changelog

• 0.1 — first release: keyword, agency, recipient, state, amount, date and award-type filters; duration and recompete-window derivation; direct USAspending.gov links per award.