{ "openapi": "3.0.1", "info": { "title": "SAM.gov Contract Opportunities + Award History", "description": "Search federal contract opportunities on SAM.gov with your own free API key, then add USASpending.gov award history (incumbents, award counts, typical award sizes) to each result. Returns clean, flat records and can return only new notices on each run.", "version": "0.1", "x-build-id": "f71k6WZl1IUtoghEZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tali-works~sam-gov-opportunities-award-history/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tali-works-sam-gov-opportunities-award-history", "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/tali-works~sam-gov-opportunities-award-history/runs": { "post": { "operationId": "runs-sync-tali-works-sam-gov-opportunities-award-history", "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/tali-works~sam-gov-opportunities-award-history/run-sync": { "post": { "operationId": "run-sync-tali-works-sam-gov-opportunities-award-history", "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": { "samApiKey": { "title": "SAM.gov API key", "type": "string", "description": "Your own free public API key from SAM.gov (Account Details > Public API Key). Stored encrypted. Strongly recommended: without it the Actor runs in a limited demo mode (max 3 results, last 7 days, one query). See README." }, "keywords": { "title": "Keywords (title search)", "type": "array", "description": "Each keyword runs a separate SAM.gov title search; results are de-duplicated by notice ID. Leave empty to search all titles.", "items": { "type": "string" } }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "6-digit NAICS codes, e.g. 541512. Each code is a separate query (SAM.gov accepts one NAICS per request).", "items": { "type": "string" } }, "state": { "title": "Place of performance state", "type": "string", "description": "Two-letter state code, e.g. VA." }, "setAside": { "title": "Set-aside type", "enum": [ "", "SBA", "SBP", "8A", "8AN", "HZC", "HZS", "SDVOSBC", "SDVOSBS", "WOSB", "WOSBSS", "EDWOSB", "EDWOSBSS", "VSA", "VSS", "IEE", "ISBEE", "BICiv", "LAS" ], "type": "string", "description": "SAM.gov set-aside code.", "default": "" }, "postedFrom": { "title": "Posted from", "type": "string", "description": "YYYY-MM-DD. Defaults to 30 days ago. SAM.gov allows at most a 1-year range." }, "postedTo": { "title": "Posted to", "type": "string", "description": "YYYY-MM-DD. Defaults to today." }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of opportunities to output (each is one billable result).", "default": 100 }, "includeAwardHistory": { "title": "Include award history (USASpending)", "type": "boolean", "description": "For each opportunity's NAICS + agency, fetch recent comparable contract awards from USASpending.gov and add summary fields.", "default": true }, "awardHistoryYears": { "title": "Award history lookback (years)", "minimum": 1, "maximum": 10, "type": "integer", "description": "How far back to look for comparable awards.", "default": 3 }, "onlyNewSinceLastRun": { "title": "Only new since last run", "type": "boolean", "description": "Skip notice IDs already output by previous runs (tracked in a named key-value store).", "default": false }, "stateStoreName": { "title": "Seen-IDs store name", "type": "string", "description": "Named key-value store used by 'Only new since last run'. Use different names to keep separate watchlists.", "default": "sam-gov-seen-notices" } } }, "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 } } } } } } } } } }