USAspending Federal Awards Monitor (Contracts & Grants)

Unofficial. Not affiliated with or endorsed by USAspending.gov, the U.S. Department of the Treasury (Bureau of the Fiscal Service) or any federal agency. Data comes from the official USAspending.gov API. Per USAspending's licensing statement, the data may be used for commercial purposes, subject to the Limitation on Permissible Use of Dun & Bradstreet, Inc. Data. Recipient names may include D&B Open Data (source: Dun & Bradstreet).

Citation: USAspending.gov, U.S. Department of Treasury, Bureau of the Fiscal Service, https://www.usaspending.gov.

Search U.S. federal contracts, IDVs and grants, newest-modified first. Put it on a schedule with Only new or changed since last run to get awards you haven't seen, plus awards whose amount, outlays or end date changed.

What you get

One row per prime award: award ID, category and type, recipient name and UEI, award amount, total outlays, description, last modified time, base obligation / start / end dates, awarding agency and sub-agency, funding agency, NAICS and PSC (contracts/IDVs), assistance listings (grants), place-of-performance state and country, disaster/emergency (DEF) codes, and the USAspending award page link. Rows also carry updateType (new / changed in monitor mode, otherwise null), previous (on changed rows: the earlier award amount, total outlays, end date and last-modified time) and changeHash. Recipient street addresses and DUNS numbers are not included. lastModified is shown as published by USAspending (YYYY-MM-DDTHH:MM:SS); the API does not state a time zone.

Input

Field	Notes
awardCategories	contracts, idvs, grants (default contracts + grants)
keywords	each 3-100 characters
recipientSearch	recipient name or UEI
awardingAgencies	top-tier names or abbreviations (DOD, NASA, NSF…); unknown names fail clearly
naicsCodes	contracts/IDVs only
assistanceListings	grants only, e.g. 47.084
placeOfPerformanceStates	2-letter codes
minAmount / maxAmount	award amount range (USD)
dateType, fromDate, toDate	last_modified_date (default) or action_date; with no dates, the last 7 days
maxItems	default 25, max 1000 per run
onlyNewSinceLastRun	monitor mode, see below
outputFormat	full or compact

Example: new or changed DoD cybersecurity contracts in Virginia:

{ "awardCategories": ["contracts"], "keywords": ["cybersecurity"], "awardingAgencies": ["DOD"], "placeOfPerformanceStates": ["VA"], "onlyNewSinceLastRun": true }

Only new or changed since last run

The first run with a set of filters is a baseline; it saves state in a named key-value store in your Apify account (usaspending-awards-monitor-state). Later runs with the same filters look at awards modified since the day before the last complete run and return:

• new: awards not delivered before;
• changed: delivered awards whose award amount, total outlays or end date changed (with previous values).

Modifications that change none of these three fields (for example description or metadata edits) are not re-sent. Changed rows are charged like any other row. If a run is cut short (maxItems, your cost limit or the request cap), the rest arrive on the next run. If a baseline is cut short, older matches are only delivered later if they are modified again (olderMatchesSkipped: true). Up to 50,000 delivered awards are remembered per filter set (most recently modified kept); an award forgotten beyond that would show up as new again.

Run summary

The OUTPUT record lists count, chargedCount, the dates and request bodies used, truncated (true only when more matching rows exist beyond maxItems, the cost limit or the request cap), and monitor details (newCount and changedCount counted from pushed rows, skippedUnchanged, cursor). The output schema lists every field.

Limits and notes

• Not legal, financial or procurement advice; verify on USAspending.gov / SAM.gov.
• No API key. The Actor waits at least 250 ms between requests (retries included) and makes at most 40 requests per run (100 rows per page). Max 1,000 rows per run: this is a search and monitoring tool, not a bulk export (use USAspending's own download tools for bulk data).
• USAspending's search covers awards from 2007-10-01 on. Data is reported by agencies and can be revised; amounts are as published.
• Very broad monitors (for example all contracts, no other filters) can see more modifications per day than one run reads (40 requests x 100 rows). Then every run hits the request cap, the cursor does not advance and older-modified awards may never be reached; the run summary shows consecutiveCappedRuns and logs a warning from the second capped run. Narrow the filters or split into several monitors. If the cap is hit, categoriesPartial / categoriesSkipped name the award categories that were cut or not queried that run.
• minAmount / maxAmount filter on the current award amount. If a deobligation (or increase) moves an award outside that range, it stops matching, so no changed row is sent for that change.
• Subawards, loans and direct payments are not included.

Support

Questions or problems: digitalpromohub.support@gmail.com