# Federal Recompete Award Finder (`signalcrawl/federal-recompete-award-finder`) Actor Find expiring federal contract awards and incumbent vendors from USAspending, with agency, NAICS/PSC, award value, urgency scores, and CRM-ready notes. - **URL**: https://apify.com/signalcrawl/federal-recompete-award-finder.md - **Developed by:** [SignalCrawl](https://apify.com/signalcrawl) (community) - **Categories:** Lead generation, Automation, AI - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.50 / 1,000 recompete leads This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Federal Recompete Award Finder Find expiring federal contract awards and incumbent vendors from USAspending, then turn them into CRM-ready recompete leads. This Actor uses the public USAspending API to search historical federal contract awards by keyword, NAICS, PSC, award value, and end-date window. It is built for GovCon business development teams, capture managers, proposal consultants, federal sales teams, and AI agents that monitor incumbent contracts before recompetes happen. ### Why Use This Actor Most award scrapers stop at raw USAspending rows. This Actor is designed for action: it tells you which contracts are ending, who the incumbent is, how much the award is worth, and why the record should be reviewed. Use it to: - Find incumbent vendors on contracts approaching recompete. - Build GovCon prospecting lists by agency, NAICS, PSC, or keyword. - Monitor expiring cybersecurity, cloud, software, data, logistics, or professional-services awards. - Feed CRM workflows with award value, end date, urgency score, and notes. - Pair award intelligence with SAM.gov opportunities and GSA partner discovery. ### What It Extracts Each result includes: - Award ID and USAspending source URL. - Incumbent recipient name and recipient ID. - Award amount, start date, end date, and days until end. - Awarding agency and sub-agency. - Contract award type. - Description. - NAICS and PSC codes. - Place of performance country/state. - Matched keyword and filters used. - Recompete urgency score. - Incumbent value score. - Lead type. - CRM-ready note. - Dedupe key and scrape timestamp. ### Best For | Buyer | Workflow | |---|---| | GovCon BD teams | Find contracts ending soon and identify incumbent vendors. | | Capture managers | Prioritize recompete-watch targets by value and urgency. | | Proposal consultants | Discover agencies and vendors likely to need support. | | Federal sales teams | Build account lists from expiring contracts. | | Market researchers | Analyze award patterns by keyword, NAICS, PSC, and agency. | | AI agents | Feed structured award records into monitoring and alert workflows. | ### Input ```json { "keywords": ["cybersecurity"], "naicsCodes": ["541512"], "pscCodes": [], "startDate": "2025-01-01", "endDate": "2026-05-19", "endingWithinDays": 730, "includeRecentlyEndedDays": 180, "minAwardAmount": 1000000, "awardTypeCodes": ["A", "B", "C", "D"], "maxItems": 5, "maxPagesPerSearch": 1, "pageSize": 10, "sort": "Award Amount" } ```` ### Input Options | Field | Type | Description | |---|---|---| | `keywords` | array | Terms to search in award descriptions. | | `naicsCodes` | array | Optional NAICS filters such as `541512` or `541519`. | | `pscCodes` | array | Optional Product Service Code filters such as `DA01`. | | `startDate` | string | Start of the USAspending award search window. | | `endDate` | string | End of the USAspending award search window. | | `endingWithinDays` | integer | Keep awards ending in the next N days. Use `0` to disable. | | `includeRecentlyEndedDays` | integer | Also keep awards that ended recently. | | `minAwardAmount` | integer | Minimum award value in USD. | | `awardTypeCodes` | array | Contract award type codes. Defaults to `A`, `B`, `C`, `D`. | | `maxItems` | integer | Maximum unique award leads to save. | | `maxPagesPerSearch` | integer | USAspending pages to request per keyword/filter combination. | | `pageSize` | integer | Results requested per page. | | `sort` | string | Sort by `Award Amount`, `End Date`, or `Start Date`. | ### Output ```json { "platform": "usaspending.gov", "awardId": "47QFCA20F0049", "recipientName": "GENERAL DYNAMICS INFORMATION TECHNOLOGY, INC.", "recipientId": "abc", "startDate": "2025-01-01", "endDate": "2026-05-24", "daysUntilEnd": 5, "awardAmount": 399468544.63, "awardingAgency": "GENERAL SERVICES ADMINISTRATION", "awardingSubAgency": "FEDERAL ACQUISITION SERVICE", "contractAwardType": "DELIVERY ORDER", "description": "Cybersecurity and IT management support.", "placeState": "VA", "placeCountry": "USA", "naicsCode": "541512", "pscCode": "DA01", "matchedKeyword": "cybersecurity", "naicsFilter": "541512", "pscFilter": null, "leadType": "urgent_recompete_watch", "recompeteUrgencyScore": 100, "incumbentValueScore": 100, "crmNote": "GENERAL SERVICES ADMINISTRATION awarded $399,468,545 to GENERAL DYNAMICS INFORMATION TECHNOLOGY, INC. for 'cybersecurity' work; contract ends in 5 days (2026-05-24).", "dedupeKey": "CONT_AWD_47QFCA20F0049", "sourceUrl": "https://www.usaspending.gov/award/CONT_AWD_47QFCA20F0049", "sourceApiUrl": "https://api.usaspending.gov/api/v2/search/spending_by_award/", "scrapedAt": "2026-05-19T00:00:00+00:00" } ``` ### How This Is Different This is not positioned as a generic USAspending downloader. It is focused on federal recompete intelligence: - Filters for high-value awards. - Scores contracts by end-date urgency. - Scores incumbents by award value. - Creates CRM notes that a BD rep can understand quickly. - Produces stable dedupe keys for recurring monitoring. - Complements opportunity monitoring from SAM.gov instead of duplicating it. ### Common Run Patterns Cybersecurity recompetes: ```json { "keywords": ["cybersecurity", "zero trust", "SOC"], "naicsCodes": ["541512", "541519"], "minAwardAmount": 5000000, "endingWithinDays": 730, "includeRecentlyEndedDays": 180 } ``` Software and DevSecOps awards: ```json { "keywords": ["software development", "DevSecOps", "data platform"], "naicsCodes": ["541511", "541512"], "pscCodes": ["DA01"], "minAwardAmount": 10000000 } ``` Recently ended awards: ```json { "keywords": ["cloud", "cybersecurity"], "endingWithinDays": 0, "includeRecentlyEndedDays": 365, "minAwardAmount": 1000000 } ``` ### Notes And Limitations - This Actor uses public USAspending data. - USAspending award records can be delayed or corrected after initial publication. - Recompete timing is inferred from award end dates; always verify with agency procurement records before acting. - Some records may lack clean NAICS, PSC, or end-date fields. - This Actor does not access private portals, paid databases, or non-public procurement systems. ### Tested Coverage Current QA: - Synthetic unit tests for parsing, scoring, payload creation, and output normalization. - Four local smoke tests against the official USAspending API. - Cloud smoke returned real high-value award leads. # Actor input Schema ## `keywords` (type: `array`): Keywords to search in federal award descriptions. Each keyword is queried separately and deduped. ## `naicsCodes` (type: `array`): Optional NAICS filters, for example 541511, 541512, 541519, 518210. Leave empty to disable. ## `pscCodes` (type: `array`): Optional Product Service Code filters, for example DA01, R425, D399. Leave empty to disable. ## `startDate` (type: `string`): Beginning of the USAspending award search window in YYYY-MM-DD format. ## `endDate` (type: `string`): End of the USAspending award search window in YYYY-MM-DD format. ## `endingWithinDays` (type: `integer`): Keep awards ending in the next N days. Use 0 to disable future-end filtering. ## `includeRecentlyEndedDays` (type: `integer`): Also keep awards that ended in the last N days. Useful for recently recompeted or recompete-watch leads. ## `minAwardAmount` (type: `integer`): Minimum award value in USD. Use 0 to disable. ## `awardTypeCodes` (type: `array`): USAspending award type codes. A, B, C, D are contract award types. ## `maxItems` (type: `integer`): Maximum unique award leads to save across all searches. ## `maxPagesPerSearch` (type: `integer`): Maximum USAspending result pages to request for each keyword/NAICS/PSC combination. ## `pageSize` (type: `integer`): Results requested per USAspending API page. ## `sort` (type: `string`): USAspending sort field. ## Actor input object example ```json { "keywords": [ "cybersecurity", "cloud", "software development" ], "naicsCodes": [ "541512" ], "pscCodes": [], "startDate": "2024-01-01", "endDate": "2026-05-19", "endingWithinDays": 730, "includeRecentlyEndedDays": 180, "minAwardAmount": 1000000, "awardTypeCodes": [ "A", "B", "C", "D" ], "maxItems": 100, "maxPagesPerSearch": 2, "pageSize": 50, "sort": "Award Amount" } ``` # 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", "cloud", "software development" ], "naicsCodes": [ "541512" ], "pscCodes": [], "awardTypeCodes": [ "A", "B", "C", "D" ] }; // Run the Actor and wait for it to finish const run = await client.actor("signalcrawl/federal-recompete-award-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", "cloud", "software development", ], "naicsCodes": ["541512"], "pscCodes": [], "awardTypeCodes": [ "A", "B", "C", "D", ], } # Run the Actor and wait for it to finish run = client.actor("signalcrawl/federal-recompete-award-finder").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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", "cloud", "software development" ], "naicsCodes": [ "541512" ], "pscCodes": [], "awardTypeCodes": [ "A", "B", "C", "D" ] }' | apify call signalcrawl/federal-recompete-award-finder --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=signalcrawl/federal-recompete-award-finder", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Federal Recompete Award Finder", "description": "Find expiring federal contract awards and incumbent vendors from USAspending, with agency, NAICS/PSC, award value, urgency scores, and CRM-ready notes.", "version": "0.1", "x-build-id": "ARo5fjVftSf6o2q0W" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/signalcrawl~federal-recompete-award-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-signalcrawl-federal-recompete-award-finder", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/signalcrawl~federal-recompete-award-finder/runs": { "post": { "operationId": "runs-sync-signalcrawl-federal-recompete-award-finder", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/signalcrawl~federal-recompete-award-finder/run-sync": { "post": { "operationId": "run-sync-signalcrawl-federal-recompete-award-finder", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Keywords to search in federal award descriptions. Each keyword is queried separately and deduped.", "items": { "type": "string" } }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "Optional NAICS filters, for example 541511, 541512, 541519, 518210. Leave empty to disable.", "items": { "type": "string" } }, "pscCodes": { "title": "PSC codes", "type": "array", "description": "Optional Product Service Code filters, for example DA01, R425, D399. Leave empty to disable.", "items": { "type": "string" } }, "startDate": { "title": "Award search start date", "type": "string", "description": "Beginning of the USAspending award search window in YYYY-MM-DD format.", "default": "2024-01-01" }, "endDate": { "title": "Award search end date", "type": "string", "description": "End of the USAspending award search window in YYYY-MM-DD format.", "default": "2026-05-19" }, "endingWithinDays": { "title": "Ending within N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Keep awards ending in the next N days. Use 0 to disable future-end filtering.", "default": 730 }, "includeRecentlyEndedDays": { "title": "Include recently ended awards", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Also keep awards that ended in the last N days. Useful for recently recompeted or recompete-watch leads.", "default": 180 }, "minAwardAmount": { "title": "Minimum award amount", "minimum": 0, "type": "integer", "description": "Minimum award value in USD. Use 0 to disable.", "default": 1000000 }, "awardTypeCodes": { "title": "Award type codes", "type": "array", "description": "USAspending award type codes. A, B, C, D are contract award types.", "items": { "type": "string" } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum unique award leads to save across all searches.", "default": 100 }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum USAspending result pages to request for each keyword/NAICS/PSC combination.", "default": 2 }, "pageSize": { "title": "Page size", "minimum": 1, "maximum": 100, "type": "integer", "description": "Results requested per USAspending API page.", "default": 50 }, "sort": { "title": "Sort field", "enum": [ "Award Amount", "End Date", "Start Date" ], "type": "string", "description": "USAspending sort field.", "default": "Award Amount" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```