# USAspending Federal Awards: Contract & Grant Winners (`frenchdatalab/usaspending-federal-awards`) Actor

Who won US federal contracts and grants: recipient, UEI, amount, awarding agency, NAICS/PSC, place of performance, dates, from the official USAspending.gov API. Filter by keyword, NAICS, agency, state, amount; no 10,000-result cap; daily monitoring.

- **URL**: https://apify.com/frenchdatalab/usaspending-federal-awards.md
- **Developed by:** [French Data lab](https://apify.com/frenchdatalab) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 awards

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## USAspending Federal Awards: Contract & Grant Winners

**Who wins US federal money?** Every federal **contract** (and contract vehicle), **grant**, loan or direct payment from the official **USAspending.gov** API: recipient name and UEI, amount, awarding agency and sub-agency, NAICS and PSC codes, place of performance, dates, with links to the award and recipient pages.

### What can you do with it?

- 🕵️ **Competitive intelligence for government contractors**: *"IT services contracts (NAICS 5415) awarded this month, largest first"*, *"every Booz Allen award at the Department of Homeland Security"*.
- 🎯 **B2B prospecting**: companies that just won federal contracts need staff, subcontractors, software, financing.
- 🔔 **Daily alerts**: schedule a run with `onlyNewSinceLastRun` and receive only the awards you have not seen.
- 📊 **Market sizing**: who buys what, where, for how much (a `SUMMARY` record gives totals, agencies and top recipients).

### Why this Actor?

| | This Actor | Typical USAspending tools |
|---|---|---|
| More than 10,000 results | ✅ keyset pagination: the API's page numbers stop silently at page 100 and repeat it | ❌ capped or duplicated rows |
| New awards only | ✅ awards signed in the period (or all awards with activity, if you prefer) | ⚠️ old awards modified recently mixed in |
| Contracts and grants in one run | ✅ one search per award type (the API refuses mixes), merged | ❌ |
| NAICS, PSC, agency, state, amount, keyword, recipient filters | ✅ | ⚠️ |
| Clean flat fields + links | ✅ award and recipient profile URLs | ⚠️ nested JSON |

### Input

| Field | Description | Example |
|---|---|---|
| `awardTypes` | `contracts`, `idvs`, `grants`, `loans`, `direct_payments`, `other` | `["contracts"]` |
| `naicsCodes` / `pscCodes` | Industry and product codes (contracts) | `["5415"]` |
| `keywords` | Words in the description | `["cybersecurity"]` |
| `recipients` | Company names or UEI | `["Booz Allen"]` |
| `agencies` | Awarding agencies (exact names) | `["Department of Veterans Affairs"]` |
| `states` | Place of performance | `["VA", "MD"]` |
| `withinDays` / `dateFrom` / `dateTo` | Period (default: last 30 days) | `30` |
| `newAwardsOnly` | Awards signed in the period (default `true`) | `true` |
| `minAmount` / `maxAmount` | Award amount in USD | `1000000` |
| `sortBy` | `amount` (largest first) or `newest` | `"amount"` |
| `onlyNewSinceLastRun` | Monitoring mode | `true` |
| `maxResults` | Maximum awards | `500` |

### Output

Real example (shortened):

```json
{
    "awardId": "SS001730048",
    "awardCategory": "contracts",
    "awardType": "DELIVERY ORDER",
    "recipientName": "INTERNATIONAL BUSINESS MACHINES CORPORATION",
    "recipientUei": "J64CSQTQNRC1",
    "amount": 525446095.96,
    "outlays": 341359756.86,
    "startDate": "2016-12-31",
    "endDate": "2027-09-29",
    "dateSigned": "2016-12-23",
    "awardingAgency": "Social Security Administration",
    "naicsCode": "541511",
    "naicsDescription": "CUSTOM COMPUTER PROGRAMMING SERVICES",
    "pscCode": "7030",
    "pscDescription": "INFORMATION TECHNOLOGY SOFTWARE",
    "placeOfPerformanceState": "NY",
    "url": "https://www.usaspending.gov/award/CONT_AWD_SS001730048_2800_GS35F110DA_4732"
}
```

Other fields: `description`, `awardingSubAgency`, `fundingAgency`, `assistanceListings` (grants), `placeOfPerformanceCity`, `lastModified`, `recipientProfileUrl`, `internalId`.

### Notes

- Department of Defense contracts are published on USAspending with a 90-day delay (a federal rule): recent DoD awards appear later.
- Searches start on 2007-10-01 at the earliest.

### Pricing

You only pay for the results returned. No subscription.

| Results | Price |
|---|---|
| 1 award | $0.003 |
| 100 awards | $0.30 |
| 1,000 awards | $3.00 |

A start fee of a fraction of a cent applies per run. Set a **maximum cost per run** and the Actor stops exactly at your budget.

### Use it in your tools

- **No code**: run it from the Apify Console, download the results as Excel, CSV or JSON, and **schedule** it (daily, weekly…).
- **Integrations**: send the results to Google Sheets, Slack, email, webhooks, Make, Zapier or n8n with Apify's integrations.
- **API**: start runs and read the results with the Apify API or the official Python and JavaScript clients.
- **AI agents**: assistants and agents that support MCP can call this Actor as a tool through Apify's MCP server (mcp.apify.com).

### Related Actors

- [Grants.gov Search: US Federal Grant Opportunities](https://apify.com/frenchdatalab/us-federal-grants): US federal grant opportunities (Grants.gov)
- [Federal Register Monitor: US Rules, Proposed Rules & Notices](https://apify.com/frenchdatalab/federal-register-monitor): US rules, proposed rules and notices (Federal Register)
- [UK Public Tenders: Find a Tender + Contracts Finder](https://apify.com/frenchdatalab/uk-public-tenders): UK public tenders from Find a Tender and Contracts Finder
- [US Stock Fundamentals Screener: Official SEC Financials](https://apify.com/frenchdatalab/us-stock-fundamentals-sec): Fundamentals of every US-listed stock from official SEC filings

### Source

**USAspending.gov**, U.S. Department of the Treasury: U.S. Government public data. This Actor is independent and not affiliated with or endorsed by the U.S. Government.

# Actor input Schema

## `awardTypes` (type: `array`):

Contracts (purchase orders, delivery orders, definitive contracts), IDVs (GWACs, BPAs, IDIQs), grants, loans, direct payments.

## `naicsCodes` (type: `array`):

2 to 6 digits, e.g. "5415" (computer systems design), "541330" (engineering), "236220" (commercial construction). Contracts and IDVs only.

## `pscCodes` (type: `array`):

Product and Service Codes, e.g. "D399", "R425". Contracts and IDVs only.

## `keywords` (type: `array`):

Words in the award description or recipient, e.g. "cybersecurity", "cloud".

## `recipients` (type: `array`):

Company or organization names (or UEI), e.g. "Lockheed", "Booz Allen".

## `agencies` (type: `array`):

Exact top-tier names, e.g. "Department of Veterans Affairs", "Department of Homeland Security", "General Services Administration".

## `states` (type: `array`):

2-letter codes: VA, MD, CA, TX…

## `withinDays` (type: `integer`):

Default 30. Ignored when "From date" is set.

## `dateFrom` (type: `string`):

YYYY-MM-DD (2007-10-01 at the earliest).

## `dateTo` (type: `string`):

YYYY-MM-DD (default: today).

## `newAwardsOnly` (type: `boolean`):

Only awards signed in the period (untick to also get older awards modified or paid in the period).

## `minAmount` (type: `integer`):

Award amount at least this value.

## `maxAmount` (type: `integer`):

Award amount at most this value.

## `sortBy` (type: `string`):

Largest awards first, or newest first.

## `onlyNewSinceLastRun` (type: `boolean`):

Monitoring: schedule the Actor (e.g. every morning) to get only the awards you have not received yet.

## `maxResults` (type: `integer`):

Maximum number of awards returned (no 10,000 cap). Split evenly between award types.

## Actor input object example

```json
{
  "awardTypes": [
    "contracts"
  ],
  "naicsCodes": [
    "541511",
    "541512"
  ],
  "withinDays": 30,
  "newAwardsOnly": true,
  "sortBy": "amount",
  "onlyNewSinceLastRun": false,
  "maxResults": 50
}
```

# Actor output Schema

## `awards` (type: `string`):

No description

## `summary` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "naicsCodes": [
        "541511",
        "541512"
    ],
    "maxResults": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("frenchdatalab/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "naicsCodes": [
        "541511",
        "541512",
    ],
    "maxResults": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("frenchdatalab/usaspending-federal-awards").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "naicsCodes": [
    "541511",
    "541512"
  ],
  "maxResults": 50
}' |
apify call frenchdatalab/usaspending-federal-awards --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,frenchdatalab/usaspending-federal-awards"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/3V6r3qc8yn9VofCbb/builds/HQvfXcrVGROTGY1f8/openapi.json