# Federal Register Monitor — US Rules, Notices & Regulations (`aitoolsempire/federal-register-monitor`) Actor Track new US federal rules, proposed rules, notices and presidential documents by keyword, agency, type and date. Structured JSON with official links. Fast, no browser. - **URL**: https://apify.com/aitoolsempire/federal-register-monitor.md - **Developed by:** [Kenneth Bonnet](https://apify.com/aitoolsempire) (community) - **Categories:** News, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 66.7% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Federal Register Monitor — US Rules, Notices & Regulations Track new **US federal rules, proposed rules, notices, and presidential documents** by keyword, agency, document type, and date range. Get clean, structured JSON with direct links to the official HTML and PDF — no browser, no API key, no scraping headaches. > Point it at `"data breach"`, `"tariff"`, a competitor's name, or an agency like > the SEC or EPA, and get a ready-to-use feed of everything the US government > published on it. --- ### What it does This Actor queries the **official Federal Register API v1** (`federalregister.gov/developers/api/v1`) and flattens the results into a tidy dataset. The Federal Register is the daily journal of the US government — every proposed and final regulation, agency notice, and presidential document. Each result row includes: | Field | Description | |---|---| | `document_number` | Unique Federal Register document number | | `title` | Document title | | `type` | `Rule`, `Proposed Rule`, `Notice`, or `Presidential Document` | | `abstract` | Summary of the document | | `action` | The regulatory action (e.g. "Final rule", "Notice of meeting") | | `publication_date` | Date published in the Federal Register | | `effective_on` | Date the rule takes effect (if applicable) | | `comments_close_on` | Public comment deadline (if applicable) | | `agencies` | List of issuing agencies | | `primary_agency` | The lead agency | | `docket_ids` | Regulatory docket IDs | | `html_url` | Link to the official document page | | `pdf_url` | Link to the official PDF | | `scraped_at` | UTC timestamp of extraction | ### Example use cases - **Regulatory / compliance monitoring** — track every rule or notice from the agencies that regulate you (SEC, EPA, FDA, FCC…). - **Government affairs & lobbying** — catch proposed rules and their comment deadlines the day they publish. - **Legal research** — pull all documents mentioning a statute, program, or topic, with citable official links. - **Journalism** — monitor a keyword across the entire federal government. - **Comment-deadline alerts** — filter by `comments_close_on` to never miss a public-comment window. ### Input | Field | Type | Description | |---|---|---| | `term` | string | Keyword or phrase | | `document_types` | array | `Rule`, `Proposed Rule`, `Notice`, `Presidential Document` | | `agencies` | array | Agency slugs, e.g. `securities-and-exchange-commission` | | `start_date` / `end_date` | string | Publication date range (`YYYY-MM-DD`) | | `order` | string | `newest`, `oldest`, or `relevance` | | `max_results` | integer | Cap on records returned | At least one filter (`term`, `agencies`, `document_types`, or a date range) is required. Example input: ```json { "term": "cybersecurity", "document_types": ["Proposed Rule"], "start_date": "2026-01-01", "order": "newest", "max_results": 200 } ```` ### Output A dataset of Federal Register documents (see the table above). Export to JSON, CSV, or Excel, or read it via the dataset API. ### Pricing **Pay per result** — you are charged only for documents actually delivered. No monthly rental, no charge for empty searches. ### Notes - Data comes directly from the U.S. Federal Register, whose contents are in the **public domain**. This Actor does not alter document content. - The Actor sends a descriptive `User-Agent` with contact info, as recommended by federalregister.gov, and paces requests politely. ### Disclaimer This tool retrieves publicly available U.S. government documents from the Federal Register. It is not affiliated with or endorsed by the Office of the Federal Register. Provided for informational purposes only; not legal advice. # Actor input Schema ## `term` (type: `string`): Keyword or phrase to match in Federal Register documents (title, abstract, and full text). Example: "data breach", "tariff", "artificial intelligence". ## `document_types` (type: `array`): Restrict to specific document types. ## `agencies` (type: `array`): Restrict to specific agencies by their Federal Register slug, e.g. "securities-and-exchange-commission", "environmental-protection-agency". Leave empty for all agencies. ## `start_date` (type: `string`): Only return documents published on or after this date. ## `end_date` (type: `string`): Only return documents published on or before this date. ## `order` (type: `string`): How to sort results. ## `max_results` (type: `integer`): Maximum number of documents to return. ## `user_agent` (type: `string`): A descriptive User-Agent with contact info (recommended by federalregister.gov). A default is provided. ## Actor input object example ```json { "term": "artificial intelligence", "start_date": "2026-01-01", "end_date": "2026-06-30", "order": "newest", "max_results": 100 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "term": "artificial intelligence", "max_results": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("aitoolsempire/federal-register-monitor").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "term": "artificial intelligence", "max_results": 100, } # Run the Actor and wait for it to finish run = client.actor("aitoolsempire/federal-register-monitor").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "term": "artificial intelligence", "max_results": 100 }' | apify call aitoolsempire/federal-register-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=aitoolsempire/federal-register-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Federal Register Monitor — US Rules, Notices & Regulations", "description": "Track new US federal rules, proposed rules, notices and presidential documents by keyword, agency, type and date. Structured JSON with official links. Fast, no browser.", "version": "0.1", "x-build-id": "OXderVTXlknc3Vxvp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aitoolsempire~federal-register-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aitoolsempire-federal-register-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/aitoolsempire~federal-register-monitor/runs": { "post": { "operationId": "runs-sync-aitoolsempire-federal-register-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/aitoolsempire~federal-register-monitor/run-sync": { "post": { "operationId": "run-sync-aitoolsempire-federal-register-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": { "term": { "title": "Search term", "type": "string", "description": "Keyword or phrase to match in Federal Register documents (title, abstract, and full text). Example: \"data breach\", \"tariff\", \"artificial intelligence\"." }, "document_types": { "title": "Document types", "uniqueItems": true, "type": "array", "description": "Restrict to specific document types.", "items": { "type": "string", "enum": [ "Rule", "Proposed Rule", "Notice", "Presidential Document" ] } }, "agencies": { "title": "Agency slugs (optional)", "uniqueItems": true, "type": "array", "description": "Restrict to specific agencies by their Federal Register slug, e.g. \"securities-and-exchange-commission\", \"environmental-protection-agency\". Leave empty for all agencies.", "items": { "type": "string" } }, "start_date": { "title": "Published on or after (YYYY-MM-DD)", "type": "string", "description": "Only return documents published on or after this date." }, "end_date": { "title": "Published on or before (YYYY-MM-DD)", "type": "string", "description": "Only return documents published on or before this date." }, "order": { "title": "Sort order", "enum": [ "newest", "oldest", "relevance" ], "type": "string", "description": "How to sort results.", "default": "newest" }, "max_results": { "title": "Maximum results", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of documents to return." }, "user_agent": { "title": "Custom User-Agent (optional)", "type": "string", "description": "A descriptive User-Agent with contact info (recommended by federalregister.gov). A default is provided." } } }, "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 } } } } } } } } } } ```