# US Federal Contracts & Grants by Company (USAspending) (`br_data_hub/us-federal-contracts`) Actor

Find US federal contracts, grants and loans won by any company, with amounts, agency, NAICS, PSC, dates and links, from official USAspending.gov data. Search many companies, keywords or agencies at once and get totals.

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

## Pricing

from $1.40 / 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.
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 Contracts & Grants by Company (USAspending)

Find **US federal contracts, grants, loans and other awards** won by any company, from **USAspending.gov**, the official source of federal spending data (DATA Act). Search **many companies at once** by name, UEI or DUNS, or search by **keyword, agency, state and NAICS code**, and get each award with its amount, agency, industry codes, dates and a direct link. Each run also saves **totals by company and by agency**.

The USAspending API is free but awkward: POST requests with nested filters, award type codes that cannot be mixed, 100 results per page and different field names for contracts and grants. This Actor turns it into a simple form or API call, for one company or a list of hundreds.

Typical uses: GovCon lead generation (who wins contracts in my NAICS?), competitor and partner research, sales prospecting, due diligence on a supplier's federal revenue, and AI agents that answer "how much has company X received from the government?".

### What you get per award

- Award ID, type (definitive contract, delivery order, grant...) and description
- Recipient name and USAspending recipient profile link
- Award amount and total outlays (USD)
- Awarding agency and sub-agency, funding agency
- NAICS and PSC codes with descriptions (contracts), assistance listing (grants)
- Start and end dates, place of performance state and country, last modified date
- Direct link to the award page on USAspending.gov

### Input

| Field | Description |
|---|---|
| `recipients` | Company names, UEIs or DUNS. Each is searched separately; results carry `searchedRecipient`. Empty = all recipients. |
| `keywords` | Words in the award text, at least 3 characters. |
| `awardType` | `contracts` (default), `idvs`, `grants`, `loans`, `direct_payments` or `other`. |
| `dateFrom`, `dateTo` | Action date range, YYYY-MM-DD. Empty = last 365 days. |
| `awardingAgency` | Top-tier agency, e.g. `Department of Defense`. |
| `states` | Place of performance, e.g. `["VA", "TX"]`. |
| `naicsCodes` | Contracts and IDVs: industry codes or prefixes. |
| `minAmount` | Minimum award amount in USD. |
| `maxItems` | Maximum awards in total, largest first (default 100). |

```json
{
  "recipients": ["Lockheed Martin", "Booz Allen Hamilton"],
  "awardType": "contracts",
  "dateFrom": "2026-01-01",
  "naicsCodes": ["5415"],
  "maxItems": 200
}
```

### Output

One dataset item per award, largest first:

```json
{
  "awardId": "N0001926C0012",
  "awardCategory": "contracts",
  "awardType": "DEFINITIVE CONTRACT",
  "recipientName": "LOCKHEED MARTIN CORPORATION",
  "recipientId": "c5f6bb6a-3c8e-8b5c-1d2a-77f0e2d9e8b3-C",
  "recipientProfileUrl": "https://www.usaspending.gov/recipient/c5f6bb6a-3c8e-8b5c-1d2a-77f0e2d9e8b3-C/latest",
  "awardAmount": 1250000000,
  "totalOutlays": 310000000,
  "description": "F-35 LIGHTNING II PRODUCTION SUPPORT",
  "startDate": "2026-01-15",
  "endDate": "2028-12-31",
  "awardingAgency": "Department of Defense",
  "awardingSubAgency": "Department of the Navy",
  "fundingAgency": "Department of Defense",
  "naicsCode": "336411",
  "naicsDescription": "AIRCRAFT MANUFACTURING",
  "pscCode": "1510",
  "pscDescription": "AIRCRAFT, FIXED WING",
  "assistanceListing": null,
  "placeOfPerformanceState": "TX",
  "placeOfPerformanceCountry": "USA",
  "lastModifiedDate": "2026-09-30 18:22:41",
  "awardUrl": "https://www.usaspending.gov/award/CONT_AWD_N0001926C0012_9700_-NONE-_-NONE-",
  "searchedRecipient": "Lockheed Martin",
  "source": "https://www.usaspending.gov"
}
```

