{
  "title": "Find federal grant opportunities — settings",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "keyword": {
      "title": "Funding topic or keyword",
      "type": "string",
      "description": "Full-text search across grant opportunities, e.g. 'solar', 'small business innovation', 'rural health'. Leave empty for all.",
      "editor": "textfield",
      "example": "clean energy",
      "sectionCaption": "Topic and opportunity scope"
    },
    "oppStatuses": {
      "title": "Opportunity stages",
      "type": "array",
      "description": "Posted = open now. Forecasted = expected soon (great for getting ahead of deadlines).",
      "editor": "select",
      "default": [
        "posted"
      ],
      "items": {
        "type": "string",
        "enum": [
          "posted",
          "forecasted",
          "closed",
          "archived"
        ],
        "enumTitles": [
          "Posted (open)",
          "Forecasted (upcoming)",
          "Closed",
          "Archived"
        ]
      },
      "example": [
        "posted",
        "forecasted"
      ]
    },
    "agencies": {
      "title": "Exact agency or subagency codes",
      "type": "array",
      "description": "Exact Grants.gov agency codes, e.g. 'NSF', 'USDA-RBCS', 'HHS-NIH11', 'DOD-AFOSR'. NOTE: department-level codes like 'USDA' alone will NOT match — use the specific subagency code (find them on grants.gov search filters). Leave empty for all.",
      "editor": "stringList",
      "default": [],
      "example": [
        "NSF",
        "HHS-NIH11"
      ]
    },
    "fundingCategories": {
      "title": "Funding category codes",
      "type": "array",
      "description": "Category codes, e.g. 'EN' (Energy), 'AG' (Agriculture), 'HL' (Health), 'ED' (Education), 'ST' (Science & Technology), 'BC' (Business & Commerce). Leave empty for all.",
      "editor": "stringList",
      "default": [],
      "example": [
        "EN",
        "ST"
      ]
    },
    "eligibilities": {
      "title": "Applicant eligibility codes",
      "type": "array",
      "description": "Applicant-type codes to filter by. Common ones: 23 = small businesses, 12 = nonprofits WITH 501(c)(3) status, 13 = nonprofits WITHOUT 501(c)(3), 21 = individuals, 20 = private higher education, 00 = state governments, 99 = unrestricted. Leave empty for all applicant types.",
      "editor": "stringList",
      "default": [],
      "example": [
        "23",
        "12"
      ]
    },
    "aln": {
      "title": "ALN / CFDA number",
      "type": "string",
      "description": "Filter by Assistance Listing Number (formerly CFDA), e.g. '47.050'. Leave empty for all.",
      "editor": "textfield"
    },
    "includeDetails": {
      "title": "Request opportunity details",
      "type": "boolean",
      "description": "Fetch each grant's full detail record: award ceiling/floor, total program funding, expected number of awards, applicant types & eligibility, deadlines, and agency contact. Adds ~0.3s per grant.",
      "editor": "checkbox",
      "default": true
    },
    "maxResults": {
      "title": "Maximum opportunities to save",
      "type": "integer",
      "description": "Upper bound on grants returned per run. The default of 50 is a fast representative sample. Raise it for a larger search; full details require one extra request per opportunity and source response times vary.",
      "editor": "number",
      "default": 50,
      "minimum": 1,
      "example": 2000
    },
    "maxRunSeconds": {
      "title": "Run time budget (seconds)",
      "type": "integer",
      "description": "Wall-clock budget for this run. Detail enrichment costs one grants.gov request per grant, so a large unfiltered sweep can run long. When this budget is reached the Actor stops cleanly and finishes successfully with the grants it already collected, rather than being killed mid-run. Raise it for a deliberate full sweep (and raise the run timeout in Run options to match).",
      "editor": "number",
      "default": 240,
      "minimum": 30,
      "sectionCaption": "Run budget"
    }
  },
  "description": "For grant writers, research offices and nonprofits, gather federal funding opportunities with the details needed for a first review. Public Grants.gov search and opportunity-detail records. Available fields depend on each listing and successful detail retrieval."
}