{
  "title": "Follow federal rules and notices — settings",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "keyword": {
      "title": "Document topic or search term",
      "type": "string",
      "description": "Full-text search term across Federal Register documents, e.g. 'artificial intelligence', 'emissions', a company or product name. Leave empty to browse by type/agency/date.",
      "editor": "textfield",
      "example": "artificial intelligence",
      "sectionCaption": "Agency, topic and dates"
    },
    "documentTypes": {
      "title": "Document categories",
      "type": "array",
      "description": "Which document types to include, given as Federal Register codes: RULE (final rule), PRORULE (proposed rule), NOTICE, PRESDOCU (presidential document). Leave empty to include all four.",
      "editor": "select",
      "default": [],
      "items": {
        "type": "string",
        "enum": [
          "RULE",
          "PRORULE",
          "NOTICE",
          "PRESDOCU"
        ],
        "enumTitles": [
          "Final Rule",
          "Proposed Rule",
          "Notice",
          "Presidential Document"
        ]
      },
      "example": [
        "PRORULE",
        "RULE"
      ]
    },
    "agencies": {
      "title": "Exact Federal Register agency slugs",
      "type": "array",
      "description": "Restrict to one or more agencies by their exact Federal Register slug - lowercase and hyphenated, e.g. 'environmental-protection-agency', 'securities-and-exchange-commission', 'food-and-drug-administration'. A slug the API does not recognize (like 'epa') makes it reject the entire request and the run returns nothing, so copy slugs from federalregister.gov/api/v1/agencies.json. Leave empty for all agencies.",
      "editor": "stringList",
      "default": [],
      "example": [
        "environmental-protection-agency",
        "securities-and-exchange-commission"
      ]
    },
    "publishedSince": {
      "title": "Publication date — from",
      "type": "string",
      "description": "Only documents published on or after this date (YYYY-MM-DD). Great for weekly regulatory monitoring.",
      "editor": "textfield",
      "example": "2026-06-01"
    },
    "publishedUntil": {
      "title": "Publication date — through",
      "type": "string",
      "description": "Only documents published on or before this date (YYYY-MM-DD). Pair it with 'Published since' to pull a fixed historical window; leave it empty to include everything up to today.",
      "editor": "textfield",
      "example": "2026-09-30"
    },
    "order": {
      "title": "Result order",
      "type": "string",
      "description": "Sort order for results.",
      "editor": "select",
      "default": "newest",
      "enum": [
        "newest",
        "oldest",
        "relevance"
      ],
      "enumTitles": [
        "Newest first",
        "Oldest first",
        "Most relevant"
      ]
    },
    "maxResults": {
      "title": "Maximum documents to save",
      "type": "integer",
      "description": "Stop the run after this many documents. The Federal Register API is read 1000 records per page, so the default of 1000 is a single page; raise it for a full backfill of a wide filter, or lower it to a few dozen for a quick test run.",
      "editor": "number",
      "default": 1000,
      "minimum": 1
    },
    "maxRunSeconds": {
      "title": "Run time budget (seconds)",
      "type": "integer",
      "description": "Wall-clock budget for this run, in seconds. When it is reached the Actor stops cleanly and finishes successfully with the rows it already collected, instead of being killed mid-run. Pages hold 1000 documents, so only a very large \"maxResults\" gets near it. Raise it (and the run timeout in Run options) for a deliberately large job.",
      "editor": "number",
      "default": 240,
      "minimum": 30,
      "sectionCaption": "Run budget"
    }
  },
  "description": "For policy researchers and regulatory teams, collect rulemaking documents and their published dates in a table ready for review. Federal Register rules, proposed rules, notices and presidential documents. Individual public-comment text is outside this Actor's scope."
}