# USAspending Scraper: Federal Contract Awards & Recompete Finder (`pandadad0214/federal-contract-finder`) Actor Use this to find US federal contract awards and contracts ending soon (recompete leads) from USAspending.gov. Input: keywords, NAICS, PSC, agency, state or set-aside. Output: one row per contract with incumbent, UEI, amount, agency, end date and link, plus top competitors. - **URL**: https://apify.com/pandadad0214/federal-contract-finder.md - **Developed by:** [Panda Federation](https://apify.com/pandadad0214) (community) - **Categories:** Lead generation, Business - **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. 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 ## USAspending Scraper: Federal Contract Awards & Recompete Finder > **USAspending scraper** on Apify: search US federal contract awards by keyword, NAICS, PSC, agency, state or set-aside, find the contracts that end in the next few months (**recompete radar**), and see the top incumbents, exported to Excel, CSV and JSON. Apify's free plan includes $5 of monthly platform credit, enough for roughly 2,500 contracts at $0.002 each (pricing below). **Find who wins federal contracts in your market and which ones are coming up for renewal. Get one clean row per contract with the incumbent, UEI, award amount, agency, NAICS / PSC codes, period of performance and official link, plus a ranked list of top competitors, and download it as Excel or CSV.** Federal market research usually means clicking through USAspending's search screens, exporting huge zip files and cleaning them in a spreadsheet. **Federal Contract Finder** queries the **official USAspending.gov API** (public-domain data, no API key), normalizes every award into the same columns and hands you a spreadsheet you can filter, share or load into your CRM. - 🎯 **Contract awards:** definitive contracts, purchase orders, delivery orders and BPA calls with recipient, UEI, award amount, outlays, agency and sub-agency, NAICS and PSC with descriptions, place of performance, start and end dates - ⏰ **Recompete radar:** only contracts whose period of performance ends between today and the next 1 to 36 months, soonest first. These are the incumbent contracts most likely to be re-solicited on SAM.gov - 🏆 **Top recipients sheet:** incumbents ranked by total award value in your list, with their share and the agencies they serve - 🔎 **Filters that match how GovCon teams search:** keywords, NAICS (prefixes work), PSC, awarding agency or sub-agency by name or abbreviation (DOD, VA, Department of the Army), state, small-business set-aside (8(a), HUBZone, SDVOSB, WOSB…), recipient name, amount range and activity dates - 📊 **Excel + CSV export:** formatted workbook with clickable USAspending links, status colors, a search log and a read-me sheet - 🚫 **Nothing guessed:** when USAspending doesn't publish a field, the cell stays empty - 💸 **$0.002 per contract.** 500 contracts cost $1.00. Searches with no results cost nothing ### Who it's for - **Small businesses and new federal contractors:** see what agencies buy in your NAICS code, from whom and for how much, before you bid - **Capture, BD and proposal teams:** a recompete pipeline 6 to 18 months ahead, with the incumbent and contract value on every row - **GovCon consultants and Fiverr / Upwork researchers:** client-ready competitor and opportunity reports in minutes - **Analysts and journalists:** track federal spending on a topic, agency or company > Federal Contract Finder organizes public award records. It doesn't submit bids or replace SAM.gov: always confirm details on USAspending (link column) and watch SAM.gov for the actual solicitation. ### How to use the USAspending scraper 1. Click **Try for free** and pick a **mode**: *Contract awards* or *Recompete radar*. 2. Add at least one filter: **keywords**, **NAICS**, **PSC**, **agency**, **state**, **set-aside** or **recipient**. 3. For recompete radar, set the **window** in months (default 12). 4. Set **Maximum results**. You pay per returned contract, so this also caps the cost. 5. Click **Start**. Most runs finish in under a minute. Download **CONTRACTS_XLSX** or **CONTRACTS_CSV** from **Storage → Key-value store**, or use the dataset via API. #### Input examples Recompete radar: janitorial contracts in Arizona ending in the next 6 months: ```json { "mode": "recompete", "keywords": ["janitorial"], "performanceStates": ["AZ"], "recompeteMonths": 6, "maxResults": 100 } ``` Contract awards: newest VA IT awards under service-disabled veteran-owned set-asides: ```json { "mode": "awards", "naicsCodes": ["541512"], "agencies": ["VA"], "setAsides": ["SDVOSBC"], "sortBy": "newest", "maxResults": 50 } ``` ### Output example ![Example output table from a real federal-contract-finder run](https://api.apify.com/v2/key-value-stores/0eeXxTD8eJjgE6yTA/records/shot-federal-contract-finder) One row per contract. A real row from the recompete example above: ```json { "rank": 1, "awardId": "36C77025C0001", "recipientName": "BEACON GROUP, INC.", "recipientUei": "Z7FVTAZGKX52", "amount": 907447.56, "awardingAgency": "Department of Veterans Affairs", "awardingSubAgency": "Department of Veterans Affairs", "contractType": "Definitive Contract", "naicsCode": "561720", "naicsDescription": "Janitorial services", "pscCode": "S201", "description": "Janitorial services at the tucson cmop", "startDate": "2024-11-14", "endDate": "2026-11-13", "monthsLeft": 0.4, "status": "ending within 12 months", "performanceState": "AZ", "url": "https://www.usaspending.gov/award/CONT_AWD_36C77025C0001_3600_-NONE-_-NONE-", "agentSummary": "36C77025C0001: BEACON GROUP, INC. won $907.4K from Department of Veterans Affairs; NAICS 561720; ends 2026-11-13 (0.4 months left); performed in AZ; Janitorial services at the tucson cmop" } ``` #### Fields | Field | What it is | |---|---| | `awardId`, `contractType` | PIID / award ID and type (definitive contract, purchase order, delivery order, BPA call) | | `recipientName`, `recipientUei`, `recipientUrl` | The incumbent company, its SAM.gov Unique Entity ID and its USAspending profile | | `amount`, `outlays` | Total obligated award amount and outlays reported so far (USD) | | `awardingAgency`, `awardingSubAgency` | Department and sub-agency that awarded it | | `naicsCode` / `naicsDescription`, `pscCode` / `pscDescription` | Industry and product/service codes | | `description` | The award description as published | | `startDate`, `endDate`, `monthsLeft`, `status` | Period of performance; months until it ends; active / ending within 12 months / ended | | `firstObligationDate`, `lastModified` | First obligation and last change dates | | `performanceState`, `performanceZip` | Where the work is done | | `url` | USAspending award page | | `agentSummary` | One plain-English line per contract | #### Files in the key-value store | Key | What it is | |---|---| | `CONTRACTS_XLSX` | Excel workbook: all contracts with clickable links, a **Top recipients** sheet, a **Search log** sheet and a **Read me** sheet | | `CONTRACTS_CSV` | Same table as CSV (UTF-8, opens cleanly in Excel) | | `SUMMARY` | JSON: your filters, counts, total value, top recipients, a one-line `takeaway` and `nextStep` | ### For AI agents Use this Actor to find US federal contract awards, incumbents and contracts ending soon (recompete leads). Call it with Apify's MCP server (`https://mcp.apify.com`, tool `call-actor`, Actor `pandadad0214/federal-contract-finder`) or the API (`POST https://api.apify.com/v2/acts/pandadad0214~federal-contract-finder/run-sync-get-dataset-items`). Minimal input: ```json {"mode": "recompete", "naicsCodes": ["541512"], "recompeteMonths": 12, "maxResults": 20} ``` Each dataset item includes: - `agentSummary`: one line, e.g. `FA487726F0034: J.P. INDUSTRIES, INC. won $1.9M from Department of the Air Force; NAICS 561720; ends 2026-11-30 (1.0 months left); performed in AZ; ...` - `awardId`, `recipientName`, `recipientUei`: what and who - `amount`: USD; `endDate`, `monthsLeft`, `status`: when it ends - `awardingAgency`, `naicsCode`, `pscCode`, `url`: context and link The run's key-value store has a `SUMMARY` record with `returned`, `totalAmount`, `endingWithin12Months`, `topRecipients`, a one-line `takeaway` and `nextStep` (the suggested follow-on tool). Every input field has a description with formats, units and limits. Errors (for example an unknown agency name) fail fast with a plain-English status message and no charge. ### USAspending scraper pricing and free results **Apify paid-plan discounts:** Bronze members pay 10% less, Silver 20% less and Gold 30% less per contract. Free-plan prices are shown below; the discount applies automatically. **$0.002 per contract** returned to the dataset (pay-per-event), plus a tiny Actor-start fee of $0.00005. Excel, CSV, the top-recipients sheet and the search log are included. Runs that find nothing cost nothing beyond the start fee. Your **maximum charge per run** is respected. ### FAQ **Is there a free way to try this USAspending scraper?** Yes. Apify's free plan includes $5 of monthly platform credit, enough for roughly 2,500 contracts at $0.002 each. **Is this data official?** Yes. Every row comes from the public USAspending.gov API run by the US Treasury, which republishes FPDS contract data. Federal Contract Finder is not affiliated with or endorsed by any US government agency. **How does the recompete radar work?** It scans awards that had contract activity in your date range (default: the last 36 months), keeps the ones whose current period of performance ends between today and your window, and sorts them soonest first. Options may extend a contract, so treat the end date as the current end, not a guarantee. **Does it show open solicitations?** No. Open bids live on SAM.gov, which needs your own API key. Use this tool to know the incumbent, the value and the timing, then watch SAM.gov for the solicitation. **How fresh is it?** Every run queries USAspending live. USAspending updates daily, but DoD contract data is published with a delay of about 90 days. **Can I use it from code or an AI agent?** Yes, via the Apify API, the Python/JS clients, or as a tool through Apify's MCP server. ### More Panda Federation tools - [Grants Finder](https://apify.com/pandadad0214/grants-finder) - [NPI Provider Lists](https://apify.com/pandadad0214/npi-provider-lists) - [PDF Table Extractor](https://apify.com/pandadad0214/pdf-table-extractor) - [Researcher & Expert Finder](https://apify.com/pandadad0214/researcher-expert-finder) - [Reference Checker](https://apify.com/pandadad0214/reference-checker) - [Academic Research MCP Server](https://apify.com/pandadad0214/panda-research-mcp) [All Panda Federation Actors on Apify](https://apify.com/pandadad0214) Questions or a custom data feed? Open an issue on this Actor's **Issues** tab. ### Changelog - **2026-11-01:** First public release: contract awards and recompete radar modes, top recipients sheet, Excel/CSV exports, agent-friendly `agentSummary` and `takeaway`, pay-per-event pricing with Bronze/Silver/Gold discounts. # Actor input Schema ## `mode` (type: `string`): Contract awards = awards that match your filters, sorted as you choose. Recompete radar = only contracts whose period of performance ends between today and the number of months below (incumbent contracts likely to be re-solicited), soonest first. ## `keywords` (type: `array`): Words to find in the award description, recipient or codes, e.g. cybersecurity, janitorial, drone. Each keyword at least 3 characters; rows matching any keyword are returned. At least one filter (keywords, NAICS, PSC, agency, recipient, state or set-aside) is required. ## `maxResults` (type: `integer`): You pay per returned contract, so this also caps the cost. Whole number, 1 to 5,000; default 100. ## `recompeteMonths` (type: `integer`): Recompete radar only: keep contracts that end within this many months from today. Whole number, 1 to 36; default 12. ## `naicsCodes` (type: `array`): Optional. 2 to 6 digit NAICS industry codes; a prefix covers all codes under it (5415 = computer systems design). Examples: 541512 IT services, 561720 janitorial, 236220 commercial construction. ## `pscCodes` (type: `array`): Optional. Product and Service Codes (what was bought), e.g. D399 other IT, R425 engineering support, S201 custodial. ## `agencies` (type: `array`): Optional. Department or sub-agency by name or abbreviation, e.g. DOD, VA, GSA, DHS, Department of the Army, Missile Defense Agency, Forest Service. ## `performanceStates` (type: `array`): Optional. 2-letter US state codes where the work is done, e.g. AZ, TX, DC. ## `setAsides` (type: `array`): Optional. Only awards made under these small-business set-asides. ## `recipientNames` (type: `array`): Optional. Company names or UEIs to look up a competitor's or partner's contracts, e.g. Booz Allen. ## `contractTypes` (type: `array`): Optional. Default: all four prime contract types. ## `dateFrom` (type: `string`): Optional. 2024, 2024-06 or 2024-06-30. Awards with a contract action (signed or modified) on or after this date. Default: 24 months ago (36 months in recompete mode). Earliest 2007-10-01. ## `dateTo` (type: `string`): Optional. 2026, 2026-09 or 2026-09-30. Default: today. ## `minAmount` (type: `integer`): Optional. Whole number, 0 or more USD. ## `maxAmount` (type: `integer`): Optional. Whole number, 0 or more USD. ## `sortBy` (type: `string`): Largest awards first, newest start date first, latest end date first, or most recently modified first. Recompete radar always sorts by end date, soonest first. ## Actor input object example ```json { "mode": "awards", "keywords": [ "cybersecurity" ], "maxResults": 100, "recompeteMonths": 12, "naicsCodes": [ "541512" ], "pscCodes": [ "S201" ], "agencies": [ "VA" ], "performanceStates": [ "AZ" ], "recipientNames": [ "Booz Allen" ], "dateFrom": "2024-10-01", "dateTo": "2026-09-30", "sortBy": "amount" } ``` # Actor output Schema ## `table` (type: `string`): No description ## `xlsx` (type: `string`): No description ## `csv` (type: `string`): No description ## `summary` (type: `string`): Run-level summary record. Agent-friendly keys: `takeaway` (one-line plain-English result of the run), `topRecipients` (incumbents by value), `nextStep` and `nextSteps` (the suggested follow-on tool and its Store 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "cybersecurity" ] }; // Run the Actor and wait for it to finish const run = await client.actor("pandadad0214/federal-contract-finder").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": ["cybersecurity"] } # Run the Actor and wait for it to finish run = client.actor("pandadad0214/federal-contract-finder").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": [ "cybersecurity" ] }' | apify call pandadad0214/federal-contract-finder --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,pandadad0214/federal-contract-finder" } } } ``` 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 ` 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/bp0C1Jz9Fn4c1rJLe/builds/mX93NZzi9Bfm9Bw3q/openapi.json