The key-value store record `OUTPUT` has the totals of the run: number of awards and total amount, by recipient and by awarding agency.

### How much does it cost?

Pay per event: one `award` per award returned. Searches with no results and errors are free.

**$0.002 per award** (`award` event, pay per event). Charged once per award returned. Searches with no results and errors are free.

| You get | Free tier | Bronze tier (10% off) | Gold tier (30% off) |
|---|---|---|---|
| 100 awards | $0.20 | $0.18 | $0.14 |
| 1,000 awards | $2.00 | $1.80 | $1.40 |
| 10,000 awards | $20.00 | $18.00 | $14.00 |

Discounts follow your Apify subscription tier: Bronze 10%, Silver 20%, Gold and above 30%. No subscription to this Actor and no charge for platform usage: you pay only for results.
The Apify Free plan includes $5 of monthly credit, enough for about **2,500 awards** at the list price.
You can cap the cost of any run with **Maximum cost per run**; the Actor stops when it is reached.

### Data source and limits

Official public API of USAspending.gov (`api.usaspending.gov`), run by the US Department of the Treasury. Federal spending data is public domain. Amounts and dates are as reported by agencies; recent awards can take a few days to appear, and award amounts reflect the latest modification.

Limits: up to 10,000 awards per company or search (the API pages up to that point); results are sorted by award amount, largest first. Recipient search matches names, UEIs and DUNS as USAspending does, so a short name can match several companies: check `recipientName`.

### Use it via API

Run it from any language and get the results as JSON. Replace `<YOUR_API_TOKEN>` with your [Apify API token](https://console.apify.com/settings/integrations).

```bash
curl -X POST "https://api.apify.com/v2/acts/br_data_hub~us-federal-contracts/run-sync-get-dataset-items?token=<YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"recipients": ["Lockheed Martin"], "maxItems": 20}'
```

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("br_data_hub/us-federal-contracts").call(run_input={'recipients': ['Lockheed Martin'], 'maxItems': 20})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)
```

You can also schedule runs, send results to webhooks, or connect the Actor to Make, Zapier, n8n, Google Sheets and other [integrations](https://docs.apify.com/platform/integrations).

### Use it with AI agents (MCP)

This Actor is ready for AI agents: typed input and output schemas, pay-per-event pricing, limited permissions and short runs.

- **Apify MCP server:** add `https://mcp.apify.com/?tools=br_data_hub/us-federal-contracts` to Claude, ChatGPT, Cursor, VS Code or any MCP client, and the agent can call this Actor as a tool.
- **Agent frameworks:** call it from LangChain, LlamaIndex, CrewAI or the OpenAI Agents SDK through the Apify integrations, or with the API call above.
- Results come as structured JSON with stable field names, documented in the **Output** tab.

### FAQ

#### Where does the data come from?

Official public API of USAspending.gov (`api.usaspending.gov`), run by the US Department of the Treasury. Federal spending data is public domain. Amounts and dates are as reported by agencies; recent awards can take a few days to appear, and award amounts reflect the latest modification.

#### How much does it cost?

$0.002 per award. Discounts follow your Apify subscription tier: Bronze 10%, Silver 20%, Gold and above 30%. See **How much does it cost?** above for examples.

#### Do I pay for errors or empty results?

No. Charged once per award returned. Searches with no results and errors are free.

#### Can I run it on a schedule or connect it to other tools?

Yes. Use Apify schedules to run it daily or weekly, webhooks to get notified, and integrations such as Make, Zapier, n8n and Google Sheets. Everything also works through the API.

#### Can AI agents use it?

Yes. It works as a tool in the Apify MCP server and in agent frameworks, and AI agents can pay per event. See **Use it with AI agents (MCP)**.

#### Is it legal to use this data?

The Actor reads only public sources. You are responsible for how you use the data and for complying with the source's terms and with privacy laws such as GDPR.

#### I found a bug or need a feature. What should I do?

Open an issue in the **Issues** tab. We answer within 14 days, usually much sooner.

### More Actors from BR Data Hub

