Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

USASpending.gov Scraper — Federal Contracts, Grants & Awards Data (No API Key)

Apify Actor No API key Pricing Export

This repository is documentation only. The scraper runs as a hosted Actor on the Apify platform — no install, no server, no API key.

Pull the full firehose of US federal spending — contracts, grants, loans and direct payments — from the official USASpending.gov open data. This federal-awards scraper returns clean, flat records of who is being paid by the US government, for what, when and where, with no login, no API key and no scraping fragility. A single run can return hundreds of thousands of records of authoritative Treasury spending data.

Filter by award type, place-of-performance state, award-action date range and free-text keyword, and get one flat record per award — ideal for GovCon business development, federal-contractor lead generation and budget analytics.


✨ What you get

One flat dataset record per federal award. The dataset includes:

Field Description
awardId Federal award identifier (PIID, FAIN or URI)
recipientName Award recipient (company, university, agency or individual)
awardAmount Total obligated award amount in USD
totalOutlays Total outlays (money actually paid out) in USD
awardType Contract / grant / loan / direct payment / other
description Award description / purpose
startDate / endDate Period-of-performance start and end dates
awardingAgency Top-level federal agency that awarded it
awardingSubAgency Sub-agency / bureau that awarded it
placeOfPerformanceState US state where the work is performed
placeOfPerformanceCountry Country where the work is performed
url Link to the award detail page on USASpending.gov
scrapedAt ISO timestamp when the record was collected

A Federal Awards dataset view is pre-configured with the most useful columns (recipient, amount, agency, type, dates, state).

💡 Use cases

  • Government-contractor research (GovCon BD) — see exactly who is winning federal contracts, with which agency, for how much; build account plans for top awardees in your vertical.
  • Federal budget analytics — track agency-level spending trends over time and roll up by sub-agency or place of performance.
  • Grant tracking — monitor new grants in your domain (cybersecurity, biotech, climate, AI, defense) as they are announced.
  • B2B sales & lead generation — federal awardees are pre-qualified prospects for cloud, staffing, GovTech, fintech and compliance vendors.
  • Watchdog & investigative journalism — surface unusual awards, large outlays and contractor concentration at scale.
  • Competitive intelligence — benchmark a competitor's federal footprint by agency, amount and geography.

🚀 Quick start

Only awardTypes matters to get going; empty dates default to the last 12 months through today.

Option 1 — Apify Console (no code)

  1. Open the USASpending.gov Scraper and click Try for free.
  2. Pick award types (contracts, grants, direct-payments, loans, other), a date range, and an optional keyword.
  3. Click Start and export from the Output tab as CSV, JSON, JSONL or Excel.

Option 2 — Apify CLI

npm i -g apify-cli
apify login
apify call logiover/usaspending-gov-scraper \
  --input '{ "awardTypes": ["contracts", "grants"], "startDate": "2026-01-01", "endDate": "2026-12-31", "keyword": "cybersecurity", "maxAwards": 0 }'

Option 3 — API (curl)

curl -X POST "https://api.apify.com/v2/acts/logiover~usaspending-gov-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "awardTypes": ["grants"], "startDate": "2026-01-01", "endDate": "2026-06-30", "maxAwards": 2000 }'

Option 4 — JavaScript & Python

See examples/javascript.md and examples/python.md for apify-client snippets, plus examples/cli.md and examples/api-curl.md.

📥 Input

Field Type Required Description Default
awardTypes array Yes contracts, grants, direct-payments, loans, other. ["contracts"]
state string (dropdown) No Place-of-performance US state / territory. Blank = whole country. ""
startDate string No Earliest award action date (YYYY-MM-DD). Empty = last 12 months. ""
endDate string No Latest award action date (YYYY-MM-DD). Empty = today. ""
keyword string No Free-text filter on recipient / description / agency. ""
maxAwards integer No Cap on awards saved (0 = all matching, can be hundreds of thousands). Results are sorted by award amount, largest first. 100

📤 Output

A realistic (trimmed) sample dataset item:

{
  "awardId": "CONT_AWD_47QTCA20D003X_4732_0_-none-",
  "recipientName": "ACME DEFENSE SYSTEMS, INC.",
  "awardAmount": 12450000.00,
  "totalOutlays": 3800000.00,
  "awardType": "contract",
  "description": "CYBERSECURITY OPERATIONS AND INCIDENT RESPONSE SUPPORT SERVICES",
  "startDate": "2026-01-15",
  "endDate": "2028-01-14",
  "awardingAgency": "Department of Homeland Security",
  "awardingSubAgency": "Cybersecurity and Infrastructure Security Agency",
  "placeOfPerformanceState": "VA",
  "placeOfPerformanceCountry": "USA",
  "url": "https://www.usaspending.gov/award/CONT_AWD_47QTCA20D003X_4732_0_-none-",
  "scrapedAt": "2026-07-06T12:00:00.000Z"
}

🔗 Integrations & automation

Everything runs on the Apify platform, so you can:

  • Schedule the Actor with a rolling date window for an always-fresh federal-awards feed.
  • Fire webhooks on completion, or push results to Google Sheets, a CRM, S3 or a database.
  • Connect it to Make, n8n, Zapier or Pipedream to route new awards into GovCon dashboards and sales pipelines.
  • Feed BI tools and data warehouses for federal-spending analytics.

📦 Export formats

CSV · JSON · JSON Lines (JSONL) · Excel (.xlsx) · XML — from the run's Export button or via the Apify API dataset endpoints.

❓ FAQ

Is this a USASpending.gov API alternative?

Yes. It's an unofficial wrapper around the public USASpending.gov data, giving you a no-code extraction tool that handles pagination and flattens awards into ready-to-use records.

Do I need an API key or login?

No. The USASpending.gov data is public and unauthenticated — no API key, no login, no proxy required. Only an Apify account is needed.

How much data can I get in one run?

Hundreds of thousands of records. Set maxAwards: 0 for everything matching your filters, or cap it for a faster sample.

How does this compare to SAM.gov?

SAM.gov shows active solicitations and opportunities (what's available to bid on). USASpending shows what has already been awarded and to whom. They're complementary — this Actor handles the awarded side at historical scale.

How do I find who won federal contracts in a specific sector?

Set awardTypes to contracts and add a keyword like cybersecurity to filter by recipient, description or agency — each result gives the awardee, amount, agency and place of performance.

Can I scrape all federal award types in a single run?

Yes. List contracts, grants, direct-payments, loans and other together in awardTypes and the Actor paginates all matching awards across every category into one dataset.

How do I export federal grant awards for a date range?

Choose the grants award type and set startDate and endDate (YYYY-MM-DD) to pull every grant obligated in that window, then export it to CSV or JSON.

Can I limit awards to one state?

Yes — set state to a US state/territory code (e.g. VA, CA, TX) to keep only awards with that place of performance.

Can I scrape federal awards without an API key or login?

Yes. The data is public and unauthenticated, so you can pull federal contracts and grants without any API key, login or proxy.

Is it legal to use this data?

USASpending.gov is official open US government data published for public re-use. You are responsible for using it in compliance with the site's terms and applicable laws.

🧭 Related actors by logiover

Browse the full catalog on the logiover Apify Store profile.


📄 Documentation only — this repository contains no Actor source code. The scraper runs on the Apify platform. ▶️ Run it: https://apify.com/logiover/usaspending-gov-scraper

Licensed under the MIT License · © 2026 logiover · Not affiliated with USASpending.gov, the US Treasury or the US government.

About

Scrape US federal spending from USASpending.gov: contracts, grants, loans & direct payments with recipient, amount, agency & place of performance. No API key. GovCon data. Docs for the hosted Apify Actor.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors