# Federal Contract Winners: US Government Award Leads (`leadgenguy/federal-contract-winners`) Actor

Find companies that just won US federal contracts: name, address, UEI, award value, agency, NAICS, place of work. Official USAspending data, no login. $2 per 1,000.

- **URL**: https://apify.com/leadgenguy/federal-contract-winners.md
- **Developed by:** [Mokssh jaiin](https://apify.com/leadgenguy) (community)
- **Categories:** Lead generation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

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

## Federal Contract Winners: US Government Award Leads — $2 per 1,000

Find companies that **just won US federal government contracts**. Each result has the winning company's **name, street address, unique entity ID (UEI)**, the **award value, awarding agency and sub-agency, contract type, NAICS and PSC codes, description and place of performance**, plus a link to the official record. Data is the free, official **USAspending.gov** open data, updated daily.

A company that just won a federal contract is a company with new budget. Sell them staffing, software, insurance, equipment, subcontracting and compliance help.

### Why use it

- **Real buying signal:** government awards are public, large and recent.
- **Filters:** keywords, NAICS code, state, agency, award value, date range.
- **One lead per company:** turn thousands of awards into a clean company list with total value.
- **Cheap and stable:** $2 per 1,000, from an official API.

### Pricing

| Event | Price |
|---|---|
| Award (or company, when "one lead per company" is on) | $2 per 1,000 ($0.002 each) |
| Actor start | $0.00005 |

Free Apify accounts are limited to **25 results per run**.

### Input

```json
{ "keywords": ["cybersecurity"], "recipientStates": ["VA", "MD"], "awardedInLastDays": 30, "minAmount": 250000, "oneLeadPerCompany": true, "maxItems": 500 }
```

### Output

```json
{
  "awardId": "47QFSA20F0057",
  "recipient": { "name": "CARAHSOFT TECHNOLOGY CORP", "uei": "ABC123DEF456", "address": { "street": "11493 Sunset Hills Road", "city": "RESTON", "state": "VA", "postalCode": "20190" } },
  "amountUsd": 60490406.19, "startDate": "2026-09-28", "endDate": "2027-09-27",
  "agency": "Social Security Administration", "subAgency": "Social Security Administration",
  "awardType": "DEFINITIVE CONTRACT", "naics": { "code": "511210", "description": "SOFTWARE PUBLISHERS" },
  "description": "...", "usaspendingUrl": "https://www.usaspending.gov/award/CONT_AWD_..."
}
```

### Honest limits

- It lists **contract awards** (the main federal procurement data), not grants or loans.
- `amountUsd` is the **total value of the award** (all options and modifications), not just the amount obligated in the period.
- There are **no contact emails or phones** in this data. Use the company name and address with a website or lead enrichment Actor to find contacts.
- Data lags the real world by a few days.

### Feedback and reviews

Found a bug, or need a field or filter added? Open an issue on this Actor's **Issues** tab and it will be looked at quickly. If this Actor saved you time, a short and honest review helps other people find it. Thank you!

### Legal

US federal spending data is public domain and published by the US Treasury at USAspending.gov. You are responsible for lawful use of any contact you derive from it.

# Actor input Schema

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

Words in the award description, e.g. <code>software</code>, <code>cybersecurity</code>, <code>construction</code>.

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

Industry codes, e.g. <code>541512</code> (computer systems design) or a 2-4 digit prefix like <code>5415</code>.

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

Two-letter state codes where the winning company is located, e.g. <code>VA</code>, <code>TX</code>.

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

Exact top-level agency names, e.g. <code>Department of Defense</code>.

## `awardedInLastDays` (type: `integer`):

Ignored when 'Awarded after' is set.

## `awardedAfter` (type: `string`):

Date like <code>2026-09-01</code>.

## `awardedBefore` (type: `string`):

Date like <code>2026-10-01</code>. Default: today.

## `dateMode` (type: `string`):

New awards that started in the period, or any award with activity (modifications) in the period.

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

Skip smaller awards.

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

Skip larger awards.

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

Largest awards first, or the most recently started awards first.

## `oneLeadPerCompany` (type: `boolean`):

Return each winning company once (its biggest award), with how many awards and the total value seen in the results.

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

Free Apify plans: 25 per run.

## Actor input object example

```json
{
  "keywords": [
    "software"
  ],
  "awardedInLastDays": 30,
  "dateMode": "new",
  "sortBy": "amount",
  "oneLeadPerCompany": false,
  "maxItems": 100
}
```

# Actor output Schema

## `jobs` (type: `string`):

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

// Prepare Actor input
const input = {
    "keywords": [
        "software"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("leadgenguy/federal-contract-winners").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": ["software"] }

# Run the Actor and wait for it to finish
run = client.actor("leadgenguy/federal-contract-winners").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": [
    "software"
  ]
}' |
apify call leadgenguy/federal-contract-winners --silent --output-dataset

```

## MCP server setup

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

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/cUiLfwJipQlmzVjh4/builds/6iZjbUfda7EVDOWeq/openapi.json