# SAM.gov Government Bid & Contracts Watcher (`viralanalyzer/sam-gov-contracts-watcher`) Actor Scrapes and monitors US government contract opportunities and bids from the official SAM.gov API v2 with dynamic keyword, agency, and timeframe filtering. - **URL**: https://apify.com/viralanalyzer/sam-gov-contracts-watcher.md - **Developed by:** [viralanalyzer](https://apify.com/viralanalyzer) (community) - **Categories:** Business - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## SAM.gov Government Bid & Contracts Watcher 🇺🇸💼 **SAM.gov Government Bid & Contracts Watcher** is a premium business intelligence tool designed to monitor, filter, and extract public federal contract opportunities and government bids from the official United States **SAM.gov** registry. It allows government contractors, consulting firms, defense suppliers, and B2B sales teams to discover high-value federal bid requests in real-time. --- ### 🌟 Key Features 1. **Official API v2 Integration**: - Queries the official, stable GSA Opportunities API v2 for 100% accurate, up-to-date government bid opportunities. 2. **Zero-Configuration Demo Mode**: - If you do not have a GSA API key, the actor automatically defaults to the official open **`DEMO_KEY`** (rate-limited by IP, perfect for daily watcher checks). 3. **Bring Your Own Key (BYOC)**: - Easily paste your free public GSA API key (takes 10 seconds to generate in your SAM.gov profile) to scale to high-volume bulk scans without rate limit constraints. 4. **Rich Metadata Extraction**: - Extracts solicitation numbers, active status, direct opportunity URLs, solicitation types, deadlines, agencies, office offices, and descriptions. --- ### 💰 Pricing — Pay-Per-Event (PPE) This actor is charged dynamically based on the volume of bids delivered to you: - **$0.02 USD** per opportunity scraped (`opportunity-scraped` event). - Owner runs skip billing automatically. --- ### 📥 Input Parameters | Parameter | Type | Default | Description | | :--- | :--- | :--- | :--- | | `searchTerm` | String | `"cybersecurity"` | Keyword to filter bids (e.g. cybersecurity, cloud, cleaning). | | `status` | String | `"active"` | Active bids (`active`), archives (`inactive`), or all (`all`). | | `apiKey` | String | `""` | Optional personal GSA API key. Defaults to `DEMO_KEY` if blank. | | `maxItems` | Integer | `25` | Maximum number of opportunities to retrieve (5–500). | | `proxyConfiguration` | Object | `{"useApifyProxy": true}` | Proxy configuration. | --- ### 📤 Output Structure Each item in the dataset contains the following parsed federal contract fields: ```json { "noticeId": "a98b7c6d5e4f3a2b1c0", "title": "Tactical Cybersecurity Operations Support Services", "solicitationNumber": "FA8773-26-R-0003", "agency": "DEPT OF THE AIR FORCE", "office": "FA8773 38 CONS", "postedDate": "2026-05-24", "responseDeadLine": "2026-06-15T14:00:00-05:00", "type": "Combined Synopsis/Solicitation", "active": true, "description": "Providing on-site technical support for defensive cyber operations...", "url": "https://sam.gov/opp/a98b7c6d5e4f3a2b1c0/view", "scrapedAt": "2026-05-24T19:45:00.000Z" } ```` *** ### 🇵🇹 Versão em Português **SAM.gov Government Bid & Contracts Watcher** é uma ferramenta de inteligência de negócios para monitorar e extrair licitações e oportunidades de contratos governamentais dos EUA diretamente do portal oficial **SAM.gov**. #### Recursos: - **API Oficial v2**: Integração nativa e estável com a API da GSA para entrega de dados 100% íntegros. - **Modo Demo Zero-Config**: Utiliza a chave pública **`DEMO_KEY`** do governo americano para permitir execuções instantâneas sem qualquer chave própria. - **Bring Your Own Key**: Permite inserir sua própria chave de API gratuita para faturamentos em massa de alto volume. - **Cobrança PPE Econômica**: Apenas **$0.02 USD** por licitação entregue no Dataset. # Actor input Schema ## `searchTerm` (type: `string`): Keyword to filter contract opportunities (e.g. cybersecurity, cloud, cleaning, consulting). ## `status` (type: `string`): Filter by active bids or past archives. ## `apiKey` (type: `string`): Your official, free SAM.gov API Key. Log into SAM.gov, go to Workspace > Profile > Account Details, complete the OTP verification under Public API Key to generate/reveal your key. ## `maxItems` (type: `integer`): Maximum number of opportunities to retrieve. ## `proxyConfiguration` (type: `object`): Using a proxy is highly recommended to protect your request limits. ## Actor input object example ```json { "searchTerm": "cybersecurity", "status": "active", "maxItems": 25, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): Dataset of all results; each item follows the dataset schema. # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("viralanalyzer/sam-gov-contracts-watcher").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 = {} # Run the Actor and wait for it to finish run = client.actor("viralanalyzer/sam-gov-contracts-watcher").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 '{}' | apify call viralanalyzer/sam-gov-contracts-watcher --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=viralanalyzer/sam-gov-contracts-watcher", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "SAM.gov Government Bid & Contracts Watcher", "description": "Scrapes and monitors US government contract opportunities and bids from the official SAM.gov API v2 with dynamic keyword, agency, and timeframe filtering.", "version": "1.0", "x-build-id": "1bv7YVuCJIutHWi0A" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/viralanalyzer~sam-gov-contracts-watcher/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-viralanalyzer-sam-gov-contracts-watcher", "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/viralanalyzer~sam-gov-contracts-watcher/runs": { "post": { "operationId": "runs-sync-viralanalyzer-sam-gov-contracts-watcher", "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/viralanalyzer~sam-gov-contracts-watcher/run-sync": { "post": { "operationId": "run-sync-viralanalyzer-sam-gov-contracts-watcher", "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", "required": [ "searchTerm", "maxItems" ], "properties": { "searchTerm": { "title": "Search Term / Keyword", "type": "string", "description": "Keyword to filter contract opportunities (e.g. cybersecurity, cloud, cleaning, consulting).", "default": "cybersecurity" }, "status": { "title": "Opportunity Status", "enum": [ "active", "inactive", "all" ], "type": "string", "description": "Filter by active bids or past archives.", "default": "active" }, "apiKey": { "title": "SAM.gov API Key", "type": "string", "description": "Your official, free SAM.gov API Key. Log into SAM.gov, go to Workspace > Profile > Account Details, complete the OTP verification under Public API Key to generate/reveal your key." }, "maxItems": { "title": "Maximum Opportunities", "minimum": 5, "maximum": 500, "type": "integer", "description": "Maximum number of opportunities to retrieve.", "default": 25 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Using a proxy is highly recommended to protect your request limits.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```