{
  "openapi": "3.0.1",
  "info": {
    "title": "SAM.gov Scraper — Federal Contract Opportunities",
    "description": "Search public SAM.gov federal contract opportunities through the official API. Return solicitations, sources sought, awards, contacts, deadlines, set-asides, and direct SAM.gov links.",
    "version": "1.0",
    "x-build-id": "QpL5bZcYcnsQBSsdM"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~sam-gov-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-sam-gov-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/khadinakbar~sam-gov-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-sam-gov-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/khadinakbar~sam-gov-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-sam-gov-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",
        "required": [
          "query"
        ],
        "properties": {
          "query": {
            "title": "Opportunity title keywords",
            "type": "string",
            "description": "Use this to search words in the SAM.gov opportunity title, for example cybersecurity or cloud migration. It defaults to no keyword so filters can return all matching opportunities. This is not a full-text search of attached solicitation documents."
          },
          "noticeTypes": {
            "title": "Notice types",
            "type": "array",
            "description": "Use this to limit results to published SAM.gov notice-type codes. Select values such as o for Solicitation, k for Combined Synopsis/Solicitation, r for Sources Sought, or a for Award Notice. It defaults to all supported types. This is not a contract award category.",
            "items": {
              "type": "string",
              "enum": [
                "o",
                "k",
                "p",
                "r",
                "s",
                "a",
                "u",
                "g",
                "i"
              ],
              "enumTitles": [
                "Solicitation",
                "Combined Synopsis/Solicitation",
                "Presolicitation",
                "Sources Sought",
                "Special Notice",
                "Award Notice",
                "Justification",
                "Sale of Surplus Property",
                "Intent to Bundle"
              ]
            },
            "default": []
          },
          "naicsCode": {
            "title": "NAICS code",
            "type": "string",
            "description": "Use this to filter opportunities by one 2-to-6-digit NAICS industry code, for example 541512. It is optional and the official API accepts one code per request. This is not a PSC or a free-text industry name."
          },
          "setAsideCode": {
            "title": "Set-aside code",
            "type": "string",
            "description": "Use this to filter by one SAM.gov set-aside code, for example SBA, 8A, HZC, or SDVOSBC. It is optional and should use the official short code. This is not a description such as 'small business'."
          },
          "state": {
            "title": "Place-of-performance state",
            "type": "string",
            "description": "Use this to filter the work location by a two-letter state or territory code, for example VA. It is optional and maps to SAM.gov's place-of-performance filter. This is not the contracting agency's state."
          },
          "agency": {
            "title": "Agency or organization",
            "type": "string",
            "description": "Use this to filter by the SAM.gov organization name, for example Department of Defense. It is optional and supports the official organization-name field. This is not a contracting officer's name."
          },
          "postedFrom": {
            "title": "Posted from",
            "type": "string",
            "description": "Use this to set the first posted date as YYYY-MM-DD or MM/DD/YYYY, for example 2026-07-01. It defaults to 30 days ago and SAM.gov permits at most one year per search. This is not a response deadline."
          },
          "postedTo": {
            "title": "Posted to",
            "type": "string",
            "description": "Use this to set the last posted date as YYYY-MM-DD or MM/DD/YYYY, for example 2026-07-19. It defaults to today and must not precede posted from. This is not an archive date."
          },
          "responseDueFrom": {
            "title": "Response deadline from",
            "type": "string",
            "description": "Use this with response deadline to include only opportunities whose response date is on or after this date. Use YYYY-MM-DD or MM/DD/YYYY, for example 2026-07-20. Both deadline fields are required together. This is not a posted-date filter."
          },
          "responseDueTo": {
            "title": "Response deadline to",
            "type": "string",
            "description": "Use this with response deadline from to include only opportunities whose response date is on or before this date. Use YYYY-MM-DD or MM/DD/YYYY, for example 2026-08-31. Both deadline fields are required together. This is not an award date."
          },
          "maxResults": {
            "title": "Maximum opportunities",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Use this to cap validated SAM.gov opportunity records written to the dataset. Enter an integer from 1 through 10000, for example 100. It defaults to 100 and prevents charges beyond this number of returned opportunities. This is not an API page count.",
            "default": 100
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}