{
  "openapi": "3.0.1",
  "info": {
    "title": "Grants.gov Federal Grant Opportunities Monitor",
    "description": "Unofficial; not affiliated with Grants.gov or HHS. Search and monitor U.S. federal grant opportunities (forecasts and open NOFOs) from the official Grants.gov API: deadlines, award amounts, eligibility. Only new and changed opportunities.",
    "version": "0.1",
    "x-build-id": "jAUyXIVsywJVx5Muq"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/brightish_ascent~grants-gov-opportunities-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-brightish_ascent-grants-gov-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/brightish_ascent~grants-gov-opportunities-monitor/runs": {
      "post": {
        "operationId": "runs-sync-brightish_ascent-grants-gov-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/brightish_ascent~grants-gov-opportunities-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-brightish_ascent-grants-gov-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": {
          "keywords": {
            "title": "Keywords",
            "type": "string",
            "description": "Free-text search across opportunity titles, numbers and descriptions, the same as the Grants.gov search box (e.g. \"broadband\", \"mental health\", \"STEM education\"). Leave empty to match everything that fits the other filters."
          },
          "opportunityStatuses": {
            "title": "Opportunity status",
            "type": "array",
            "description": "forecasted = agency announced an upcoming opportunity (estimated dates); posted = open for applications now; closed / archived = past deadline. Default: forecasted and posted.",
            "items": {
              "type": "string",
              "enum": [
                "forecasted",
                "posted",
                "closed",
                "archived"
              ],
              "enumTitles": [
                "Forecasted (upcoming)",
                "Posted (open now)",
                "Closed",
                "Archived"
              ]
            }
          },
          "agencies": {
            "title": "Agencies",
            "type": "array",
            "description": "Grants.gov agency codes. A top-level code (e.g. \"HHS\", \"USDA\", \"DOE\", \"NSF\", \"EPA\") includes all its sub-agencies; a sub-agency code (e.g. \"HHS-NIH11\", \"USDA-NIFA\", \"DOC-NIST\") narrows to that office. Up to 25. Empty = all agencies.",
            "items": {
              "type": "string"
            }
          },
          "eligibilities": {
            "title": "Eligible applicant types",
            "type": "array",
            "description": "Keep opportunities open to ANY of these applicant types (Grants.gov codes). Empty = any applicant type.",
            "items": {
              "type": "string",
              "enum": [
                "00",
                "01",
                "02",
                "04",
                "05",
                "06",
                "07",
                "08",
                "11",
                "12",
                "13",
                "20",
                "21",
                "22",
                "23",
                "25",
                "99"
              ],
              "enumTitles": [
                "State governments",
                "County governments",
                "City or township governments",
                "Special district governments",
                "Independent school districts",
                "Public and State controlled institutions of higher education",
                "Native American tribal governments (Federally recognized)",
                "Public housing authorities/Indian housing authorities",
                "Native American tribal organizations (other than Federally recogniz...",
                "Nonprofits having a 501(c)(3) status with the IRS, other than insti...",
                "Nonprofits that do not have a 501(c)(3) status with the IRS, other ...",
                "Private institutions of higher education",
                "Individuals",
                "For profit organizations other than small businesses",
                "Small businesses",
                "Others (see text field entitled \"Additional Information on Eligibil...",
                "Unrestricted (i.e., open to any type of entity above), subject to a..."
              ]
            }
          },
          "fundingCategories": {
            "title": "Funding categories",
            "type": "array",
            "description": "Keep opportunities in ANY of these Grants.gov funding activity categories. Empty = all categories.",
            "items": {
              "type": "string",
              "enum": [
                "ACA",
                "AG",
                "AR",
                "BC",
                "CD",
                "CP",
                "DPR",
                "ED",
                "EIC",
                "ELT",
                "EN",
                "ENV",
                "FN",
                "HL",
                "HO",
                "HU",
                "IIJ",
                "ISS",
                "IS",
                "LJL",
                "NR",
                "OZ",
                "O",
                "RA",
                "RT",
                "RD",
                "ST",
                "T"
              ],
              "enumTitles": [
                "Affordable Care Act",
                "Agriculture",
                "Arts",
                "Business and Commerce",
                "Community Development",
                "Consumer Protection",
                "Disaster Prevention and Relief",
                "Education",
                "Energy Infrastructure and Critical Mineral and Materials (EICMM)",
                "Employment, Labor and Training",
                "Energy",
                "Environment",
                "Food and Nutrition",
                "Health",
                "Housing",
                "Humanities",
                "Infrastructure Investment and Jobs Act (IIJA)",
                "Income Security and Social Services",
                "Information and Statistics",
                "Law, Justice and Legal Services",
                "Natural Resources",
                "Opportunity Zone Benefits",
                "Other (see text field entitled \"Explanation of Other Category of Fu...",
                "Recovery Act",
                "Recreation and Tourism",
                "Regional Development",
                "Science and Technology and other Research and Development",
                "Transportation"
              ]
            }
          },
          "fundingInstruments": {
            "title": "Funding instrument",
            "type": "array",
            "description": "Grant, cooperative agreement, procurement contract or other. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "G",
                "CA",
                "PC",
                "O"
              ],
              "enumTitles": [
                "Grant",
                "Cooperative agreement",
                "Procurement contract",
                "Other"
              ]
            }
          },
          "assistanceListings": {
            "title": "Assistance Listing (CFDA) numbers",
            "type": "array",
            "description": "Optional Assistance Listing numbers like \"93.837\" or \"47.076\" (up to 10; one Grants.gov query each, results merged and deduplicated).",
            "items": {
              "type": "string"
            }
          },
          "postedWithinDays": {
            "title": "Posted within (days)",
            "enum": [
              "3",
              "7",
              "14",
              "21",
              "28",
              "35",
              "42",
              "49",
              "56"
            ],
            "type": "string",
            "description": "Only opportunities posted in the last N days (Grants.gov's own posted-date filter). Leave unset for any posting date."
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "newest",
              "closingSoonest",
              "relevance"
            ],
            "type": "string",
            "description": "newest = most recently posted first; closingSoonest = nearest application deadline first; relevance = Grants.gov keyword relevance. Ignored in only-new mode.",
            "default": "newest"
          },
          "includeDetails": {
            "title": "Include details (amounts, eligibility, description)",
            "type": "boolean",
            "description": "Adds award ceiling/floor, estimated total funding, expected number of awards, cost sharing, funding instruments and categories, eligible applicants, eligibility notes, description (first 4,000 characters), forecast dates and last-updated date. One extra Grants.gov request per row. Agency contact fields (name, email, phone) are never output; emails and US-format phone numbers in the text are removed.",
            "default": true
          },
          "maxItems": {
            "title": "Max opportunities",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum rows to return (and be charged for) in this run. 1 to 1000.",
            "default": 25
          },
          "onlyNewSinceLastRun": {
            "title": "Only new or changed since last run (monitor mode)",
            "type": "boolean",
            "description": "For scheduled runs: return only opportunities that are new, or whose status, deadline, document type (forecast to posted), title or number changed, since the last run with the same filters. The first run is a baseline: it returns up to maxItems newest and remembers every current match (up to the 5,000 newest). Closures show as changes only when Closed is selected. State is kept in a named key-value store in your own Apify account.",
            "default": false
          },
          "outputFormat": {
            "title": "Output format",
            "enum": [
              "full",
              "compact"
            ],
            "type": "string",
            "description": "full = every field; compact = id, number, title, agency, status, dates, days until close, award ceiling, total funding, url, update type (smaller rows for AI agents and spreadsheets).",
            "default": "full"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}