{ "openapi": "3.0.1", "info": { "title": "US Federal Contracts Finder (SAM.gov + USAspending)", "description": "Find open SAM.gov contract opportunities and past federal awards by keyword, NAICS, PSC, agency and set-aside. Daily only-new alerts. No API key needed.", "version": "0.1", "x-build-id": "iViy9i0QnyT8B6ASK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unhampered_dolly~us-federal-contracts-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unhampered_dolly-us-federal-contracts-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/unhampered_dolly~us-federal-contracts-finder/runs": { "post": { "operationId": "runs-sync-unhampered_dolly-us-federal-contracts-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/unhampered_dolly~us-federal-contracts-finder/run-sync": { "post": { "operationId": "run-sync-unhampered_dolly-us-federal-contracts-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": { "mode": { "title": "Mode", "enum": [ "opportunities", "awards" ], "type": "string", "description": "What to search. 'awards' (main feature, fully tested) uses the public USAspending.gov API and needs no key. 'opportunities' is BETA and has not yet been verified with a live key. It needs your own free SAM.gov API key (10 requests/day without a SAM.gov role, 1,000/day with a role).", "default": "awards" }, "keywords": { "title": "Keywords", "type": "array", "description": "Free-text keywords (any of them).", "items": { "type": "string" } }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "e.g. 541512.", "items": { "type": "string" } }, "pscCodes": { "title": "PSC codes", "type": "array", "description": "Product/Service codes, e.g. DJ01.", "items": { "type": "string" } }, "agencies": { "title": "Agencies", "type": "array", "description": "Awards: exact top-tier agency names (e.g. 'Department of Veterans Affairs'). Opportunities: case-insensitive match on the department/sub-agency name.", "items": { "type": "string" } }, "setAside": { "title": "Set-aside", "enum": [ "", "SBA", "8A", "WOSB", "EDWOSB", "SDVOSBC", "HZC" ], "type": "string", "description": "Small-business set-aside type.", "default": "" }, "placeOfPerformanceState": { "title": "Place of performance state", "type": "string", "description": "Two-letter US state code, e.g. VA." }, "postedFrom": { "title": "Posted / action date from", "type": "string", "description": "YYYY-MM-DD. Default: 30 days ago (opportunities) or 1 year ago (awards)." }, "postedTo": { "title": "Posted / action date to", "type": "string", "description": "YYYY-MM-DD. Default: today." }, "activeOnly": { "title": "Active opportunities only", "type": "boolean", "description": "Opportunities mode: skip archived/inactive notices.", "default": true }, "maxItems": { "title": "Max results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum results to output.", "default": 100 }, "onlyNew": { "title": "Only new since last run", "type": "boolean", "description": "Skip results already output by a previous run with the same state store. Schedule daily for alerts.", "default": false }, "stateStoreName": { "title": "State store name", "type": "string", "description": "Named key-value store that remembers seen IDs for onlyNew.", "default": "us-federal-contracts-state" }, "samApiKey": { "title": "SAM.gov API key (required for opportunities)", "type": "string", "description": "BETA, opportunities mode only. Your own free SAM.gov public API key (sam.gov, Account Details page). Required for opportunities mode, because SAM.gov's Terms of Use allow automated access only through its official API. Limits: 10 requests/day for a non-federal account with no SAM.gov role, 1,000/day with a role. Each request returns up to 1,000 notices. This mode has not yet been verified with a live key." } } }, "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 } } } } } } } } } }