{
  "openapi": "3.0.1",
  "info": {
    "title": "Federal Register API: Rules, Notices & Proposed Rules, $1/1K",
    "description": "Get Federal Register rules, proposed rules, notices and presidential documents from the official federalregister.gov API. Search by keyword, agency, type and date, look up numbers, list upcoming documents or monitor new ones. $1 per 1,000. Unofficial, not affiliated with the OFR.",
    "version": "0.1",
    "x-build-id": "sOcXhqFQuqpwpJqWw"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/conserving_celerytop~federal-register-api/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-conserving_celerytop-federal-register-api",
        "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/conserving_celerytop~federal-register-api/runs": {
      "post": {
        "operationId": "runs-sync-conserving_celerytop-federal-register-api",
        "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/conserving_celerytop~federal-register-api/run-sync": {
      "post": {
        "operationId": "run-sync-conserving_celerytop-federal-register-api",
        "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": "What to get",
            "enum": [
              "search",
              "by_number",
              "public_inspection",
              "monitor"
            ],
            "type": "string",
            "description": "Search documents by keyword, agency, type and date; get documents by their document numbers; list public inspection documents (filed and due to be published soon); or return only documents that are new since the last run of the same monitor.",
            "default": "search"
          },
          "searchTerm": {
            "title": "Keywords",
            "type": "string",
            "description": "Words to find in the full text of documents, for example \"artificial intelligence\" or tariff. Put a phrase in double quotes. Used by Search, Public inspection and Monitor. Leave empty to filter only by the fields below."
          },
          "agencies": {
            "title": "Agencies",
            "type": "array",
            "description": "One agency per line, as the agency slug from the Federal Register agency list (federalregister.gov/agencies), for example environmental-protection-agency or securities-and-exchange-commission. A full name such as \"Environmental Protection Agency\" also works. Leave empty for all agencies.",
            "items": {
              "type": "string"
            }
          },
          "documentTypes": {
            "title": "Document types",
            "type": "array",
            "description": "Keep only these kinds of documents. Rule is a final rule, Proposed Rule is a rulemaking that is open for comment, Notice covers meetings, applications and other agency notices, Presidential Document covers executive orders and proclamations. Leave empty for all types.",
            "items": {
              "type": "string",
              "enum": [
                "RULE",
                "PRORULE",
                "NOTICE",
                "PRESDOCU"
              ],
              "enumTitles": [
                "Rule",
                "Proposed Rule",
                "Notice",
                "Presidential Document"
              ]
            }
          },
          "dateFrom": {
            "title": "Published from",
            "pattern": "^(?:|\\s*\\d{4}-\\d{2}-\\d{2}\\s*|\\s*\\d+\\s*(?:[Dd][Aa][Yy]|[Ww][Ee][Ee][Kk]|[Mm][Oo][Nn][Tt][Hh]|[Yy][Ee][Aa][Rr])[Ss]?(?:\\s+[Aa][Gg][Oo])?\\s*)$",
            "type": "string",
            "description": "Keep documents published on or after this date. Use a date as YYYY-MM-DD, for example 2026-09-01, or a period such as 7 days or 3 months, counted back from the start of the run. In Monitor mode this sets only where the first run starts (default 7 days); later runs continue from the saved state. Not used for Public inspection."
          },
          "dateTo": {
            "title": "Published until",
            "pattern": "^(?:|\\s*\\d{4}-\\d{2}-\\d{2}\\s*|\\s*\\d+\\s*(?:[Dd][Aa][Yy]|[Ww][Ee][Ee][Kk]|[Mm][Oo][Nn][Tt][Hh]|[Yy][Ee][Aa][Rr])[Ss]?(?:\\s+[Aa][Gg][Oo])?\\s*)$",
            "type": "string",
            "description": "Keep documents published on or before this date, as YYYY-MM-DD or a period such as 30 days (counted back from the start of the run). Leave empty for no end date. Not used in Monitor or Public inspection mode."
          },
          "significantOnly": {
            "title": "Significant rules only",
            "type": "boolean",
            "description": "Keep only documents that the Federal Register marks as significant under Executive Order 12866. This applies to rules and proposed rules, not to notices. Not used for Public inspection.",
            "default": false
          },
          "documentNumbers": {
            "title": "Document numbers",
            "type": "array",
            "description": "One Federal Register document number per line, for example 2026-19071. You can also paste the full document link. Used only by \"Documents by number\".",
            "items": {
              "type": "string"
            }
          },
          "maxResults": {
            "title": "Maximum documents",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Stop after this many documents. The API returns up to 10,000 documents per search, so split a larger search into date ranges. In Monitor mode the oldest new documents come first and the rest wait for the next run.",
            "default": 100
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Monitor mode only. Use one name per monitor, for example epa-rules. The Actor saves what it has already returned under this name in a key-value store named federal-register-monitor in your account, so each scheduled run returns only new documents. Letters, numbers, dash and underscore.",
            "default": "default"
          },
          "resetState": {
            "title": "Start the monitor again",
            "type": "boolean",
            "description": "Monitor mode only. Forget the saved state of this monitor name and treat the run as the first run.",
            "default": false
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}