# USAspending Federal Awards 🏛️ (new contract & grant alerts) (`tagadanar/usaspending-federal-awards`) Actor
Pull every US federal contract, grant, loan or direct payment on the official USAspending.gov API, filtered by agency, recipient, NAICS, keyword or state. Monitor mode returns only awards that are new since your last run. No SAM.gov login, no API key. From $2 per 1,000 awards.
- **URL**: https://apify.com/tagadanar/usaspending-federal-awards.md
- **Developed by:** [Tagada Data](https://apify.com/tagadanar) (community)
- **Categories:** Lead generation, Automation, News
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.40 / 1,000 award founds
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## USAspending Federal Awards 🏛️
See every US federal contract, grant, loan and direct payment your competitors and targets win, filtered by agency, recipient, NAICS, keyword or state. No SAM.gov login, no API key, no scraping fragile pages. The data comes straight from the official USAspending.gov API, the government's own system of record for federal spending.
Run it once to pull a slice of federal awards, or turn on monitor mode and schedule it: every run then returns only the awards that are new since the last one, and can post a digest to Slack. Good for capture teams tracking an agency, prospectors watching a competitor, and analysts building a market picture.
### What you get
One flat record per award, ready for a spreadsheet or CRM:
| Field | What it is |
| --- | --- |
| `awardId` | The federal award / PIID identifier |
| `recipientName` | Company or organization that won the award |
| `awardAmount` | Award amount in US dollars (number) |
| `awardType` | Award type label where the API provides one (e.g. cooperative agreement) |
| `awardingAgency` | Top-tier awarding agency (e.g. Department of Defense) |
| `awardingSubAgency` | Awarding sub-agency (e.g. Department of the Army) |
| `startDate` | Period-of-performance start date |
| `endDate` | Period-of-performance end date |
| `description` | Award description text |
| `naics` | NAICS industry code (contracts only) |
| `placeOfPerformanceState` | Two-letter state where the work is performed |
| `awardUrl` | Link to the award detail page on usaspending.gov |
| `changeType` | `new` in monitor mode; `null` on one-off runs |
| `retrievedAt` | Timestamp of the run |
Results come sorted by award amount, largest first, so the biggest wins are at the top.
### Who uses it
- GovCon business development and capture teams tracking who is winning work at a target agency.
- Subcontractor prospectors looking for prime contractors to team with in their NAICS and state.
- Competitive-intelligence analysts building a picture of a competitor's federal book of business.
- Grant and nonprofit teams watching which organizations pull federal grant funding.
### Input examples
Every example below validates against the input schema. Copy one into the input editor and adjust.
Track new Department of Defense IT contracts (NAICS 541511) from the last 30 days:
```json
{
"awardTypes": ["contracts"],
"agencies": ["Department of Defense"],
"naicsCodes": ["541511"],
"lastNDays": 30,
"maxResults": 200
}
````
Monitor awards to a specific company and get a Slack digest of new ones:
```json
{
"awardTypes": ["contracts", "grants"],
"recipientSearch": ["Leidos"],
"lastNDays": 90,
"monitorMode": true,
"webhookUrl": "https://hooks.slack.com/services/your/webhook/url"
}
```
Pull every federal grant in a fiscal year for organizations matching a name:
```json
{
"awardTypes": ["grants"],
"recipientSearch": ["Johns Hopkins"],
"fiscalYear": 2025,
"maxResults": 1000
}
```
Find cybersecurity awards performed in Virginia:
```json
{
"awardTypes": ["contracts"],
"keywords": ["cybersecurity"],
"placeOfPerformanceStates": ["VA"],
"lastNDays": 180
}
```
### FAQ
#### How do I track new federal contracts by agency?
Set `awardTypes` to `["contracts"]`, add the agency to `agencies` (spelled exactly as USAspending does, e.g. `Department of Defense`), and turn on `monitorMode`. Schedule the actor to run daily. The first run records a baseline, and every run after that returns only awards that appeared since the previous run. Add a `webhookUrl` to get each batch posted to Slack.
#### Can I monitor awards to a specific company?
Yes. Put one or more name terms in `recipientSearch`, for example `["Boeing"]` or `["Leidos", "SAIC"]`. Combine it with `monitorMode` and a schedule to get alerted whenever that company wins something new. You can scope further by award type, agency, NAICS or state.
#### Is USAspending data free?
The underlying USAspending.gov data is public and free, and this actor needs no API key or SAM.gov account. You pay only for the awards this actor delivers to you: the events below cover the platform compute for running, paginating and formatting the data into clean records.
#### How is this different from SAM.gov?
SAM.gov lists opportunities: solicitations agencies are still deciding on. USAspending is the record of awards that have already been made, including who won and for how much. This actor reads awarded spending, so it answers "who is winning this work" rather than "what is up for bid". If you want European or French public tenders instead, see the sibling French Public Tenders actor.
#### What award types are covered?
Contracts (codes A/B/C/D), grants (02/03/04/05), loans (07/08), direct payments (06/10) and other (09/11). Pick any combination in `awardTypes`.
#### How far back can I go?
The API supports action dates back to 2007-10-01. Use `lastNDays` for a rolling window or `fiscalYear` for a full US federal fiscal year (October through September).
### Pricing
Pay per result, plus a tiny start fee. Misses are free.
| Event | Price |
| --- | --- |
| Actor start | $0.00005 |
| Award found (per award delivered) | $0.002 ($2 per 1,000) |
| Digest sent (per Slack digest in monitor mode) | $0.03 |
### More from this account
Built by [tagadanar on Apify](https://apify.com/tagadanar). If you like this, the same account publishes sibling monitors: the ClinicalTrials.gov Monitor for drug and device trials, the SEC EDGAR Monitor for company filings, and French Public Tenders for EU and French bidding opportunities.
***
Keywords: USAspending, federal spending, government contracts, federal grants, GovCon, government contracting, capture management, business development, competitive intelligence, NAICS, prime contractor, subcontractor, award monitor, contract alerts, federal awards API, SAM.gov alternative, DoD contracts, federal loans, agency spending, recipient search.
# Actor input Schema
## `awardTypes` (type: `array`):
Which kinds of federal awards to pull. Contracts = A/B/C/D, Grants = 02/03/04/05, Loans = 07/08, Direct payments = 06/10, Other = 09/11. Pick one or more. Defaults to Contracts.
## `agencies` (type: `array`):
Top-tier awarding agency names, exactly as USAspending spells them, e.g. Department of Defense, Department of Health and Human Services, National Aeronautics and Space Administration. Multiple entries broaden the search (OR).
## `recipientSearch` (type: `array`):
Company or organization name terms to match on the recipient, e.g. Boeing, Leidos. Matches the recipient name text on the award.
## `naicsCodes` (type: `array`):
Industry codes to filter by, e.g. 541511 (custom computer programming), 541330 (engineering services). Contracts only; grants and loans carry no NAICS.
## `keywords` (type: `array`):
Free-text keywords matched across the award, e.g. cybersecurity, satellite. Combined as the API's keyword filter.
## `placeOfPerformanceStates` (type: `array`):
Two-letter US state codes where the work is performed, e.g. VA, CA, TX. Leave empty for all states.
## `lastNDays` (type: `integer`):
Look back this many days from today (by award action date window). Ignored when a fiscal year is set. Use a small window for a scheduled monitor.
## `fiscalYear` (type: `integer`):
US federal fiscal year to pull instead of the last-N-days window, e.g. 2025 covers 2024-10-01 through 2025-09-30. Leave empty to use Last N days.
## `maxResults` (type: `integer`):
Stop after collecting this many awards. Caps cost and runtime on broad queries. Results come sorted by award amount, largest first.
## `monitorMode` (type: `boolean`):
Remember award IDs already seen across runs and return only awards that are new since last time. Built for a scheduled run: the first run establishes the baseline, later runs report and charge for new awards only.
## `webhookUrl` (type: `string`):
When monitor mode finds new awards, post a text digest here (Slack incoming webhook or any endpoint accepting {"text": "..."} JSON).
## Actor input object example
```json
{
"awardTypes": [
"contracts"
],
"agencies": [
"Department of Defense"
],
"recipientSearch": [],
"naicsCodes": [],
"keywords": [],
"placeOfPerformanceStates": [],
"lastNDays": 30,
"maxResults": 10,
"monitorMode": false
}
```
# Actor output Schema
## `awards` (type: `string`):
One item per matched (or new) federal award in the default dataset.
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"awardTypes": [
"contracts"
],
"agencies": [
"Department of Defense"
],
"lastNDays": 30,
"maxResults": 10
};
// Run the Actor and wait for it to finish
const run = await client.actor("tagadanar/usaspending-federal-awards").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"awardTypes": ["contracts"],
"agencies": ["Department of Defense"],
"lastNDays": 30,
"maxResults": 10,
}
# Run the Actor and wait for it to finish
run = client.actor("tagadanar/usaspending-federal-awards").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"awardTypes": [
"contracts"
],
"agencies": [
"Department of Defense"
],
"lastNDays": 30,
"maxResults": 10
}' |
apify call tagadanar/usaspending-federal-awards --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=tagadanar/usaspending-federal-awards",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "USAspending Federal Awards 🏛️ (new contract & grant alerts)",
"description": "Pull every US federal contract, grant, loan or direct payment on the official USAspending.gov API, filtered by agency, recipient, NAICS, keyword or state. Monitor mode returns only awards that are new since your last run. No SAM.gov login, no API key. From $2 per 1,000 awards.",
"version": "0.1",
"x-build-id": "0c1XfBDIINcUaW87C"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tagadanar~usaspending-federal-awards/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tagadanar-usaspending-federal-awards",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/tagadanar~usaspending-federal-awards/runs": {
"post": {
"operationId": "runs-sync-tagadanar-usaspending-federal-awards",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/tagadanar~usaspending-federal-awards/run-sync": {
"post": {
"operationId": "run-sync-tagadanar-usaspending-federal-awards",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"awardTypes": {
"title": "Award types",
"type": "array",
"description": "Which kinds of federal awards to pull. Contracts = A/B/C/D, Grants = 02/03/04/05, Loans = 07/08, Direct payments = 06/10, Other = 09/11. Pick one or more. Defaults to Contracts.",
"items": {
"type": "string",
"enum": [
"contracts",
"grants",
"loans",
"direct_payments",
"other"
],
"enumTitles": [
"Contracts",
"Grants",
"Loans",
"Direct payments",
"Other"
]
},
"default": [
"contracts"
]
},
"agencies": {
"title": "Awarding agencies",
"type": "array",
"description": "Top-tier awarding agency names, exactly as USAspending spells them, e.g. Department of Defense, Department of Health and Human Services, National Aeronautics and Space Administration. Multiple entries broaden the search (OR).",
"items": {
"type": "string"
}
},
"recipientSearch": {
"title": "Recipient name search",
"type": "array",
"description": "Company or organization name terms to match on the recipient, e.g. Boeing, Leidos. Matches the recipient name text on the award.",
"default": [],
"items": {
"type": "string"
}
},
"naicsCodes": {
"title": "NAICS codes",
"type": "array",
"description": "Industry codes to filter by, e.g. 541511 (custom computer programming), 541330 (engineering services). Contracts only; grants and loans carry no NAICS.",
"default": [],
"items": {
"type": "string"
}
},
"keywords": {
"title": "Keywords",
"type": "array",
"description": "Free-text keywords matched across the award, e.g. cybersecurity, satellite. Combined as the API's keyword filter.",
"default": [],
"items": {
"type": "string"
}
},
"placeOfPerformanceStates": {
"title": "Place of performance states",
"type": "array",
"description": "Two-letter US state codes where the work is performed, e.g. VA, CA, TX. Leave empty for all states.",
"default": [],
"items": {
"type": "string"
}
},
"lastNDays": {
"title": "Last N days",
"minimum": 1,
"maximum": 3650,
"type": "integer",
"description": "Look back this many days from today (by award action date window). Ignored when a fiscal year is set. Use a small window for a scheduled monitor.",
"default": 30
},
"fiscalYear": {
"title": "Fiscal year (optional)",
"minimum": 2008,
"maximum": 2030,
"type": "integer",
"description": "US federal fiscal year to pull instead of the last-N-days window, e.g. 2025 covers 2024-10-01 through 2025-09-30. Leave empty to use Last N days."
},
"maxResults": {
"title": "Max results per run",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "Stop after collecting this many awards. Caps cost and runtime on broad queries. Results come sorted by award amount, largest first.",
"default": 200
},
"monitorMode": {
"title": "Monitor mode (alert on new awards only)",
"type": "boolean",
"description": "Remember award IDs already seen across runs and return only awards that are new since last time. Built for a scheduled run: the first run establishes the baseline, later runs report and charge for new awards only.",
"default": false
},
"webhookUrl": {
"title": "Webhook URL (Slack-compatible)",
"type": "string",
"description": "When monitor mode finds new awards, post a text digest here (Slack incoming webhook or any endpoint accepting {\"text\": \"...\"} JSON)."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```