# US Federal Contracts: USAspending Awards, SAM.gov Opportunities (`euroscrape/us-federal-contracts`) Actor

Contract awards USA and federal procurement data from USAspending (no key) by recipient name or UEI, agency, NAICS, state, date range, amount: US government contracts Excel, federal grants. SAM.gov opportunities and SAM.gov data (free SAM.gov key). Alerts, SAM.gov export, federal contracts export.

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

## Pricing

from $2.00 / 1,000 federal 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 Federal Contracts: USAspending Awards & SAM.gov Notices

> **For AI agents:** use this Actor for US federal contract and grant awards from USAspending (no key needed) by recipient, agency, NAICS, state, keyword, amount and dates. Minimal input: `{"daysBack": 7, "awardTypes": ["contracts"], "keywords": ["cloud"]}`. Returns one row per award with recipient (name, UEI, address), amount, agency, dates and NAICS code.

Federal contract awards, grants and loans from **USAspending.gov** (the official U.S. government spending database, open API, no key) and open **SAM.gov opportunities** (solicitations and notices, with your free SAM.gov Public API Key), as clean rows: who won what, from which agency, for how much, where, in which industry (NAICS/PSC), with the official link. Filters by keyword, agency, NAICS, PSC, state, amount and set-aside; a free summary per award family; monitoring with Slack, Telegram, Discord or webhook alerts.

### ⚡ At a glance

