How to Scrape USAspending Federal Contract Awards

Federal contract research often starts with a broad search and ends with a spreadsheet full of inconsistent dates, duplicate award IDs, and copied descriptions. A repeatable API workflow is easier to audit.

The USAspending Federal Awards Scraper queries the official USAspending award-search endpoint. It returns normalized records with the award ID, recipient, amount, awarding agency, funding agency, activity dates, description, and a link to the source award page.

Run a focused contract search

Start with a real buying category rather than a vendor name. This example finds cybersecurity contracts active in the selected period and returns the largest awards first.

{
  "keywords": ["cybersecurity"],
  "awardCategory": "contracts",
  "startDate": "2025-01-01",
  "endDate": "2026-12-31",
  "sortBy": "Award Amount",
  "sortOrder": "desc",
  "maxResults": 250
}

Store the input beside each export. A result set without its search terms and date range is difficult to reproduce later.

Keep award identity intact

Use generated_internal_id as the primary deduplication key when it is present. Keep award_id as the recognizable contract identifier and retain usaspending_url for manual verification. Do not deduplicate only on recipient name: one recipient can hold many awards, and one award can change as modifications are reported.

For monitoring, compare snapshots by stable identifier. Treat amount or end-date changes as updates instead of new rows. This produces a clean history without erasing the original observation.

Read the date filter carefully

USAspending searches award activity periods. A contract that started before your requested start date may still appear if it remains active during the period. That is useful for market mapping, but it is not the same as a list of contracts newly signed during that window. If you need newly started awards, filter the exported start_date after collection and state that rule in your analysis.

Official spending data can also be revised. Use it for research, qualification, and trend analysis, then verify material findings on the linked award record before acting on them.