{ "openapi": "3.0.1", "info": { "title": "SAM.gov Contract Opportunities Scraper", "description": "Scrape U.S. federal contract opportunities from SAM.gov by keyword, NAICS, notice type, set-aside and state: deadlines, agency, NAICS, PSC, place of performance and awards. Every notice matches your filters. No personal contact data. Incremental mode. $2.50 per 1,000 notices.", "version": "1.0", "x-build-id": "qUQq1duNmOUoDPBsq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/radar-scraper~sam-gov-opportunities/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-radar-scraper-sam-gov-opportunities", "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/radar-scraper~sam-gov-opportunities/runs": { "post": { "operationId": "runs-sync-radar-scraper-sam-gov-opportunities", "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/radar-scraper~sam-gov-opportunities/run-sync": { "post": { "operationId": "run-sync-radar-scraper-sam-gov-opportunities", "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": { "keywords": { "title": "Keywords", "type": "string", "description": "Words to search, with alternatives separated by commas (e.g. \"janitorial, custodial, housekeeping\" or \"cloud software\"). Every notice delivered contains ALL the words of at least one alternative in its title or description; SAM.gov's search also returns synonyms and unrelated notices, which are dropped and not charged. Leave empty to search by NAICS, notice type or set-aside only." }, "keywordsIn": { "title": "Match keywords in", "enum": [ "auto", "title", "titleOrDescription" ], "type": "string", "description": "Auto (default): title only, or title or description when you give NAICS codes. Title only: every notice has your keywords in its title. Title or description: broader coverage, best combined with NAICS codes; may include notices that only mention your keyword (e.g. a drone order that must meet \"cybersecurity\" standards). Title matches always come first.", "default": "auto" }, "postedWithinDays": { "title": "Posted in the last N days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Optional. Only notices posted in the last N days (e.g. 30 for last month's award notices)." }, "noticeTypes": { "title": "Notice types", "type": "array", "description": "Types of notice to include.", "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 (J&A)", "Intent to Bundle Requirements", "Sale of Surplus Property" ] }, "default": [ "o", "k", "p", "r" ] }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "Optional NAICS codes (2 to 6 digits, e.g. 541511). A notice is delivered when its NAICS starts with one of them.", "default": [], "items": { "type": "string" } }, "setAside": { "title": "Set-aside", "enum": [ "SBA", "SBP", "8A", "8AN", "HZC", "HZS", "SDVOSBC", "SDVOSBS", "WOSB", "WOSBSS", "EDWOSB", "EDWOSBSS", "VSA", "VSS", "IEE", "ISBEE" ], "type": "string", "description": "Optional small-business set-aside." }, "placeOfPerformanceState": { "title": "Place of performance (state)", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Optional two-letter U.S. state code (e.g. TX)." }, "activeOnly": { "title": "Active notices only", "type": "boolean", "description": "Only notices that are still open.", "default": true }, "includeDetails": { "title": "Include details", "type": "boolean", "description": "Read each notice's detail record: NAICS, PSC, set-aside, place of performance, award and the full description. Always on when filtering by NAICS, set-aside or state, because those filters are verified on the detail.", "default": true }, "maxItems": { "title": "Max notices", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of notices to return and charge.", "default": 50 }, "incrementalMode": { "title": "Incremental mode (only new notices)", "type": "boolean", "description": "Skip notices delivered by a previous run of the same search: they are not returned and not charged.", "default": false }, "stateKey": { "title": "Incremental history key (optional)", "type": "string", "description": "Optional name for the incremental history." }, "resetIncrementalState": { "title": "Reset incremental history", "type": "boolean", "description": "Delete the incremental history and start over.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Apify datacenter proxies by default." } } }, "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 } } } } } } } } } }