{ "openapi": "3.0.1", "info": { "title": "Sam Gov Opportunities Scraper", "description": "Get US federal contract opportunities from SAM.gov with NAICS, PSC, set-asides, contacts, attachments and full descriptions. Search solicitations, monitor new or amended notices, or track contracts awarded to companies and agencies. No API key or login required.", "version": "1.0", "x-build-id": "buxVn3JRMJdLI92RY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~sam-gov-opportunities-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-sam-gov-opportunities-scraper", "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/normdata~sam-gov-opportunities-scraper/runs": { "post": { "operationId": "runs-sync-normdata-sam-gov-opportunities-scraper", "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/normdata~sam-gov-opportunities-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-sam-gov-opportunities-scraper", "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": { "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Caps how many opportunity rows this run writes. Starts at 10 for a quick sample; raise it for a full run." }, "mode": { "title": "What to do", "enum": [ "search", "monitor", "awards", "lookup" ], "type": "string", "description": "Search filters the board. Monitor returns only opportunities posted or amended since a date (for scheduled daily feeds). Awards filters to award notices. Look up takes exact notice ids.", "default": "search" }, "keyword": { "title": "Keyword (for Search, Monitor, Awards)", "type": "string", "description": "Full-text search across title, description, solicitation number and (for awards) awardee name." }, "naicsCodes": { "title": "NAICS codes (for Search, Monitor, Awards)", "type": "array", "description": "Industry codes, e.g. 541512 (computer systems design), 236220 (commercial building construction). A 2-digit prefix matches the whole sector.", "items": { "type": "string" } }, "noticeTypes": { "title": "Notice types (for Search, Monitor)", "uniqueItems": true, "type": "array", "description": "Restrict to these notice types. Leave empty for all.", "items": { "type": "string", "enum": [ "o", "k", "p", "r", "s", "a", "u", "i", "g" ], "enumTitles": [ "Solicitation", "Combined Synopsis/Solicitation", "Presolicitation", "Sources Sought", "Special Notice", "Award Notice", "Justification", "Intent to Bundle", "Sale of Surplus" ] } }, "setAsides": { "title": "Set-asides (for Search, Monitor)", "uniqueItems": true, "type": "array", "description": "Only opportunities with one of these small-business set-asides.", "items": { "type": "string", "enum": [ "SBA", "SBP", "8A", "8AN", "HZC", "HZS", "SDVOSBC", "SDVOSBS", "WOSB", "WOSBSS", "EDWOSB", "EDWOSBSS", "IEE", "ISBEE" ], "enumTitles": [ "Total Small Business", "Partial Small Business", "8(a)", "8(a) Sole Source", "HUBZone", "HUBZone Sole Source", "SDVOSB", "SDVOSB Sole Source", "WOSB", "WOSB Sole Source", "EDWOSB", "EDWOSB Sole Source", "Indian Economic Enterprise", "Indian Small Business EE" ] } }, "activeOnly": { "title": "Active only (for Search, Monitor)", "type": "boolean", "description": "Exclude archived and closed opportunities.", "default": false }, "fetchDetails": { "title": "Fetch full details", "type": "boolean", "description": "Add NAICS, PSC, set-aside, contracting-officer contact, place of performance, award amount and the full description. One extra request per opportunity.", "default": true }, "includeAttachments": { "title": "Include attachment links", "type": "boolean", "description": "Add the list of attached files (SOW, specs, amendments) with download URLs. One extra request per opportunity.", "default": false }, "modifiedSince": { "title": "Modified since (for Monitor)", "type": "string", "description": "ISO date (2026-09-01) or a relative window (\"2 days\", \"1 week\"). Monitor returns only opportunities posted or amended on or after this, each flagged new or modified." }, "awardee": { "title": "Awardee name (for Awards)", "type": "string", "description": "Company name to match on award notices, e.g. \"Booz Allen\". Partial, case-insensitive." }, "awardeeUei": { "title": "Awardee UEI (for Awards)", "type": "string", "description": "Exact SAM.gov Unique Entity ID of the awardee." }, "noticeIds": { "title": "Notice ids (for Look up)", "type": "array", "description": "32-character SAM.gov notice ids (from a listing's notice_id or url). Ids that do not resolve come back as an error row.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }