{
  "openapi": "3.0.1",
  "info": {
    "title": "SAM.gov Contract Opportunities Monitor: Federal RFPs & Awards",
    "description": "US federal contract opportunities from the SAM.gov public extract: RFPs, sources sought & awards by NAICS, set-aside, state. Daily alerts, $1.50/1k. Not affiliated with or endorsed by GSA or SAM.gov.",
    "version": "1.0",
    "x-build-id": "ka7UzDZoVhYTsK3oi"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/optimistprime~federal-contract-opportunities-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-optimistprime-federal-contract-opportunities-monitor",
        "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/optimistprime~federal-contract-opportunities-monitor/runs": {
      "post": {
        "operationId": "runs-sync-optimistprime-federal-contract-opportunities-monitor",
        "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/optimistprime~federal-contract-opportunities-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-optimistprime-federal-contract-opportunities-monitor",
        "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",
              "track"
            ],
            "type": "string",
            "description": "search = filter all active US federal contract notices. track = follow specific solicitation numbers or notice IDs from presolicitation to award.",
            "default": "search"
          },
          "noticeTypes": {
            "title": "Notice types",
            "type": "array",
            "description": "Search mode. Empty = the biddable types (solicitation, combined synopsis/solicitation, presolicitation, sources sought). Pick 'award' for award notices (who won, amount).",
            "items": {
              "type": "string",
              "enum": [
                "solicitation",
                "combined",
                "presolicitation",
                "sources-sought",
                "special-notice",
                "award",
                "justification",
                "modification",
                "bundle",
                "surplus"
              ]
            },
            "default": []
          },
          "keywords": {
            "title": "Keywords (any)",
            "type": "array",
            "description": "Search mode. A notice matches if ANY keyword or phrase appears in the title (or the description, see 'Search descriptions too'). Case-insensitive, whole words. Example: cybersecurity, HVAC, \"janitorial services\".",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Exclude keywords",
            "type": "array",
            "description": "Search mode. Drop notices whose title or description contains any of these.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "searchDescriptions": {
            "title": "Search descriptions too",
            "type": "boolean",
            "description": "Match keywords against the description as well as the title. More results, more noise.",
            "default": false
          },
          "naicsCodes": {
            "title": "NAICS codes (prefix)",
            "type": "array",
            "description": "Search mode. 2 to 6 digit NAICS codes; prefixes match, so 5415 covers 541511, 541512, 541519. Example: 236220, 5415.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "pscCodes": {
            "title": "PSC / classification codes (prefix)",
            "type": "array",
            "description": "Search mode. Product and Service Codes; prefixes match. Example: D3 (IT services), Z2 (construction repair), 65 (medical supplies).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "setAsides": {
            "title": "Set-asides",
            "type": "array",
            "description": "Search mode. Empty = any (including none). SMALL_BUSINESS_ANY = every small-business set-aside type.",
            "items": {
              "type": "string",
              "enum": [
                "SMALL_BUSINESS_ANY",
                "SBA",
                "SBP",
                "8A",
                "8AN",
                "HZC",
                "HZS",
                "SDVOSBC",
                "SDVOSBS",
                "WOSB",
                "WOSBSS",
                "EDWOSB",
                "EDWOSBSS",
                "VSA",
                "VSS",
                "ISBEE",
                "IEE",
                "BICiv",
                "LAS",
                "ESB",
                "NONE"
              ]
            },
            "default": []
          },
          "states": {
            "title": "Place-of-performance states",
            "type": "array",
            "description": "Search mode. US two-letter state codes, e.g. TX, VA, DC. Notices without a place of performance are matched on the contracting office state instead.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "agencies": {
            "title": "Agency contains",
            "type": "array",
            "description": "Search mode. Text matched (case-insensitive) against department, sub-tier and office, e.g. 'VETERANS AFFAIRS', 'NAVY', 'NASA'.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "postedWithinDays": {
            "title": "Posted within N days",
            "minimum": 0,
            "maximum": 3650,
            "type": "integer",
            "description": "Search mode. Only notices posted in the last N days (0 = any date). About 1,200 notices are posted per weekday. Prefilled 7 so a first try fills its 11 rows even on Mondays (the daily extract has no weekend postings); the API default stays 3.",
            "default": 3
          },
          "onlyOpen": {
            "title": "Only open for responses",
            "type": "boolean",
            "description": "Drop notices whose response deadline has passed. Notices without a deadline (e.g. awards, special notices) are kept.",
            "default": true
          },
          "deadlineWithinDays": {
            "title": "Deadline within N days",
            "minimum": 0,
            "maximum": 365,
            "type": "integer",
            "description": "Search mode. Only notices whose response deadline is in the next N days (0 = off). Soonest first.",
            "default": 0
          },
          "minDaysToRespond": {
            "title": "Minimum days to respond",
            "minimum": 0,
            "maximum": 365,
            "type": "integer",
            "description": "Drop notices whose response deadline is fewer than N days away (too little time to bid). Leave blank for off. Notices without a deadline are kept. Dropped notices are free and, in monitor mode, not marked as seen, so if the deadline is later extended past N days the notice comes through."
          },
          "minAwardUsd": {
            "title": "Minimum award amount (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Award notices only. Drop awards below this amount (0 = off).",
            "default": 0
          },
          "awardeeContains": {
            "title": "Awardee contains",
            "type": "array",
            "description": "Award notices only. Company-name text to match, e.g. a competitor's name.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "solicitationNumbers": {
            "title": "Solicitation or notice IDs to track",
            "type": "array",
            "description": "Track mode. Up to 500 solicitation numbers (e.g. N3220526R6128) or 32-character notice IDs. Returns every current notice for each.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "includeDescription": {
            "title": "Include description text",
            "type": "boolean",
            "description": "Add the notice's plain-text description (emails and phone numbers removed).",
            "default": true
          },
          "descriptionMaxChars": {
            "title": "Description max characters",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Truncate descriptions to this length (0 = full text). Average is about 2,100 characters.",
            "default": 4000
          },
          "monitorMode": {
            "title": "Monitor mode (only new / changed notices)",
            "type": "boolean",
            "description": "Search: return only notices this monitor hasn't returned before, or whose deadline, type, title, set-aside, NAICS, PSC, place of performance, archive date or award changed (each changed row lists `changes` with old and new values). Track: return only new or changed notices for your solicitations; unchanged ones cost $0.0002 each. Schedule daily after 05:00 UTC.",
            "default": false
          },
          "monitorId": {
            "title": "Monitor ID",
            "type": "string",
            "description": "Name of the monitor state (letters, digits, dashes). Use different IDs for different searches.",
            "default": "default"
          },
          "maxItems": {
            "title": "Max rows",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many rows (0 = no limit). Newest notices first (soonest deadline first when 'Deadline within N days' is set). Prefilled 11 so a first try costs under $0.02.",
            "default": 50
          },
          "timeBudgetSeconds": {
            "title": "Time budget (seconds)",
            "minimum": 0,
            "maximum": 3600,
            "type": "integer",
            "description": "Stop scanning after this many seconds and return what was found so far (truncated: true). 0 = no limit. A full scan takes about 20-40 seconds.",
            "default": 120
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}