| Actor | What it does |
|---|---|
| [EU VAT Number Bulk Validator (from VIES data)](https://apify.com/br_data_hub/eu-vat-validator) | Bulk-check EU and Northern Ireland (XI) VAT numbers using the European Commission's public VIES service: valid |
| [LEI Lookup & Corporate Ownership Tree, from GLEIF data](https://apify.com/br_data_hub/lei-corporate-tree) | Look up companies by LEI or name in GLEIF's open Global LEI Index: legal data, direct and ultimate parent, sub |
| [Sanctions Screening: OFAC, UN, EU, UK](https://apify.com/br_data_hub/global-sanctions-screening) | Screen people and companies using data from the official OFAC SDN and Consolidated, UN Security Council, EU an |
| [US Company Financials from SEC XBRL Data (normalized)](https://apify.com/br_data_hub/sec-company-financials) | Standardized financial statements of US-listed companies, built from public SEC XBRL data: revenue, profits, E |
| [Entity Resolver & ID Crosswalk (from Wikidata data)](https://apify.com/br_data_hub/wikidata-entity-resolver) | Resolve company, brand, organization and place names to the right Wikidata entity with an explained confidence |
| [EU Public Tenders Search, from TED data](https://apify.com/br_data_hub/eu-ted-tenders) | Search European public tenders using open data from TED (Tenders Electronic Daily), the EU procurement journal |

See all our Actors at [apify.com/br_data_hub](https://apify.com/br_data_hub).

### Usar em português

Contratos, convênios (grants) e empréstimos do governo federal dos EUA ganhos por qualquer empresa, a partir do USAspending.gov, a fonte oficial. Busque várias empresas de uma vez, ou por palavra, órgão, estado e código NAICS, com valor, órgão, datas, link e totais por empresa e por órgão. Cobrança só pelos contratos retornados.

**Quanto custa:** $0.002 por resultado (`award`); 1.000 resultados saem por $2.00. Desconto pelo nível da assinatura Apify: Bronze 10%, Silver 20%, Gold ou acima 30%. Erros e consultas sem resultado não são cobrados. Use também pela API ou por agentes de IA no servidor MCP da Apify (`https://mcp.apify.com/?tools=br_data_hub/us-federal-contracts`).

# Actor input Schema

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

Company names, UEIs or DUNS to search, e.g. Lockheed Martin, Booz Allen Hamilton. Each one is searched separately and tagged in the output. Empty to search all recipients.

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

Words in the award description or other text fields, e.g. cybersecurity, cloud. At least 3 characters each.

## `awardType` (type: `string`):

Contracts (definitive contracts, purchase and delivery orders), IDVs (indefinite delivery vehicles such as GWACs and BPAs), grants, loans, direct payments or other financial assistance.

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

Start of the action date range (YYYY-MM-DD). Empty for 365 days before 'Date to'. Data starts on 2007-10-01.

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

End of the action date range (YYYY-MM-DD). Empty for today.

## `awardingAgency` (type: `string`):

Top-tier awarding agency name exactly as USAspending writes it, e.g. Department of Defense, Department of Health and Human Services. Empty for all.

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

Two-letter state codes where the work is performed, e.g. VA, TX. Empty for all.

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

Contracts and IDVs only: industry codes, e.g. 541512 (computer systems design) or a prefix like 5415.

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

Skip awards below this amount.

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

Stop after this many awards in total, largest first. You only pay for awards returned.

## Actor input object example

```json
{
  "recipients": [
    "Lockheed Martin"
  ],
  "keywords": [],
  "awardType": "contracts",
  "dateFrom": "",
  "dateTo": "",
  "awardingAgency": "",
  "states": [],
  "naicsCodes": [],
  "maxItems": 20
}
```

# Actor output Schema

## `dataset` (type: `string`):

Dataset with all results

## `files` (type: `string`):

Key-value store with the files and the OUTPUT summary of the run

# 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 = {
    "recipients": [
        "Lockheed Martin"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("br_data_hub/us-federal-contracts").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 = {
    "recipients": ["Lockheed Martin"],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("br_data_hub/us-federal-contracts").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 '{
  "recipients": [
    "Lockheed Martin"
  ],
  "maxItems": 20
}' |
apify call br_data_hub/us-federal-contracts --silent --output-dataset

```

## MCP server setup

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

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/l2cJYJLynZqrI7cxJ/builds/TqipXJrHfIRPBrAGM/openapi.json
