# USAspending Federal Contract Awards & Winners (Gov Contracts) (`quarrylane-data/usaspending-federal-contract-awards`) Actor

US federal government contract awards and winners from the official USAspending API: recipient, UEI, amount, agency, NAICS, PSC, place of performance and dates. Filter by agency, state, NAICS or amount. No API key.

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

## Pricing

from $3.50 / 1,000 award records

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/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 Federal Contract Awards (USASpending) — Recent Prime Awards & Winners

Export **recent US federal prime contract awards and winners** from the official, **keyless** [USASpending.gov API](https://api.usaspending.gov/docs/endpoints). Each record includes the **recipient name, UEI and address, award amount, awarding agency, description, NAICS and PSC, place of performance, key dates and a permalink** back to USASpending. Filter by **date range** (default: last 30 days, new awards only), **NAICS**, **PSC**, **agency**, **state**, **award type** and **minimum amount**.

No SAM.gov login and no API key. This Actor does not call endpoints that require an account.

### What does this Actor do?

Prime contractors, subcontractors and field-sales teams scrape **who just won a federal contract** so they can pitch services the next morning. USASpending is the official source of those awards. This Actor calls `POST /api/v2/search/spending_by_award/` with your filters, pages the results politely, and returns **one normalized row per prime award**.

By default the date filter is **`new_awards_only`**, so you get awards whose **base transaction** falls in the window — not modifications of decade-old mega-contracts that happened to have activity in the last month. You can switch to action date, date signed or last-modified if you need those views.

### Who uses it?

- **Subcontractors and vendors** who want a daily list of prime winners in their NAICS or state
- **GovCon BD teams** watching one agency (DoD, VA, HHS, GSA…)
- **Clay, n8n and Make** workflows that enrich a territory or account list with fresh awards

### Input

| Field | What it does |
|---|---|
| `daysBack` / `startDate` / `endDate` | Search window. Default: last **30 days** through today. The search API only goes back to 2007-10-01. |
| `dateType` | Default **`new_awards_only`**. Alternatives: `action_date`, `date_signed`, `last_modified_date`. |
| `awardTypes` | Default **prime contracts** (A, B, C, D). Add IDVs if you need them. |
| `agencies` | Official toptier names (`Department of Defense`) or abbreviations (`DoD`, `VA`, `HHS`, `GSA`, `NASA`). |
| `naics`, `psc` | Industry and product/service codes. |
| `states` | Two-letter place-of-performance states. `recipientStates` filters the winner's HQ state. |
| `minAmount` / `maxAmount` | Award amount bounds in USD. |
| `keyword`, `recipient` | Official keyword and recipient-name/UEI search. |
| `onlyNew` + `monitorName` | Monitor mode: later runs return (and charge for) only award IDs not seen before. The first run bills up to `maxItems` as standard records and seeds the rest of the current window without charging. |
| `maxItems` | Default **25** (auto-test safe). Free plans are capped at 15. Paid plans can go up to 10,000. A full 30-day national window can contain tens of thousands of new primes — use filters or `maxItems`. |

#### Example input

```json
{
  "daysBack": 30,
  "dateType": "new_awards_only",
  "agencies": ["Department of Defense"],
  "states": ["TX"],
  "minAmount": 100000,
  "maxItems": 25
}
```

### Output

Each record includes `recipientName`, `recipientUei`, `recipientAddress` / city / state / ZIP, `awardAmount`, `awardingAgency`, `awardingSubAgency`, `description`, `naicsCode`, `naicsDescription`, `pscCode`, `placeOfPerformanceState` (and city), `startDate`, `endDate`, `baseObligationDate`, `awardId`, `generatedInternalId` and `usaspendingUrl` (for example `https://www.usaspending.gov/award/CONT_AWD_…`).

Sample from a real run of this Actor (person-name and personal contact fields masked in this README only; long text and lists shortened):

```json
{
  "recordId": "CONT_AWD_80NM0027F7007_8000_80NM0018D0004_8000",
  "awardId": "80NM0027F7007",
  "generatedInternalId": "CONT_AWD_80NM0027F7007_8000_80NM0018D0004_8000",
  "usaspendingUrl": "https://www.usaspending.gov/award/CONT_AWD_80NM0027F7007_8000_80NM0018D0004_8000",
  "recipientName": "CALIFORNIA INSTITUTE OF TECHNOLOGY",
  "recipientUei": "YC1YP79BFD19",
  "recipientAddress": "4800 OAK GROVE DR",
  "recipientCity": "PASADENA",
  "recipientState": "CA",
  "recipientZip": "91109",
  "recipientCounty": "LOS ANGELES",
  "recipientCountry": "UNITED STATES",
  "awardAmount": 10400000,
  "awardingAgency": "National Aeronautics and Space Administration",
  "awardingAgencyCode": "080",
  "awardingSubAgency": "National Aeronautics and Space Administration",
  "awardingSubAgencyCode": "8000",
  "fundingAgency": "National Aeronautics and Space Administration",
  "awardType": "DELIVERY ORDER",
  "description": "TASK PLAN 54-234579 \"MIRAMAR\": THE CONTRACTOR SHALL MANAGE THE EFFORT, PROVIDE TECHNICAL EXPERTISE, DELIVER ELEMENTS OF THE LANDER SYSTEMS, AND COORDINATE AC...",
  "naicsCode": "541715",
  "naicsDescription": "RESEARCH AND DEVELOPMENT IN THE PHYSICAL, ENGINEERING, AND LIFE SCIENCES (EXCEPT NANOTECHNOLOGY AND BIOTECHNOLOGY)",
  "pscCode": "AR12",
  "pscDescription": "SPACE R&D SERVICES; SPACE FLIGHT, RESEARCH AND SUPPORTING ACTIVITIES; APPLIED RESEARCH",
  "placeOfPerformanceCity": "PASADENA",
  "placeOfPerformanceState": "CA",
  "placeOfPerformanceZip": "91109",
  "placeOfPerformanceCounty": "LOS ANGELES",
  "placeOfPerformanceCountry": "UNITED STATES",
  "startDate": "2026-11-06",
  "endDate": "2027-01-31",
  "baseObligationDate": "2026-11-06",
  "lastModifiedDate": "2026-11-09 13:47:00",
  "source": "USASpending",
  "sourceAgency": "U.S. Department of the Treasury / Bureau of the Fiscal Service",
  "sourceDataUrl": "https://api.usaspending.gov/docs/endpoints",
  "scrapedAt": "2026-11-13T04:26:34.817Z"
}
```

### Pricing

Pay per result, with no monthly rental:

| Event | Price |
|---|---|
| Award record (`award-record`) | **$5.00 per 1,000 records** |
| Recent award (`recent-award`, later monitor-mode runs) | **$25.00 per 1,000 records** |

The first monitor run is billed as standard award records (up to `maxItems`). Remaining current matches in the window are remembered but not charged, so later scheduled runs only return new awards. Set **Max cost per run** for a hard budget. Free Apify plans are capped at 15 results per run.

A first monitor run over a very wide unfiltered 30-day window may take several minutes while it pages the official API to seed IDs — raise the run timeout toward 30 minutes in that case, or narrow the filters.

#### Price per event and Store discounts

| Event | Charged for | Free plan | Bronze | Silver | Gold | Per 1,000 (Free plan) |
|---|---|---|---|---|---|---|
| Award record (`award-record`) | Charged for each federal prime contract award saved to your dataset in a standard run, including the first run of a new-awards monitor. | $0.005 | $0.0045 | $0.004 | $0.0035 | $5.00 |
| Recent award (monitor) (`recent-award`) | Charged instead of the standard award record for each award delivered on a later run when monitor mode (onlyNew) is on and this monitor name has already been used. | $0.025 | $0.0225 | $0.02 | $0.0175 | $25.00 |

Prices are in USD per event. This Actor is pay-per-event only: there is no monthly rental and no separate platform usage charge on top, because compute is included in the event price. Apify Bronze, Silver and Gold subscribers get the discounted prices automatically. Set **Max cost per run** in the run options to cap spend, and the Actor stops before it goes over.

### Rate limits

USASpending's global cap is **1,000 requests per 300 seconds** on most endpoints. This Actor sends an identifying User-Agent, waits at least 250 ms between requests, and retries 429/5xx with backoff. No API key is used or required.

### How to automate with Clay.com, n8n, Make, and Claude MCP

All examples use this Actor's Store ID `quarrylane-data/usaspending-federal-contract-awards`. Replace `YOUR_APIFY_TOKEN` with your Apify API token (Console → Settings → API & Integrations). Never paste a token into a public workflow.

#### Official Apify API (run-sync-get-dataset-items)

This endpoint starts a run, waits for it to finish, and returns the dataset items in one call:

```bash
curl -sS -X POST \
  "https://api.apify.com/v2/acts/quarrylane-data~usaspending-federal-contract-awards/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"daysBack":30,"dateType":"new_awards_only","minAmount":100000,"maxItems":15}'
```

The same URL works from any HTTP client. Use `~` between the username and Actor name. For a daily new-award monitor, pass `"onlyNew": true` and a stable `"monitorName"`.

#### n8n

- **Apify node** (community, `n8n-nodes-apify`): add the Apify credentials, choose **Run Actor**, set the Actor to `quarrylane-data/usaspending-federal-contract-awards`, and paste the JSON input above into the Actor input field. Use the node's "wait for finish" option, then read the default dataset.
- **HTTP Request node** (works without the community package): Method `POST`, URL `https://api.apify.com/v2/acts/quarrylane-data~usaspending-federal-contract-awards/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN`, header `Content-Type: application/json`, body as JSON. Each item in the response is one award.

#### Make (Integromat)

Use the **Apify** module's **Run an Actor** action (or an HTTP module with the endpoint above). Map the input fields you need. After the run finishes, use **Get Dataset Items** on the default dataset, or call `run-sync-get-dataset-items` in a single HTTP module to receive the rows directly.

#### Clay.com

Add an **HTTP API** enrichment column:

- Method: `POST`
- URL: `https://api.apify.com/v2/acts/quarrylane-data~usaspending-federal-contract-awards/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN`
- Headers: `Content-Type: application/json`
- Body: `{"daysBack":30,"dateType":"new_awards_only","agencies":["Department of Defense"],"maxItems":15}`

Map `recipientName`, `awardAmount`, `awardingAgency`, `usaspendingUrl` and `baseObligationDate` into Clay columns. Keep `maxItems` small in table-wide enrichments so each row does not start a large run.

#### Claude and the Apify MCP server

This Actor is MCP-compatible (limited permissions). Point Claude, Cursor, or any MCP client at Apify's hosted server and include this Actor in the `tools` query parameter (that is the official parameter for selecting Actors):

```json
{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=quarrylane-data/usaspending-federal-contract-awards"
    }
  }
}
```

On first connect, sign in to Apify (OAuth) or send an `Authorization: Bearer YOUR_APIFY_TOKEN` header. In Claude, you can also add `https://mcp.apify.com?tools=quarrylane-data/usaspending-federal-contract-awards` as a custom connector under Settings → Connectors. Then ask Claude to "list new DoD prime awards in Texas over $100,000 from the last 30 days."

### Is it legal to use this data?

Yes. USASpending.gov is the official public source of federal award data operated by the U.S. Department of the Treasury. The Actor uses the documented public API, identifies itself, and never logs in. Award records describe **business recipients of public contracts**, not private consumer data.

### FAQ

**Is a SAM.gov API key required?** No. This Actor only uses the keyless USASpending API. It does not call SAM.gov.

**Why do I see small GSA purchase orders?** A national 30-day “new awards only” window includes every new prime, including small delivery orders. Use `minAmount`, `agencies`, `naics` or `states` to focus the list. In a typical 30-day window most brand-new primes are GSA delivery orders.

**Why does a DoD filter return so few rows?** `new_awards_only` only includes awards whose *base* transaction falls in the window. Large awarding agencies such as the Department of Defense post relatively few brand-new primes in a given month — most daily activity is modifications of existing awards. For a high-volume DoD (or similar) monitoring feed, set `dateType` to `last_modified_date`. The agency filter itself is correct; a 30-day DoD `last_modified_date` search returns tens of thousands of awards.

**Does the data lag SAM.gov?** USASpending can lag SAM.gov by a couple of weeks on some awards. This Actor reports whatever the official API returns on the day of the run.

Built by **Quarrylane Data**. Not affiliated with the U.S. Department of the Treasury or USASpending.gov. Data comes from the public API at api.usaspending.gov.

### More US public-record lead data by Quarrylane Data

| Actor | What you get |
|---|---|
| [NYS Contract Reporter Bids & RFPs](https://apify.com/quarrylane-data/nys-contract-reporter-bids-scraper) | New York State government bids, RFPs, RFQs and grants with due dates and links |
| [US Contractor License Leads (9 states)](https://apify.com/quarrylane-data/us-contractor-license-leads) | Official contractor licences from 9 state registries with phone, address and status |
| [MWBE, DBE & Diversity-Certified Business Leads](https://apify.com/quarrylane-data/us-diversity-certified-business-leads) | Officially certified minority, women-owned and disadvantaged businesses |
| [Texas TDLR Contractor License Leads](https://apify.com/quarrylane-data/texas-tdlr-contractor-license-leads) | Texas TDLR licence holders (HVAC, electricians and more) with phone and address |
| [NPPES NPI New Provider Leads](https://apify.com/quarrylane-data/nppes-npi-new-provider-leads) | Newly registered medical practices and providers from the official CMS NPI file |
| [FMCSA New Authority Leads](https://apify.com/quarrylane-data/fmcsa-new-authority-leads) | Newly granted USDOT / MC trucking authorities with carrier census details |
| [EPA Enforcement Case Leads](https://apify.com/quarrylane-data/epa-enforcement-case-leads) | EPA and state environmental enforcement cases with penalties and facilities |
| [OCC Bank Applications Monitor](https://apify.com/quarrylane-data/occ-bank-applications-monitor) | OCC bank charter, branch, merger and control applications |
| [Federal Reserve Bank M\&A Applications](https://apify.com/quarrylane-data/fed-bank-holding-company-applications) | Federal Reserve bank holding company formation, acquisition and merger filings |

# Actor input Schema

## `daysBack` (type: `integer`):

Used when startDate is empty. Default 30 days. Combined with dateType (default: new awards only).

## `startDate` (type: `string`):

Inclusive start of the search window. Earliest supported by this API is 2007-10-01. Defaults to daysBack ago.

## `endDate` (type: `string`):

Inclusive end of the search window. Defaults to today.

## `dateType` (type: `string`):

USASpending date_type. Default new_awards_only so you get newly awarded primes, not modifications of old mega-contracts. Large agencies such as DoD post few brand-new primes in a 30-day window; use last_modified_date for a high-volume daily feed of awards that changed.

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

Default: prime contracts (A, B, C, D). Add IDVs if you also want indefinite-delivery vehicles. You can also pass official type codes.

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

Official USASpending toptier names (e.g. 'Department of Defense') or common abbreviations (DoD, VA, HHS, GSA, DHS, NASA, EPA).

## `naics` (type: `array`):

6-digit NAICS industry codes, e.g. '238220' or '541512'.

## `psc` (type: `array`):

Product or Service Codes, e.g. 'D399' or 'Z1AZ'.

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

Two-letter US state codes for place of performance, e.g. 'TX', 'VA', 'CA'.

## `recipientStates` (type: `array`):

Two-letter US state codes for the recipient's location (where the winner is based).

## `minAmount` (type: `number`):

Skip awards smaller than this amount in USD. Example: 100000 for awards of $100k or more.

## `maxAmount` (type: `number`):

Skip awards larger than this amount in USD. Leave empty for no upper limit.

## `keyword` (type: `string`):

USASpending keyword filter (description and related text), e.g. 'cybersecurity' or 'janitorial'.

## `recipient` (type: `string`):

Search the official recipient name / UEI field.

## `onlyNew` (type: `boolean`):

Remembers every award delivered (and, on the first run, every other current match in the window) under the monitor key. Later scheduled runs return and charge only new awards. A first run over a wide 30-day window can take several minutes while it seeds IDs; narrow filters or raise the run timeout if needed.

## `monitorName` (type: `string`):

Label for this saved monitor (plain text, not a password or API key). When "Only new" monitor mode is on, the Actor remembers which records it has already delivered under this name and returns only new ones next time. Use a different name per filter set or client, for example "client-a-weekly". Older inputs that use monitorKey still work.

## `maxItems` (type: `integer`):

Upper limit of awards to return (Free Apify plan: 15 per run). Default 25 is a cheap, auto-test-safe sample. A full 30-day national window can contain tens of thousands of new primes.

## Actor input object example

```json
{
  "daysBack": 30,
  "dateType": "new_awards_only",
  "awardTypes": [
    "contracts"
  ],
  "onlyNew": false,
  "monitorName": "default",
  "maxItems": 25
}
```

# Actor output Schema

## `results` (type: `string`):

Prime award records (recipient, UEI, amount, agency, NAICS, place of performance, dates and USASpending URL).

# 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 = {
    "awardTypes": [
        "contracts"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("quarrylane-data/usaspending-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 = { "awardTypes": ["contracts"] }

# Run the Actor and wait for it to finish
run = client.actor("quarrylane-data/usaspending-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 '{
  "awardTypes": [
    "contracts"
  ]
}' |
apify call quarrylane-data/usaspending-federal-contract-awards --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,quarrylane-data/usaspending-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/piFaw8gb88UZfvP0D/builds/wPWrtDH8zgIMv935Y/openapi.json
