# US Government Contract Awards: Who Wins Federal Money (`precious_bathmat/federal-contract-awards`) Actor

Find US federal contract and grant awards on USAspending.gov by keyword, company, agency, state, NAICS and amount: who won, how much, which agency, industry, dates and place of performance. Plus a report per search with top winners, agencies, industries and states. Official API, no login.

- **URL**: https://apify.com/precious_bathmat/federal-contract-awards.md
- **Developed by:** [Mariam Ahmed](https://apify.com/precious_bathmat) (community)
- **Categories:** Lead generation, Business
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.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

## US Government Contract Awards: Who Wins Federal Money

Find **US federal contract and grant awards** on **USAspending.gov**, the US Treasury's official spending database, by keyword, company, agency, state, industry (NAICS) and amount. It uses the official API, with no login and no API key. You also get a **report for every search**:

- **Every award**: who won it (**recipient** and UEI, city, state, ZIP), **amount** and outlays, **awarding agency** and sub-agency, description, **NAICS** and PSC codes (or grant program), award date, start and end, place of performance, link to the award page
- **Filters**: keywords, companies, award type (contracts, contract vehicles/IDVs, grants), date window, new awards only, agencies, states, NAICS, PSC, minimum and maximum amount
- **Report per search**, over **every** matching award: **top winners**, **top agencies**, **top industries** (or grant programs) and **top states**, with dollar shares; plus the largest awards, awards by month and the median award size

### What does this government contracts scraper do?

```
Contracts · "janitorial" · new awards Aug 3 – Nov 1, 2026
 398 awards · $111.3M · median $28,359
 Agencies: Veterans Affairs 37% · GSA 24%
 Winners: Superior Keystone 13% · Fedcap 11% · Unique Cleaning 9%
 Where: Puerto Rico 14% · New York 13% · California 9%
```

1. Enter **keywords** and/or **companies**, and pick **award types**.
2. Narrow with **dates**, **agencies**, **states**, **NAICS / PSC** codes and **amounts**.
3. You get **one row per award** and **one report per search**.

```mermaid
flowchart LR
    A[Keywords,<br/>companies,<br/>filters] --> B[USAspending<br/>award search]
    B --> C[Awards<br/>winner, amount,<br/>agency, NAICS]
    A --> D[USAspending<br/>breakdowns]
    D --> E[Report<br/>top winners,<br/>agencies, states]
    C --> E
```

### Who is it for?

- **Government contractors and BD teams**: who is winning work in your NAICS codes, from which agencies, and how big the awards are
- **Sales teams selling to contractors**: fresh lists of companies that just won federal money, by industry and state
- **Subcontractors and teaming partners**: the primes winning in your state and niche
- **Grant writers and nonprofits**: which programs and agencies are funding your topic, and who receives the money
- **Journalists and researchers**: federal spending on any topic, agency or company, with links to every award

### What data do you get?

**Awards** (dataset, one row per award)

| Field | What it tells you |
|---|---|
| `awardId`, `url`, `awardGroup`, `awardType` | The award and its USAspending page |
| `recipient`, `recipientUei`, `recipientCity`, `recipientState`, `recipientZip`, `recipientCountry` | Who won it |
| `amount`, `outlays` | Total obligated, and paid so far when reported |
| `description` | What the money is for |
| `awardingAgency`, `awardingSubAgency`, `fundingAgency` | Who awarded and who pays |
| `naicsCode`, `naicsDescription`, `pscCode`, `pscDescription` | Industry and product/service codes (contracts) |
| `assistanceListing` | Grant program (grants) |
| `awardedOn`, `startDate`, `endDate`, `lastModified` | Dates |
| `performanceCity`, `performanceState`, `performanceZip`, `performanceCountry` | Where the work happens |
| `search`, `keyword`, `recipientSearched` | Which search found it |

**Report** (`REPORTS`, one per search; `REPORTS_CSV` as a flat sheet)

| Field | What it tells you |
|---|---|
| `totalAwards`, `awardsRead`, `allAwardsRead` | How many awards match and how many were read |
| `allTopRecipients`, `allTopAgencies`, `allTopIndustries` / `allTopPrograms`, `allTopStates` | Over **every** match: dollars obligated in the window, with shares |
| `amountRead`, `medianAward`, `largestAwards`, `awardsByMonth` | Over the awards read |
| `recipientsRead`, `topRecipientsRead` | Winners among the awards read, with award counts |

### Example: new awards, 3 August to 1 November 2026

Five searches, every matching award read (1,452 awards in 24 seconds):

| Search | Awards | Total | Median | Top agency | Top winner | Top state |
|---|---|---|---|---|---|---|
| Contracts · cybersecurity | 68 | $147.2M | $661,671 | Homeland Security 49% | 22nd Century Technologies 19% | VA 55% |
| Contracts · artificial intelligence | 54 | $128.1M | $545,072 | Homeland Security 36% | Carahsoft 21% | DC 57% |
| Contracts · janitorial | 398 | $111.3M | $28,359 | Veterans Affairs 37% | Superior Keystone 13% | PR 14% |
| Grants · cybersecurity | 163 | $219.1M | $400,000 | Transportation 39% | Southern California Regional Rail 38% | CA 41% |
| Grants · artificial intelligence | 769 | $510.7M | $335,000 | National Science Foundation 76% | Nevada System of Higher Education 9% | CA 12% |

### Pricing

Pay per event:

| Event | Price |
|---|---|
| Award saved | $0.001 |
| Search report | $0.02 |

1,000 awards with a report cost **$1.02**. Platform usage is tiny: the 1,452 awards above used under $0.01 of compute.

### Good to know

- **Official source**: USAspending.gov is run by the US Treasury and covers every federal contract and grant reported under the DATA Act. Data starts in October 2007.
- **Reporting delay**: agencies report contracts within days, but grants can take weeks. The default window is the **last 90 days** so recent searches are not empty; the last couple of weeks are often incomplete.
- **New awards only** (default) keeps awards first made in the window. Turn it off to include older awards that had a modification or new money in the window.
- **Contract vehicles (IDVs)** such as GWACs and BPAs are frameworks: their `amount` is often $0 because the money flows through the orders placed under them (which appear as contracts).
- **Report totals** (`allTop...`) count dollars obligated in the window over every matching award, the way USAspending's own charts do; `totalAwards` is the number of matching awards.
- **Up to 10,000 awards per search** (USAspending's limit); narrow the dates or add filters for more.
- **Agencies** must be written as USAspending writes them, e.g. "Department of Defense", "Department of Veterans Affairs", "General Services Administration".
- **No street addresses**: recipient city, state and ZIP are kept, street lines are not.

### Input

| Field | Default | What it does |
|---|---|---|
| `keywords` | – | One search per keyword; empty = every award matching the filters |
| `recipients` | – | One search per company name or UEI |
| `awardTypes` | `["contracts"]` | `contracts`, `idvs`, `grants` (each searched separately) |
| `dateFrom`, `dateTo` | last 90 days | Date window |
| `newAwardsOnly` | `true` | Only awards first made in the window |
| `agencies` | – | Awarding departments |
| `states` | – | Place of performance, two-letter codes |
| `naicsCodes`, `pscCodes` | – | Industry and product/service codes (contracts) |
| `minAmount`, `maxAmount` | – | Award size in dollars |
| `sort` | `newest` | `newest`, `largest` or `updated` |
| `maxAwardsPerSearch` | `200` | Most awards saved per search (up to 10,000) |
| `includeReports` | `true` | One report per search |

```json
{
  "keywords": ["construction"],
  "agencies": ["Department of Veterans Affairs"],
  "states": ["TX", "FL"],
  "naicsCodes": ["236220"],
  "minAmount": 100000,
  "dateFrom": "2026-01-01",
  "sort": "largest"
}
```

### Integrations

Schedule it weekly to get **new federal awards in your niche**, push winners into **HubSpot**, **Salesforce** or **Google Sheets**, or call it from **Make**, **Zapier**, **n8n** or the **Apify API**. The `REPORTS_CSV` record opens directly in any spreadsheet.

### Related tools

Other tools from the same publisher that pair well with this one:

- [ETF & Mutual Fund Holdings: Every Stock a Fund Owns](https://apify.com/precious_bathmat/etf-mutual-fund-holdings)
- [Congress Stock Trades Tracker: House & Senate STOCK Act Trades](https://apify.com/precious_bathmat/congress-stock-trades)
- [Dexscreener Token Report: Price, Liquidity, Volume & Rug Risk](https://apify.com/precious_bathmat/dexscreener-token-scraper)
- [Forex Economic Calendar: Market-Moving Events](https://apify.com/precious_bathmat/forex-economic-calendar)

# Actor input Schema

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

Words in the award, one search each, e.g. "cybersecurity", "cloud", "janitorial", "drone". Empty = every award matching the filters below.

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

Optional company names or UEIs, one search each (combined with every keyword), e.g. "Lockheed Martin", "Booz Allen".

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

Each type is searched on its own. Default: contracts.

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

Start of the date window (default: 90 days before the end, since agencies often report awards weeks late). Earliest 2007-10-01.

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

End of the date window (default: today).

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

Only awards first made in the date window. Off = also older awards with any activity (modifications, new money) in the window.

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

Optional, full department names as USAspending writes them, e.g. "Department of Defense", "Department of Veterans Affairs", "General Services Administration".

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

Optional two-letter state codes where the work happens, e.g. "TX", "VA", "CA".

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

Optional industry codes (2 to 6 digits, contracts only), e.g. "541512" (computer systems design), "236220" (commercial construction), "54" (all professional services).

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

Optional product and service codes (contracts only), e.g. "DJ10", "R425".

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

Optional: awards of at least this many dollars.

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

Optional: awards of at most this many dollars.

## `sort` (type: `string`):

Which awards to read first.

## `maxAwardsPerSearch` (type: `integer`):

Most awards to save per search (1 to 10,000).

## `includeReports` (type: `boolean`):

One report per search: total awards, top recipients, agencies, industries (or grant programs) and states over every match, plus largest awards and awards by month.

## Actor input object example

```json
{
  "keywords": [
    "cybersecurity",
    "artificial intelligence"
  ],
  "awardTypes": [
    "contracts"
  ],
  "newAwardsOnly": true,
  "sort": "newest",
  "maxAwardsPerSearch": 200,
  "includeReports": true
}
```

# Actor output Schema

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

One row per award: recipient, amount, agency, description, industry, dates, place of performance, link.

## `reports` (type: `string`):

Per search: total awards, top recipients, agencies, industries and states, largest awards, awards by month.

## `reportsCsv` (type: `string`):

One flat row per search.

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

Requests, problems and the limits of the data.

# 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 = {
    "keywords": [
        "cybersecurity",
        "artificial intelligence"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("precious_bathmat/federal-contract-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 = { "keywords": [
        "cybersecurity",
        "artificial intelligence",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("precious_bathmat/federal-contract-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 '{
  "keywords": [
    "cybersecurity",
    "artificial intelligence"
  ]
}' |
apify call precious_bathmat/federal-contract-awards --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,precious_bathmat/federal-contract-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/eahWtaFHb8EKlfxJJ/builds/uHXcDVTy04xk6JFXA/openapi.json
