USAspending Scraper

Overview

This actor scrapes federal spending data from USAspending.gov, the official U.S. government transparency site. It automates the collection of detailed award information—including contracts, grants, loans, and other financial assistance—for analysis, research, and business intelligence.

Key Features

• Comprehensive Data Extraction: Pulls award details (ID, type, amount, dates), recipient information (name, location, UEI), agency data, location info, and classification codes (NAICS, PSC).
• Flexible Filtering: Supports extensive search parameters including award type, date ranges, amount ranges, keywords, recipient details, agency names, and location filters.
• High-Volume Collection: Can collect up to 1,000,000 records per run.
• Structured Output: Delivers data in a clean, downloadable format.

How to Use

Configure the actor using the input form. You can filter data using a wide array of parameters. Important: Use either a startUrl OR the API filters below, not both. The filters offer greater flexibility and are recommended.

Primary Input Parameters

• Award Type: Filter by contracts, grants, loans, IDVs, etc.
• Spending Level: Choose 'awards' or 'sub-awards'.
• Time Period: Set startDate and endDate (YYYY-MM-DD).
• Award Amount Range: Define min/max dollar values.
• Keywords: Search terms within award descriptions.
• Recipients: Filter by name, UEI, or DUNS number.
• Agencies: Filter by awarding or funding agency names.
• Location: Filter by recipient location or place of performance country.
• Codes: Filter by NAICS or PSC codes.
• Sorting: Sort by field (e.g., Award Amount) and order (asc/desc).
• maxItems: Limit the total records collected (1-1,000,000). Leave empty for no limit.

Example Input (JSON)

{
  "awardType": "contracts",
  "spendingLevel": "awards",
  "startDate": "2024-01-01",
  "endDate": "2024-12-31",
  "awardingAgencies": ["Department of Energy"],
  "sort": "Award Amount",
  "order": "desc",
  "maxItems": 10
}

Tip: Use the Advanced Search on USAspending.gov to refine your parameters, then replicate them in the actor's input.

Input/Output

Input: Configure the run via the Apify console input form or by passing a JSON configuration like the example above.

Output: After the run completes, the dataset is available in the Apify dataset store. You can download the results in multiple formats: JSON, CSV, Excel, XML, or HTML. The dataset contains structured records with all scraped fields for the filtered awards.