{ "openapi": "3.0.1", "info": { "title": "SAM.gov Contract Opportunities - Federal Contracts Lookup", "description": "US federal contract opportunities from SAM.gov (85K+ live notices): solicitations, presolicitations, sources sought, awards and special notices across every agency. Filter by keyword, agency, NAICS, set-aside or state; look up one notice; see what changed; or count the market. No API key.", "version": "0.0", "x-build-id": "hoFZ1rJimfnJ4scto" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/j0401~sam-gov-contracts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-j0401-sam-gov-contracts", "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/j0401~sam-gov-contracts/runs": { "post": { "operationId": "runs-sync-j0401-sam-gov-contracts", "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/j0401~sam-gov-contracts/run-sync": { "post": { "operationId": "run-sync-j0401-sam-gov-contracts", "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": [ "", "search", "notice", "changes", "aggregate" ], "type": "string", "description": "search = notices matching your filters. notice = one noticeId in full. changes = what moved since yesterday's snapshot. aggregate = counts by one dimension. Leave blank to auto-route: a noticeId looks up that notice; any filter (or newest first) returns notices; a bare request returns the market summary." }, "keyword": { "title": "Keyword", "type": "string", "description": "Free text, matched against the notice title, description and solicitation number. E.g. \"software\", \"janitorial\", \"MRI\"." }, "noticeId": { "title": "Notice ID", "type": "string", "description": "Exact SAM notice id (32 hex chars), e.g. \"e54059f8ba714ac7805c86a5708db032\". Returns that notice in full." }, "solicitationNumber": { "title": "Solicitation number", "type": "string", "description": "The agency's own solicitation number, e.g. \"1232SA26P0430\". Substring match." }, "noticeType": { "title": "Notice type", "enum": [ "", "Combined Synopsis/Solicitation", "Solicitation", "Award Notice", "Presolicitation", "Special Notice", "Sources Sought", "Justification", "Modification/Amendment/Cancel", "Justification and Approval (J&A)", "Sale of Surplus Property", "Consolidate/(Substantially) Bundle" ], "type": "string", "description": "Blank = all. \"Solicitation\" and \"Combined Synopsis/Solicitation\" are the ones actually asking for bids; \"Award Notice\" is a contract already placed." }, "department": { "title": "Agency / department", "type": "string", "description": "Top-level department, substring, e.g. \"DEPT OF DEFENSE\", \"VETERANS AFFAIRS\", \"HOMELAND SECURITY\". Use office to narrow to a contracting office (e.g. \"DLA LAND AND MARITIME\")." }, "office": { "title": "Contracting office", "type": "string", "description": "The specific contracting office, substring, e.g. \"DLA LAND AND MARITIME\", \"CDC\"." }, "naicsCode": { "title": "NAICS code", "type": "string", "description": "2-6 digits. A short prefix matches the whole sector: \"54\" = professional/technical services, \"23\" = construction, \"33\" = manufacturing. \"541511\" matches exactly." }, "setAside": { "title": "Set-aside code", "enum": [ "", "SBA", "SDVOSBC", "WOSB", "EDWOSB", "8A", "HZC", "SBP", "ISBEE", "IEE", "VSA", "NONE" ], "type": "string", "description": "Small-business set-aside program. SBA = total small business; SDVOSBC = service-disabled veteran-owned; WOSB / EDWOSB = women-owned; 8A = 8(a); HZC = HUBZone; SBP = partial small business; NONE = no set-aside used. Blank = all." }, "state": { "title": "Place of performance state", "type": "string", "description": "Two-letter state of the work, e.g. \"TX\", \"VA\". Matches only notices that carry a place of performance." }, "postedFrom": { "title": "Posted on or after", "type": "string", "description": "YYYY-MM-DD." }, "postedTo": { "title": "Posted on or before", "type": "string", "description": "YYYY-MM-DD." }, "deadlineFrom": { "title": "Response deadline on or after", "type": "string", "description": "YYYY-MM-DD. Use with a keyword to find work you can still bid on." }, "deadlineTo": { "title": "Response deadline on or before", "type": "string", "description": "YYYY-MM-DD." }, "openOnly": { "title": "Still open only", "type": "boolean", "description": "Only notices whose response window is still ahead and which have not been awarded.", "default": false }, "awardedOnly": { "title": "Awarded only", "type": "boolean", "description": "Only notices that carry an award (awardee / award number present).", "default": false }, "groupBy": { "title": "Aggregate by", "enum": [ "", "department", "subTier", "state", "contractingState", "type", "setAside", "naics2", "postedMonth" ], "type": "string", "description": "For mode=aggregate. department / subTier = who is buying; state = place of performance (matches the state filter); contractingState = where the buying office sits; type = notice kind; setAside = small-business programs; naics2 = NAICS sector; postedMonth = notice volume by month. Blank = department." }, "aggregate": { "title": "Aggregate instead of rows", "type": "boolean", "description": "Turn on to return one summary row per group instead of individual notices.", "default": false }, "newestFirst": { "title": "Newest first", "type": "boolean", "description": "Sort matches by posted date, newest first. On its own (no other filter) it still returns notices - the newest in the register - rather than the aggregate summary.", "default": false }, "maxResults": { "title": "Max notices", "minimum": 0, "type": "integer", "description": "Cap the notices pushed (0 = a ceiling of 200; hard maximum 5000).", "default": 200 } } }, "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 } } } } } } } } } }