- **Use it when** you want **federal contract data** (government contract awards, federal procurement data, contract winners and amounts, prime recipients by agency or state) or **open federal opportunities** (SAM.gov solicitations by NAICS and state), without reading USAspending or SAM.gov by hand.
- **Minimal input**: `{ "daysBack": 7, "awardTypes": ["contracts"], "keywords": ["cloud"], "minAmount": 100000, "maxItems": 100 }`
- **Output**: one row per award: `recipientName`, `recipientUei`, `amount`, `awardingAgency`, `awardingSubAgency`, `description`, `awardType`, `naicsCode`/`naicsLabel`, `pscCode`, `placeOfPerformanceState`, recipient city/state/ZIP, `startDate`, `endDate`, `lastModified`, `url`; one row per opportunity (`title`, `noticeType`, `department`, `office`, `responseDeadline`, `daysToDeadline`, `naicsCode`, `setAside`, `url`); plus one free `summary` row per family.
- **Price**: $2 per 1,000 awards, $3 per 1,000 opportunities, plus $0.003 per run. **The first 20 rows of every run and the summary rows are free.**
- **Not for**: sub-awards (subcontractors), the full text of solicitation attachments, state and local government contracts (see the [EU Tenders Scraper](https://apify.com/euroscrape/eu-public-tenders) for Europe), or contact details of contracting officers (not returned, on purpose).
- **Look before you run**: the free [federal contracts this week](https://euroscrape.com/tools/us-federal-contracts-this-week) viewer lists a state's latest contracts in your browser and writes this Actor's input. Counts, largest contracts and top industries per state over 30 days: [federal contracts by state](https://euroscrape.com/us/federal-contracts/).

### ✨ Why this Actor

| | |
|---|---|
| 🏛️ **Official sources, no scraping of HTML** | USAspending.gov's public API (contracts, IDVs, grants, loans, direct payments) and SAM.gov's Opportunities API. Both are run by the U.S. government; the Actor reads them the way their own websites do. |
| 🔑 **No key for awards** | Awards need nothing. Opportunities need your free SAM.gov Public API Key (sam.gov → Profile → Account Details → Public API Key), used only for your run. |
| 🔎 **Filters that match how you sell** | Keywords in the description, NAICS (2 to 6 digits), PSC, awarding agency, place of performance state, recipient state, recipient name or UEI, amount range, set-aside codes (SBA, 8A, SDVOSBC, WOSB, HZC), new awards only. |
| 📊 **A free summary per family** | Count, total, median and largest amount, top agencies by count and by amount, top recipients, top states, top NAICS, for the rows you asked for. |
| 🔔 **Monitoring and alerts** | Name a monitor, schedule the Actor: every later run returns only awards and opportunities not delivered before, with Slack, Telegram, Discord or webhook messages. |
| ⚡ **Fast** | 400 contracts above $1 million, with all their fields, in 57 seconds; 142 Texas small-business awards in 9 seconds (7 Nov 2026). |
| 🧹 **Honest about delays** | USAspending publishes contract actions about 3 days after they happen; grants and loans weeks later. The Actor says when a window is too recent. |

### 🎯 Use cases

- **Business development**: every award in your NAICS and your state this week, with the winner and the agency, so you know who to team with and which offices buy what you sell.
- **Competitive intelligence**: the awards of a competitor (`recipientSearch`), by agency and over time; the small-business set-aside awards in your field.
- **Open opportunities**: the SAM.gov solicitations posted this week for your NAICS in your state, with the response deadline, in your Slack every morning.
- **Research and journalism**: the largest awards of the week, by agency and by recipient; grants to a state or a county; emergency-funded awards (DEFC codes).

### 🚀 Examples

Cloud contracts above $100,000 with an action in the last 7 days:

```json
{ "daysBack": 7, "awardTypes": ["contracts"], "keywords": ["cloud"], "minAmount": 100000, "maxItems": 100 }
```

Small-business set-aside awards performed in Texas in the last 30 days, newest first:

```json
{ "daysBack": 30, "awardTypes": ["contracts"], "states": ["Texas"], "setAsides": ["SBA"], "sortBy": "date", "maxItems": 500 }
```

IT contracts (NAICS 5415) awarded by the Department of Veterans Affairs this quarter, new awards only:

```json
{ "dateFrom": "2026-10-01", "awardTypes": ["contracts"], "naicsCodes": ["5415"], "agencies": ["Department of Veterans Affairs"], "newAwardsOnly": true, "maxItems": 1000 }
```

Awards and open opportunities for engineering services (NAICS 541330) in Virginia, with your SAM.gov key, as a daily monitor with Slack alerts:

```json
{ "daysBack": 2, "awardTypes": ["contracts"], "naicsCodes": ["541330"], "states": ["VA"], "includeOpportunities": true, "samGovApiKey": "YOUR_SAM_GOV_PUBLIC_API_KEY", "monitorName": "va-engineering", "slackWebhookUrl": "https://hooks.slack.com/services/..." }
```

### 📊 Data Report · 7 Nov 2026: the federal week in contracts

Contracts with an action between 31 Oct and 4 Nov 2026 (the latest actions USAspending had published on 7 Nov), amount at least $1 million, 400 largest:

| | |
|---|---|
| Total obligated (400 awards) | $74.6 billion |
| Median award | $26.0 million |
| Largest award | $28.0 billion, Department of Energy → Savannah River Nuclear Solutions LLC (management of the Savannah River Site) |
| Most awards | General Services Administration 56, Department of Homeland Security 49, Department of Transportation 41, Health and Human Services 41, NASA 32 |
| Most dollars | Department of Energy $31.4 billion, GSA $8.7 billion, DHS $8.5 billion, DOT $6.5 billion, NASA $4.8 billion |
| Top recipients | Savannah River Nuclear Solutions $28.0 billion, Leidos $6.2 billion, Harris Corporation $3.8 billion, Fisher Sand & Gravel $2.6 billion, AT\&T Enterprises $2.0 billion |
| Where the work is done | Virginia 69, District of Columbia 66, Maryland 37, Texas 30, California 28 |
| Top industry | NAICS 541512 Computer Systems Design Services, 46 of 400 |

Small-business set-aside (SBA) contracts performed in **Texas**, actions from 8 Oct to 4 Nov 2026: **142 awards, $156 million**, median **$54,574**. Most awards: Department of Justice 54, Veterans Affairs 16, Agriculture 13, Interior 13, NASA 13. Most dollars: NASA $104 million (one $97 million award to a Houston-area contractor), Treasury $22 million.

**SAM.gov opportunities, same week**: 6,470 notices posted between 1 and 7 Nov 2026 (all types). Narrowed to NAICS 541512 (computer systems design) and the last 7 days: 4 open solicitations, 2 of them combined synopsis/solicitations, 1 closing within a week, half with a small-business set-aside; for example a Marine Corps Education Command IT support solicitation posted 4 Nov, due 2 Dec, WOSB set-aside.

Two things to know before you query:

- **Grants lag.** A 7-day window on grants returned 0 rows on 7 Nov: assistance awards reach USAspending weeks after the action. Use 30 to 90 days for grants, loans and direct payments.
- **Set-aside is a filter, not a column.** USAspending's search API applies `setAsides` codes but does not return the set-aside type per award; the summary row records the codes you applied. SAM.gov opportunities do carry their set-aside.

### 📦 Output (a real award, Department of Health and Human Services, action of 3 Nov 2026)

```json
{
  "type": "award",
  "awardId": "75P00123F37007",
  "awardFamily": "contracts",
  "awardType": "Delivery Order",
  "recipientName": "SERVEFED INC.",
  "recipientUei": "DJS8EKA7DLZ6",
  "recipientAddress": "4539 Metropolitan Ct",
  "recipientCity": "Frederick",
  "recipientState": "MD",
  "recipientZip": "21704",
  "recipientCountry": "USA",
  "recipientCounty": "Frederick",
  "amount": 25979558.94,
  "outlays": 18046506.22,
  "description": "CLINICAL WEST OCCUPATIONAL HEALTH SUPPORT SERVICES",
  "awardingAgency": "Department of Health and Human Services",
  "awardingSubAgency": "Office of the Assistant Secretary for Administration",
  "fundingAgency": "Department of Health and Human Services",
  "startDate": "2023-09-29",
  "endDate": "2028-09-28",
  "lastModified": "2026-11-03",
  "naicsCode": "621999",
  "naicsLabel": "All Other Miscellaneous Ambulatory Health Care Services",
  "pscCode": "Q201",
  "pscLabel": "Medical- General Health Care",
  "placeOfPerformanceState": "MD",
  "url": "https://www.usaspending.gov/award/CONT_AWD_75P00123F37007_7570_75P00118D00009_7570",
  "source": "USAspending.gov"
}
```

A real SAM.gov opportunity (read with the user's key, 7 Nov 2026):

```json
{
  "type": "opportunity",
  "title": "Marine Corps Education Command Information Technology Support Services",
  "noticeType": "Solicitation",
  "department": "DEPT OF DEFENSE",
  "office": "COMMANDER",
  "postedDate": "2026-11-04",
  "responseDeadline": "2026-12-02",
  "daysToDeadline": 25,
  "naicsCode": "541512",
  "pscCode": "DG01",
  "setAside": "SBA Certified Women-Owned Small Business (WOSB) Program Set-Aside (FAR 19.15)",
  "url": "https://sam.gov/workspace/contract/opp/abb4d95176944adfa211a5832b0901cc/view",
  "source": "SAM.gov"
}
```

One free `summary` row per family closes the dataset:

```json
{
  "type": "summary", "summaryOf": "awards", "awardFamily": "contracts", "awardFamilyLabel": "Contracts",
  "period": { "from": "2026-10-31", "to": "2026-11-07" },
  "awards": 400, "totalAmount": 74636980004.59, "medianAmount": 25986675.9, "largestAmount": 27995864149.1,
  "topAwardingAgencies": [{ "name": "General Services Administration", "count": 56 }, { "name": "Department of Homeland Security", "count": 49 }],
  "topAwardingAgenciesByAmount": [{ "name": "Department of Energy", "amount": 31443056430.84 }],
  "topRecipients": [{ "name": "SAVANNAH RIVER NUCLEAR SOLUTIONS LLC", "amount": 27995864149.1 }],
  "topPlaceOfPerformanceStates": [{ "name": "Virginia", "count": 69 }, { "name": "District of Columbia", "count": 66 }],
  "topNaics": [{ "name": "541512 Computer Systems Design Services", "count": 46 }],
  "setAsideFilter": null, "source": "USAspending.gov", "note": null
}
```

### 💰 Pricing

| Event | Price |
|---|---|
| Run start | $0.003 |
| Federal award (USAspending) | $0.002 |
| SAM.gov opportunity | $0.003 |
| Summary rows | free |
| First 20 rows of every run | free |

The 400 contracts of the Data Report cost $0.76 plus $0.003 for the run. A test of 20 rows costs only the start fee. Set a maximum charge per run in the run options: the Actor stops cleanly when it is reached.

### ❓ FAQ

- **Where does the data come from?** Awards: USAspending.gov, the official database of federal spending run by the Department of the Treasury, through its public API (`api.usaspending.gov`). Opportunities: SAM.gov's Contract Opportunities API (`api.sam.gov`), run by the General Services Administration, with your own SAM.gov key. Both are U.S. government open data.
- **Why do I need a key for SAM.gov and not for USAspending?** USAspending's API is open. SAM.gov's requires a personal **SAM.gov Public API Key** (free): sign in at sam.gov with a login.gov account, open Profile → Account Details → Public API Key (one-time verification), paste it in "SAM.gov API key" (stored encrypted by Apify, used only for your run). A key from api.data.gov is **not** accepted by SAM.gov (verified 7 Nov 2026: HTTP 404). New non-federal accounts get a small daily request quota first, raised after approval. Without a key, the Actor reads the awards and tells you in the summary that SAM.gov was skipped.
- **How fresh is it?** USAspending publishes contract actions about 3 days after they happen (on 7 Nov 2026 the latest action date was 4 Nov). Grants, loans and direct payments are reported by agencies with weeks of delay: use longer windows. SAM.gov notices are available the day they are posted.
- **What does the period mean?** By default: awards with any action (new award, modification, payment) in the window. Tick "New awards only" to keep only awards whose first action is in the window (the API is slower for this: keep windows at 30 days or less).
- **Can I search one company?** Yes: `recipientSearch` takes part of the name or the UEI and returns its awards in the period.
- **Why is `placeOfPerformanceState` sometimes empty?** The work is performed abroad or the agency did not report a state (9 of the 400 largest awards on 7 Nov).
- **Are names of people included?** The Actor returns organisations (recipients) and public bodies. It never requests SAM.gov points of contact (names, e-mails, phones of contracting officers): the link opens the notice where they are published. Award descriptions are the agencies' own text and may occasionally mention a requester: they are reproduced as published.
- **Sub-awards (subcontractors)?** Not in this version. Ask through the Issues tab if you need them.
- **Why can't I filter SAM.gov by several NAICS or states at once?** SAM.gov's API takes one NAICS, one state and one set-aside per query. Awards accept lists. For several, run the Actor several times or schedule one task per NAICS.

### ⚠️ Limits, honestly

- Awards are limited to 50,000 rows per run (500 pages of the API); narrow the search with NAICS, agency or amount.
- USAspending's search applies set-aside codes as a filter but does not return the set-aside type per award.
- SAM.gov's API has a daily quota per key set by your SAM.gov account role (small for new non-federal accounts, 1,000 a day after approval); each run uses one request per 1,000 notices.
- The Actor does not download solicitation attachments or award documents.
- Loans have no award amount or start date in USAspending: for loans, `amount` is the face value of the loan (Loan Value) and `startDate` its issue date. Over 30 days, loans can return nothing: agencies report them in batches (the latest loans on 8 Nov 2026 dated from late September).

### 🔌 API, AI agents and integrations

- **API**: one call runs the Actor and returns the results, `POST https://api.apify.com/v2/acts/euroscrape~us-federal-contracts/run-sync-get-dataset-items` (see the API tab for Python, JavaScript and cURL).
- **AI agents (MCP)**: add `https://mcp.apify.com?tools=euroscrape/us-federal-contracts` to Claude, Cursor, VS Code or any MCP client, and the Actor becomes a tool your agent can call.
- **Integrations**: Slack, Telegram, Discord and webhook alerts are built in; use Apify's integrations for Google Sheets, Make, Zapier and n8n on the dataset.

### ⭐ Your feedback

If this Actor saves you time, a short review on Apify Store helps other users find it. Missing a filter or a field? Say it in your review: the most requested features are added first.

### 🧭 Related Actors

- [US New Business Filings](https://apify.com/euroscrape/us-new-companies): new LLCs and corporations from official state registers (recipients often appear there months before their first award).
- [EU Tenders Scraper](https://apify.com/euroscrape/eu-public-tenders): the European counterpart, TED and BOAMP tenders and awards.
- [Tech Stack Detector](https://apify.com/euroscrape/website-intelligence): the technologies behind a recipient's website.

Questions, missing field, wrong row: use the Issues tab; answered within a day.

# Actor input Schema

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

Awards with an action (signature, modification, payment) in the last N days. USAspending publishes contracts about 3 days after the action, grants later. Ignored if 'From date' is set.

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

First action date to include (YYYY-MM-DD). Overrides 'Days back'.

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

Last action date to include (YYYY-MM-DD). Default: today.

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

Keep only awards whose FIRST action is in the period (new contracts, not modifications of older ones). Slower on USAspending's side: use windows of 30 days or less.

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

Families of federal awards to read. One search per family.

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

Words searched by USAspending in the award description, recipient name and identifiers, e.g. cloud, cybersecurity, janitorial, drone. Also sent to SAM.gov as title words.

## `excludeKeywords` (type: `array`):

Drop rows whose description, recipient or title contains one of these words.

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

Industry codes, 2 to 6 digits, e.g. 541512 (computer systems design), 5415 (all computer services), 23 (construction).

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

Product or service codes, e.g. D302 (IT systems development), R425 (engineering support), S201 (custodial). Awards only.

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

Top-tier agency names as on USAspending, e.g. Department of Defense, Department of Veterans Affairs, General Services Administration, National Aeronautics and Space Administration.

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

Where the work is performed: two-letter codes or names, e.g. TX, Virginia, DC. Empty = everywhere.

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

Where the recipient company is registered (SAM registration address). Awards only.

## `recipientSearch` (type: `array`):

Find the awards of given companies: part of the name or the UEI, e.g. Lockheed, Booz Allen. Awards only.

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

Keep awards of at least this amount (total obligated). Awards only.

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

Keep awards up to this amount, e.g. 250000 for small purchases.

## `setAsides` (type: `array`):

Small-business set-asides, e.g. SBA (total small business), 8A, SDVOSBC (service-disabled veteran), WOSB (women-owned), HZC (HUBZone). Empty = all.

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

Order in which awards are read and delivered; matters when 'Maximum rows' cuts the list.

## `includeOpportunities` (type: `boolean`):

Adds the solicitations and notices posted on SAM.gov in the period, filtered by your keywords, NAICS (one), state (one) and set-aside (one). Requires your free SAM.gov Public API Key (see below).

## `samGovApiKey` (type: `string`):

Your personal SAM.gov Public API Key (free): sign in at sam.gov with a login.gov account, then Profile → Account Details → Public API Key (one-time verification). A key from api.data.gov does NOT work on SAM.gov. New non-federal accounts have a small daily request quota at first. Used only for the SAM.gov calls of your run.

## `noticeTypes` (type: `array`):

SAM.gov notice types to include.

## `includeSummary` (type: `boolean`):

Adds one free 'summary' row per award family (count, total and median amount, top agencies, top recipients, top states, NAICS, set-aside share) and one for opportunities.

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

Stop after this many awards and opportunities (summary rows are not counted). The first 20 rows of every run are free.

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

Give your saved search a name and schedule it: the first run is the baseline, every later run returns only awards and opportunities not delivered before (changeType: "new").

## `telegramBotToken` (type: `string`):

Get a message for each new award or opportunity. Create a bot with @BotFather and paste its token.

## `telegramChatId` (type: `string`):

Your chat or group ID (send /start to the bot first).

## `discordWebhookUrl` (type: `string`):

Channel settings → Integrations → Webhooks.

## `slackWebhookUrl` (type: `string`):

Slack app → Incoming Webhooks.

## `webhookUrl` (type: `string`):

One POST per run with {"count": N, "items": \[...]} for the new rows only.

## `maxNotifications` (type: `integer`):

Telegram, Discord and Slack messages per run (the webhook always receives everything).

## Actor input object example

```json
{
  "daysBack": 7,
  "newAwardsOnly": false,
  "awardTypes": [
    "contracts"
  ],
  "sortBy": "amount",
  "includeOpportunities": false,
  "noticeTypes": [
    "solicitation",
    "combined",
    "presolicitation"
  ],
  "includeSummary": true,
  "maxItems": 100,
  "maxNotifications": 30
}
```

# Actor output Schema

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

One row per award: recipient, amount, agencies, NAICS/PSC, dates, place of performance, official link.

## `opportunities` (type: `string`):

Open solicitations and notices: title, agency, deadline, NAICS, set-aside, link (with your SAM.gov Public API Key).

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

Per award family: count, total and median amount, top agencies, top recipients, top states, NAICS, set-aside share.

## `runSummary` (type: `string`):

Counters for this run (rows read and delivered, API calls, errors, monitor baseline).

# 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 = {
    "daysBack": 7,
    "awardTypes": [
        "contracts"
    ],
    "noticeTypes": [
        "solicitation",
        "combined",
        "presolicitation"
    ],
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("euroscrape/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 = {
    "daysBack": 7,
    "awardTypes": ["contracts"],
    "noticeTypes": [
        "solicitation",
        "combined",
        "presolicitation",
    ],
    "maxItems": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("euroscrape/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 '{
  "daysBack": 7,
  "awardTypes": [
    "contracts"
  ],
  "noticeTypes": [
    "solicitation",
    "combined",
    "presolicitation"
  ],
  "maxItems": 100
}' |
apify call euroscrape/us-federal-contracts --silent --output-dataset

```

## MCP server setup

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