{ "openapi": "3.0.1", "info": { "title": "SAM.gov Contract Opportunities: Federal Bids & Awards", "description": "Search U.S. federal contract opportunities from SAM.gov's official daily data extract: RFPs, solicitations, sources sought and award notices. Filter by keyword, NAICS, PSC, set-aside, agency, state and deadline, or monitor for new notices. No API key. $0.002/result + $0.002/run.", "version": "0.2", "x-build-id": "TzbQ7bupRDzZfXiGe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/plainfold~sam-gov-contract-opportunities/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-plainfold-sam-gov-contract-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/plainfold~sam-gov-contract-opportunities/runs": { "post": { "operationId": "runs-sync-plainfold-sam-gov-contract-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/plainfold~sam-gov-contract-opportunities/run-sync": { "post": { "operationId": "run-sync-plainfold-sam-gov-contract-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": "array", "description": "Words or phrases to search for, e.g. [\"cybersecurity\", \"zero trust\"] or [\"office furniture\"]. Case-insensitive whole-word match, so \"AI\" won't match \"maintain\". By default keywords are matched in the title, the official NAICS and PSC code descriptions, and the notice summary (description with boilerplate FAR/DFARS clause text removed), so a parts notice that only cites a cybersecurity clause is not returned. Each result gets relevanceScore, matchedIn and matchedKeywords. Default: [] (no keyword filter, so every notice that passes the other filters is returned).", "default": [], "items": { "type": "string" } }, "keywordMatch": { "title": "Keyword match", "enum": [ "any", "all" ], "type": "string", "description": "\"any\" returns notices containing at least one keyword; \"all\" returns only notices containing every keyword. Default: \"any\".", "default": "any" }, "searchIn": { "title": "Search keywords in", "enum": [ "titleAndDescription", "title", "fullText" ], "type": "string", "description": "Where keywords are matched. \"titleAndDescription\" (recommended): title, official NAICS/PSC code descriptions, and the first ~2,000 characters of the description after removing boilerplate FAR/DFARS clauses and standard compliance text. \"title\": title only (fewest, most precise results). \"fullText\": also searches the complete raw description including clause text (broadest; expect unrelated notices that only cite a clause). Default: \"titleAndDescription\".", "default": "titleAndDescription" }, "excludeKeywords": { "title": "Exclude keywords", "type": "array", "description": "Skip notices that mention any of these words or phrases (matched in the same places as keywords, per searchIn), e.g. [\"construction\", \"janitorial\"]. Default: [].", "default": [], "items": { "type": "string" } }, "naicsCodes": { "title": "NAICS codes", "type": "array", "description": "NAICS industry codes, full or prefix, e.g. [\"541512\"] or [\"5415\"] (prefix \"5415\" matches 541511, 541512, 541519 and so on). A notice matches if its NAICS code starts with any entry. Default: [] (all industries).", "default": [], "items": { "type": "string" } }, "pscCodes": { "title": "PSC (product/service) codes", "type": "array", "description": "Product Service Codes (PSC), full or prefix, e.g. [\"D3\"] for IT services, [\"Z2\"] for building repair, [\"R4\"] for professional support. A notice matches if its PSC starts with any entry. Default: [] (all PSCs).", "default": [], "items": { "type": "string" } }, "setAsides": { "title": "Set-aside types", "type": "array", "description": "Only return notices with one of these set-aside codes, e.g. [\"SBA\"] for total small business, [\"8A\"], [\"HZC\"] for HUBZone, [\"SDVOSBC\"] for service-disabled veteran-owned, [\"WOSB\"]. Use [\"NONE\"] for full and open competition. Default: [] (any set-aside).", "items": { "type": "string", "enum": [ "SBA", "SBP", "8A", "8AN", "HZC", "HZS", "SDVOSBC", "SDVOSBS", "WOSB", "WOSBSS", "EDWOSB", "EDWOSBSS", "VSA", "VSS", "LAS", "IEE", "ISBEE", "BICiv", "NONE" ], "enumTitles": [ "Total Small Business", "Partial Small Business", "8(a) set-aside", "8(a) sole source", "HUBZone set-aside", "HUBZone sole source", "SDVOSB set-aside", "SDVOSB sole source", "WOSB set-aside", "WOSB sole source", "EDWOSB set-aside", "EDWOSB sole source", "Veteran-owned set-aside (VA)", "Veteran-owned sole source (VA)", "Local Area Set-Aside", "Indian Economic Enterprise", "Indian Small Business Economic Enterprise", "Buy Indian (HHS)", "No set-aside (full & open)" ] }, "default": [] }, "noticeTypes": { "title": "Notice types", "type": "array", "description": "Only return these notice types, e.g. [\"Solicitation\", \"Combined Synopsis/Solicitation\"] for biddable opportunities, [\"Sources Sought\", \"Presolicitation\"] for early pipeline, or [\"Award Notice\"] to see who won what. Default: [] (all types).", "items": { "type": "string", "enum": [ "Solicitation", "Combined Synopsis/Solicitation", "Presolicitation", "Sources Sought", "Special Notice", "Award Notice", "Justification", "Justification and Approval (J&A)", "Modification/Amendment/Cancel", "Sale of Surplus Property", "Consolidate/(Substantially) Bundle" ] }, "default": [] }, "agencies": { "title": "Agencies or offices", "type": "array", "description": "Case-insensitive text matched anywhere in the department, sub-tier or office name, e.g. [\"VETERANS AFFAIRS\"], [\"NAVFAC\"], [\"GENERAL SERVICES ADMINISTRATION\"], [\"ARMY\"]. Default: [] (all agencies).", "default": [], "items": { "type": "string" } }, "placeOfPerformanceStates": { "title": "Place of performance states", "type": "array", "description": "Two-letter U.S. state codes for the place of performance, e.g. [\"TX\", \"VA\"]. Many notices don't list a place of performance, and those are excluded when this filter is used. Default: [] (no state filter).", "default": [], "items": { "type": "string" } }, "postedWithinDays": { "title": "Posted within the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only notices posted or updated in the last N days, e.g. 7 for the past week or 1 for a daily check. 0 means no limit. Default: 0.", "default": 0 }, "postedAfter": { "title": "Posted on or after", "type": "string", "description": "Only notices posted on or after this date, format YYYY-MM-DD, e.g. \"2026-10-01\". Default: no date limit." }, "onlyOpenForResponses": { "title": "Only open for responses", "type": "boolean", "description": "If true, only notices whose response deadline is still in the future (biddable now). Notices without a deadline, including most award notices, are excluded. Default: false.", "default": false }, "deadlineWithinDays": { "title": "Response deadline within N days", "minimum": 0, "maximum": 365, "type": "integer", "description": "Only notices whose response deadline falls within the next N days, e.g. 14. 0 means no limit. Default: 0.", "default": 0 }, "minAwardAmount": { "title": "Minimum award amount (USD)", "minimum": 0, "type": "integer", "description": "For award notices: only awards of at least this many U.S. dollars, e.g. 1000000 for $1M+. 0 means no limit. Notices without an award amount are excluded when this is set. Default: 0.", "default": 0 }, "onlyNewSinceLastRun": { "title": "Only new since last run (monitoring)", "type": "boolean", "description": "Monitoring mode for scheduled runs: return only notices this monitor (see monitorName) hasn't delivered before, so you pay only for new results. The first run returns everything that matches. Default: false.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Name of the monitoring memory used when onlyNewSinceLastRun is true, e.g. \"va-cyber-daily\". Use a different name for each saved search. Default: \"default\".", "default": "default" }, "includeUpdatedNotices": { "title": "Also return updated notices", "type": "boolean", "description": "In monitoring mode, also return notices that were amended or re-posted since this monitor last delivered them (marked changeType = \"updated\"). Default: true.", "default": true }, "includeDescription": { "title": "Include description", "type": "boolean", "description": "Include the notice description as plain text in each result. Set false for smaller, cheaper-to-process output. Default: true.", "default": true }, "descriptionMaxLength": { "title": "Max description length", "minimum": 0, "maximum": 32000, "type": "integer", "description": "Trim each description to this many characters, e.g. 500 for short summaries. 0 means the full text (SAM.gov caps it at about 32,000). Default: 2000.", "default": 2000 }, "includeContacts": { "title": "Include contracting officer contacts", "type": "boolean", "description": "Add the government point(s) of contact listed on each notice (name, work email, work phone). Default: false.", "default": false }, "latestVersionOnly": { "title": "Only the latest version of each notice", "type": "boolean", "description": "SAM.gov lists every amendment as a separate notice (about 40% of raw rows are older versions). If true, you get one result per opportunity (the latest version) with a versionCount, and filters apply to that version. If false, every version is its own row. Default: true.", "default": true }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "postedDateDesc", "deadlineAsc" ], "type": "string", "description": "Result order. \"relevance\" (default): best keyword matches first (keyword in title > NAICS/PSC description > summary), ties broken newest first; with no keywords this is the same as newest first. \"postedDateDesc\": newest first. \"deadlineAsc\": soonest response deadline first (notices without a deadline last). Default: \"relevance\".", "default": "relevance" }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Maximum number of results to return; each result costs $0.002, so 100 results is about $0.20. 0 means no limit (a full export is about 50,000 unique opportunities). Default: 500.", "default": 500 } } }, "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 } } } } } } } } } }