{ "openapi": "3.0.1", "info": { "title": "SAM.gov Contract Opportunities Watch", "description": "Scheduled monitor for US federal contract opportunities on SAM.gov. Returns only opportunities that are new or changed since your last run, filtered to your NAICS, keywords, and set-aside criteria.", "version": "0.1", "x-build-id": "jQLWMQ0AfcOvDPehM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/socosupply~sam-opportunities-watch/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-socosupply-sam-opportunities-watch", "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/socosupply~sam-opportunities-watch/runs": { "post": { "operationId": "runs-sync-socosupply-sam-opportunities-watch", "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/socosupply~sam-opportunities-watch/run-sync": { "post": { "operationId": "run-sync-socosupply-sam-opportunities-watch", "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": { "apiKey": { "title": "SAM.gov public API key (optional)", "type": "string", "description": "Your free api.sam.gov public API key. When set, the actor uses the official Get Opportunities Public API v2. When empty, it uses SAM.gov public search and opportunity detail endpoints (no key). File extract is tried first when dataSource is auto or extract." }, "dataSource": { "title": "Data source", "enum": [ "auto", "extract", "api", "search" ], "type": "string", "description": "auto = try Contract Opportunities file extract, then API key path, then public SAM.gov search. extract = file extract only. api = Get Opportunities API v2 (requires apiKey). search = SAM.gov public search API (no key).", "default": "auto" }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "Include opportunities with these NAICS codes (up to 6 digits). Empty = any NAICS.", "items": { "type": "string" } }, "pscCodes": { "title": "PSC codes", "type": "array", "description": "Product Service Code (classificationCode) filter. Empty = any PSC.", "items": { "type": "string" } }, "keywords": { "title": "Keywords", "type": "array", "description": "Match if any keyword appears in the title or description (case-insensitive).", "items": { "type": "string" } }, "setAsideTypes": { "title": "Set-aside types", "type": "array", "description": "Set-aside codes or labels (e.g. SBA, 8A, SDVOSBC). Case-insensitive partial match. Empty = any.", "items": { "type": "string" } }, "noticeTypes": { "title": "Notice types", "type": "array", "description": "Notice type codes from SAM.gov (e.g. o= Solicitation, p= Presolicitation, a= Award, r= Sources Sought, s= Special Notice). Empty = any.", "items": { "type": "string" } }, "placeOfPerformanceStates": { "title": "Place of performance (states)", "type": "array", "description": "Two-letter US state codes where work is performed. Empty = any.", "items": { "type": "string" } }, "postedFrom": { "title": "Posted within (days)", "type": "integer", "description": "Only include opportunities posted within this many days of today (UTC).", "default": 7 }, "responseDeadlineWithinDays": { "title": "Response deadline within (days)", "type": "integer", "description": "If set (>0), only include opportunities whose response deadline is between now and this many days ahead. 0 = no deadline window filter.", "default": 0 }, "maxResults": { "title": "Max results", "type": "integer", "description": "Stop after pushing this many opportunity records (0 = unlimited).", "default": 0 }, "emitAll": { "title": "Emit all matching opportunities", "type": "boolean", "description": "If true, push every opportunity matching filters (changeType will be new, updated, or unchanged). If false, only new or updated since the last run. The example input turns this on so a first run shows a sample; turn it off for scheduled monitoring.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }