USAspending Awards Scraper: how to get Federal Contracts and Grants as JSON/CSV (API, Python, no code)
Pull recent federal contract and grant awards from USAspending.gov. This guide shows the output fields, a working input, and
Python, JavaScript and cURL code for the Actor v0iddo/usaspending-federal-awards on Apify.
Open USAspending Awards Scraper on Apify
What data you get
One row per result. Every row can be downloaded as JSON, CSV, Excel or HTML, or read through the API.
| Field | Label | Type | Example |
|---|---|---|---|
awardId | Award Id | text | W912P526FA088 |
internalId | Internal Id | text | CONT_AWD_W912P526FA088_9700_W912EK22D0006_9700 |
detailUrl | Detail Url | URL | https://www.usaspending.gov/award/CONT_AWD_W912P526FA088_9700_W912E... |
recipientName | Recipient Name | text | DRC EMERGENCY SERVICES, LLC |
recipientUei | Recipient Uei | text | KLQXF6DU7EZ6 |
awardAmount | Award Amount | number | 30093702.77 |
description | Description | text | USDA - HURRICANE HELENE DEBRIS REMOVAL SERVICES FOR THE CHEROKEE NA... |
awardingAgency | Awarding Agency | text | Department of Defense |
awardingSubAgency | Awarding Sub Agency | text | Department of the Army |
actionDate | Action Date | date | 2026-07-24 |
startDate | Start Date | date | 2026-07-27 |
endDate | End Date | date | 2027-03-24 |
lastModified | text | 2026-10-23 09:44:10 | |
pscCode | text | S208 | |
pscDescription | text | HOUSEKEEPING- LANDSCAPING/GROUNDSKEEPING | |
naicsCode | text | 562119 | |
naicsDescription | text | OTHER WASTE COLLECTION | |
placeOfPerformanceState | text | TN | |
placeOfPerformanceCountry | text | USA |
Input example
This is the input that is pre-filled on the Actor page. Change the values for your own run.
{
"maxResults": 20
}
| Input field | Type | What it does |
|---|---|---|
sinceDays | integer | Awards whose Start Date falls in the last N days. |
awardTypeCodes | array | Federal award type codes. |
keywords | array | Optional text filter. Awards whose description contains any of these words. |
agencyNames | array | Optional list of awarding agency names. |
recipientNames | array | Optional list of recipient company names. |
pscCodes | array | Optional list of 4-char PSC codes. |
naicsCodes | array | Optional list of 6-digit NAICS codes. |
stateCodes | array | Optional 2-letter US state codes filtering by place of performance. |
maxResults | integer | Hard cap to keep runs cheap. |
Output sample
Real rows from a run of the Actor. Fields that name people are left out of the sample.
[
{
"awardId": "W912P526FA088",
"internalId": "CONT_AWD_W912P526FA088_9700_W912EK22D0006_9700",
"detailUrl": "https://www.usaspending.gov/award/CONT_AWD_W912P526FA088_9700_W912EK22D0006_9700",
"recipientName": "DRC EMERGENCY SERVICES, LLC",
"recipientUei": "KLQXF6DU7EZ6",
"awardAmount": 30093702.77,
"description": "USDA - HURRICANE HELENE DEBRIS REMOVAL SERVICES FOR THE CHEROKEE NATIONAL FOREST.",
"awardingAgency": "Department of Defense",
"awardingSubAgency": "Department of the Army",
"actionDate": "2026-07-24",
"startDate": "2026-07-27",
"endDate": "2027-03-24",
"lastModified": "2026-10-23 09:44:10",
"pscCode": "S208",
"pscDescription": "HOUSEKEEPING- LANDSCAPING/GROUNDSKEEPING",
"naicsCode": "562119",
"naicsDescription": "OTHER WASTE COLLECTION",
"placeOfPerformanceState": "TN",
"placeOfPerformanceCountry": "USA"
},
{
"awardId": "W912DQ21F3052",
"internalId": "CONT_AWD_W912DQ21F3052_9700_W912DQ21D3001_9700",
"detailUrl": "https://www.usaspending.gov/award/CONT_AWD_W912DQ21F3052_9700_W912DQ21D3001_9700",
"recipientName": "ARCADIS U.S., INC.",
"recipientUei": "MNG1DTKJ1LZ3",
"awardAmount": 15727531,
"description": "ARCHITECT AND ENGINEERING SERVICES FOR PROPERTY INVESTIGATIONS AND REMEDIAL DESIGNS FOR WELSBACH/GENERAL GAS MANTLE SUPERFUND SITE IN CAM...",
"awardingAgency": "Department of Defense",
"awardingSubAgency": "Department of the Army",
"actionDate": "2021-09-02",
"startDate": "2021-09-02",
"endDate": "2027-02-28",
"lastModified": "2026-10-22 09:04:24",
"pscCode": "C219",
"pscDescription": "ARCHITECT AND ENGINEERING- GENERAL: OTHER",
"naicsCode": "541330",
"naicsDescription": "ENGINEERING SERVICES",
"placeOfPerformanceState": "NJ",
"placeOfPerformanceCountry": "USA"
}
]
Code: Python, JavaScript and cURL
Get your API token in Apify Console under Settings, then Integrations. The Actor id is v0iddo/usaspending-federal-awards.
Python (apify-client)
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run_input = {'maxResults': 20}
run = client.actor("v0iddo/usaspending-federal-awards").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
JavaScript (apify-client)
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const input = {
"maxResults": 20
};
const run = await client.actor('v0iddo/usaspending-federal-awards').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
cURL
curl -X POST "https://api.apify.com/v2/acts/v0iddo~usaspending-federal-awards/run-sync-get-dataset-items" \
-H "Authorization: Bearer YOUR_APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"maxResults": 20}'
Price
$1.70 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $1.19 per 1,000. See the pricing tab for your plan. A new Apify account gets $5 of platform credit every month.
FAQ
What data does the USAspending Awards Scraper return?
Each result is one row in an Apify dataset. Fields include awardId, internalId, detailUrl, recipientName, recipientUei, awardAmount, description, awardingAgency, and more. The table above shows every field with an example value.
How do I use the USAspending Awards Scraper from Python?
Install the apify-client package, create a client with your Apify API token, call the Actor v0iddo/usaspending-federal-awards with an input like the one above, and read the rows from the run's dataset. The Python snippet above does exactly that.
Can I use it without writing code?
Yes. Open the Actor page on Apify, fill in the input form (an example is already filled in), press Start, and download the results as JSON, CSV, Excel or HTML. You can also schedule runs there.
How much does it cost?
$1.70 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $1.19 per 1,000. A new Apify account gets $5 of platform credit every month.
How do I limit the number of results?
Set the maxResults input field to the number of results you need; the run stops there, so it also caps the cost of one run. You can also set a maximum cost for a run in the run options on Apify, and the run stops when it is reached.
Can I send the results to Google Sheets, Make, Zapier or n8n?
Yes. Apify datasets connect to Google Sheets, Slack, Make, Zapier and n8n, and a webhook can call your own service when a run finishes. You can also export the dataset as JSON, CSV or Excel.
Open USAspending Awards Scraper on Apify
Related guides
- Currency exchange rates (ECB): Latest and historical euro foreign exchange reference rates from the European Central Bank, with conversion...
- Yahoo Finance Scraper: Scrape Yahoo Finance quotes and key statistics for stocks, ETFs, indexes, crypto, currencies and futures: p...
- Steam game reviews scraper: Scrape Steam player reviews by App ID.