# Federal Register Monitor 📜 (new rules & notices alerts) (`tagadanar/federal-register-monitor`) Actor
Track US rulemaking on the official Federal Register API. Watch by agency, topic or keyword and get only what is new since your last run: final rules, proposed rules, notices and presidential documents, straight to your workflow or Slack. No API key.
- **URL**: https://apify.com/tagadanar/federal-register-monitor.md
- **Developed by:** [Tagada Data](https://apify.com/tagadanar) (community)
- **Categories:** News, Automation, AI
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $1.40 / 1,000 document founds
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## 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: New Rules, Proposed Rules & Notices Alerts
**Watch a US agency, topic or keyword on the official Federal Register and get back only what is new since your last run: final rules, proposed rules, notices and presidential documents, straight to your workflow or Slack.** Give it a watchlist, schedule it, and it reports (and charges) only for genuinely new documents, not the same list every day. Data comes straight from the official Federal Register API, no key required.
Built for **compliance and regulatory-affairs teams, in-house legal, lobbying and policy shops, and ESG, energy, finance and healthcare firms tracking rulemaking** (works out of the box via API and MCP).
### Why this actor
- One watchlist, a real diff: most Federal Register exports hand you the full result set every time and leave deduplication to you. This one keeps a persistent memory of what it has already seen and returns only documents published since your last run.
- Scope it the way regulators file: by agency (`environmental-protection-agency`, `securities-and-exchange-commission`, ...), by document type (final rules, proposed rules, notices, presidential documents), and by any keyword or topic.
- Official source, no key, no scraping: every field comes from the Federal Register API (`federalregister.gov/api/v1`). No login, no third-party mirror.
- Flat schema, no JSON spelunking: document number, title, type, abstract, agencies, publication and effective dates, docket IDs and RINs as plain columns, plus direct links to the document and its PDF.
- Monitor mode with a Slack-compatible webhook digest: schedule it and get pinged only when an agency you track actually publishes something.
- Fair pricing: you pay per document actually returned. A quiet day on a scheduled watchlist costs nothing beyond the flat run fee.
### Use cases
- **Compliance and regulatory affairs**: watch the agencies that govern your industry and catch every new rule or proposed rule the day it publishes.
- **In-house legal**: track proposed rules by keyword so you can file comments before the window closes.
- **Lobbying and policy shops**: monitor a docket, an agency or a topic and route new filings to the right analyst.
- **ESG, energy, finance and healthcare**: follow the EPA, SEC, FDA, FERC or any agency for rulemaking that moves your sector.
- **AI agents**: plug it into Claude, Cursor or any MCP client and ask, *"any new EPA proposed rules on emissions this week?"*
### Input
```json
{
"agencies": ["environmental-protection-agency"],
"documentTypes": ["RULE", "PRORULE"],
"sinceDays": 30,
"maxResults": 50
}
````
Provide at least one of `keywords` or `agencies` so the query is scoped. `keywords` searches the full text (multiple entries are OR-combined, so a document matching any keyword is returned). `agencies` takes agency slugs or names (a name like `Securities and Exchange Commission` is converted to its slug automatically). `documentTypes`, `sinceDays` and `maxResults` narrow the results further.
Monitor a topic across agencies (for a scheduled run):
```json
{
"keywords": ["artificial intelligence", "algorithmic"],
"documentTypes": ["RULE", "PRORULE", "NOTICE"],
"sinceDays": 7,
"monitorMode": true,
"webhookUrl": "https://hooks.slack.com/services/xxx/yyy/zzz"
}
```
`documentTypes` accepts `RULE` (final rules), `PRORULE` (proposed rules), `NOTICE` (notices) and `PRESDOCU` (presidential documents); leave it empty for all. Find agency slugs at `https://www.federalregister.gov/api/v1/agencies`, for example `environmental-protection-agency`, `securities-and-exchange-commission`, `food-and-drug-administration`, `federal-communications-commission`.
### Output (one record per new or matched document)
```json
{
"documentNumber": "2026-13843",
"title": "Air Plan Approval; Michigan; Redesignation and Maintenance Plan...",
"type": "Rule",
"abstract": "The Environmental Protection Agency (EPA) is taking final action to...",
"agencies": ["Environmental Protection Agency"],
"publicationDate": "2026-07-09",
"effectiveOn": "2026-07-09",
"docketIds": ["EPA-R05-OAR-2023-0635", "FRL-13222-02-R5"],
"regulationIdNumbers": [],
"htmlUrl": "https://www.federalregister.gov/documents/2026/07/09/2026-13843/air-plan-approval-michigan",
"pdfUrl": "https://www.govinfo.gov/content/pkg/FR-2026-07-09/pdf/2026-13843.pdf",
"changeType": "new",
"retrievedAt": "2026-07-09T00:00:00.000Z"
}
```
| Field | Meaning |
|---|---|
| `documentNumber` | The document's Federal Register number |
| `title` | Document title |
| `type` | `Rule`, `Proposed Rule`, `Notice` or `Presidential Document` |
| `abstract` | The document's abstract / summary |
| `agencies` | Publishing agency names |
| `publicationDate` | Date published in the Federal Register |
| `effectiveOn` | Effective date when set (often `null` for proposed rules and notices) |
| `docketIds` | Associated docket identifiers |
| `regulationIdNumbers` | Regulation Identifier Numbers (RIN) when present |
| `htmlUrl` | Direct link to the document page |
| `pdfUrl` | Link to the official PDF |
| `changeType` | Monitor mode: `new`; `null` on one-off runs |
| `retrievedAt` | When this run fetched the document |
On a one-off run (`monitorMode` off) you get every match with `changeType` set to `null`. In monitor mode the first run seeds the baseline and reports everything as `new`; later runs return only documents published since.
### Pricing
Pay per event, no subscription. Users on higher Apify plans get automatic discounts.
| Event | Price | When |
|---|---|---|
| Run started | **$0.001** | Flat, once per run |
| Document found | **$0.002** | Per new/matched document returned with its data |
| Digest sent | **$0.03** | Monitor mode only, per Slack/webhook digest actually posted |
A thousand documents costs $2, and in monitor mode a quiet watchlist costs almost nothing: the persistent seen-set means you are never billed twice for the same document, so a scheduled run that finds nothing new only pays the tiny run fee. That is the difference from a raw export that bills you for the whole result set on every run.
### FAQ
**How do I get alerted when the EPA publishes a new rule?** Put `environmental-protection-agency` in `agencies`, set `documentTypes` to `["RULE", "PRORULE"]`, turn on `monitorMode`, add a Slack webhook URL and schedule the actor. You get a digest only when the EPA actually publishes, and you are only charged for new documents.
**Can I track proposed rules by keyword?** Yes. Put your topics in `keywords` and set `documentTypes` to `["PRORULE"]`. Multiple keywords are OR-combined, so a document matching any of them is returned. Combine with `agencies` to narrow to specific agencies.
**Is Federal Register data free?** The data is public and the official Federal Register API is keyless and open, so there is no login, no scraping and no third-party aggregator. You pay only for this actor's convenience: the diffing, the flat schema and the webhook alerts.
**How do I monitor rulemaking for my industry?** List the agencies that govern your sector (for example EPA and FERC for energy, SEC for finance, FDA for healthcare) in `agencies`, optionally add topic `keywords`, and schedule it in monitor mode. You get every new rule, proposed rule and notice from those agencies as it publishes.
**How is this different from just querying the API myself?** The API returns the full matching set on every call. This actor remembers what it already showed you and returns only documents published since, tagged `new`. That is the difference between a query and a monitor.
**Where do I find the agency slug I need?** Open `https://www.federalregister.gov/api/v1/agencies` for the full list, or just type the agency name (for example `Federal Communications Commission`) and the actor converts it to the right slug.
**Does it work with AI agents?** Yes. Like every Apify actor it is exposed via REST API and **MCP**, so Claude, Cursor and similar tools can call it directly, for instance to answer "list new SEC proposed rules from this month".
***
### Something missing?
If you need an extra field, another source, or a different output, open an issue on this Actor and describe it. I read every request and small additions usually ship within days. More monitors and data Actors are on [my profile](https://apify.com/tagadanar), including the [ClinicalTrials.gov monitor](https://apify.com/tagadanar), a brand and news monitor, and a Companies House monitor.
*Keywords: Federal Register API, Federal Register monitor, US rulemaking tracker, regulatory change monitoring, proposed rule alerts, final rule alerts, agency rulemaking tracker, compliance monitoring, regulatory affairs, docket monitoring, RIN tracker, EPA rule alerts, SEC rule alerts, FDA notice monitor, notice of proposed rulemaking, Federal Register for AI agents, MCP, Federal Register v1 API.*
# Actor input Schema
## `keywords` (type: `array`):
Words or phrases to watch in the full text, e.g. emissions, cybersecurity, artificial intelligence. Maps to the API's full-text search. Multiple entries are combined with OR (a document matching any keyword is returned). Provide at least one of keywords or agencies.
## `agencies` (type: `array`):
US agencies to watch, by slug or name, e.g. environmental-protection-agency, securities-and-exchange-commission, food-and-drug-administration. Names with spaces are converted to slugs automatically. Find the full slug list at https://www.federalregister.gov/api/v1/agencies. Provide at least one of keywords or agencies.
## `documentTypes` (type: `array`):
Which kinds of Federal Register documents to keep. Leave empty for all types.
## `sinceDays` (type: `integer`):
Only include documents published within the last N days. Sets the publication-date window. Keep it small for a scheduled monitor.
## `maxResults` (type: `integer`):
Stop after collecting this many matching documents. Caps cost and runtime on broad queries.
## `monitorMode` (type: `boolean`):
Remember documents already seen across runs and return only new ones. Built for a scheduled run: the first run establishes the baseline, later runs report and charge for new documents only.
## `webhookUrl` (type: `string`):
When monitor mode finds new documents, post a text digest here (Slack incoming webhook or any endpoint accepting {"text": "..."} JSON).
## Actor input object example
```json
{
"keywords": [],
"agencies": [
"environmental-protection-agency"
],
"documentTypes": [
"RULE",
"PRORULE"
],
"sinceDays": 30,
"maxResults": 10,
"monitorMode": false
}
```
# Actor output Schema
## `documents` (type: `string`):
One item per new/matched document in the default dataset.
# 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 = {
"keywords": [],
"agencies": [
"environmental-protection-agency"
],
"documentTypes": [
"RULE",
"PRORULE"
],
"sinceDays": 30,
"maxResults": 10
};
// Run the Actor and wait for it to finish
const run = await client.actor("tagadanar/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 = {
"keywords": [],
"agencies": ["environmental-protection-agency"],
"documentTypes": [
"RULE",
"PRORULE",
],
"sinceDays": 30,
"maxResults": 10,
}
# Run the Actor and wait for it to finish
run = client.actor("tagadanar/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 '{
"keywords": [],
"agencies": [
"environmental-protection-agency"
],
"documentTypes": [
"RULE",
"PRORULE"
],
"sinceDays": 30,
"maxResults": 10
}' |
apify call tagadanar/federal-register-monitor --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=tagadanar/federal-register-monitor",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Federal Register Monitor 📜 (new rules & notices alerts)",
"description": "Track US rulemaking on the official Federal Register API. Watch by agency, topic or keyword and get only what is new since your last run: final rules, proposed rules, notices and presidential documents, straight to your workflow or Slack. No API key.",
"version": "0.1",
"x-build-id": "eMfv4nd5Yi2xnd87F"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tagadanar~federal-register-monitor/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tagadanar-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/tagadanar~federal-register-monitor/runs": {
"post": {
"operationId": "runs-sync-tagadanar-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/tagadanar~federal-register-monitor/run-sync": {
"post": {
"operationId": "run-sync-tagadanar-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": {
"keywords": {
"title": "Keywords / topics",
"type": "array",
"description": "Words or phrases to watch in the full text, e.g. emissions, cybersecurity, artificial intelligence. Maps to the API's full-text search. Multiple entries are combined with OR (a document matching any keyword is returned). Provide at least one of keywords or agencies.",
"items": {
"type": "string"
}
},
"agencies": {
"title": "Agencies",
"type": "array",
"description": "US agencies to watch, by slug or name, e.g. environmental-protection-agency, securities-and-exchange-commission, food-and-drug-administration. Names with spaces are converted to slugs automatically. Find the full slug list at https://www.federalregister.gov/api/v1/agencies. Provide at least one of keywords or agencies.",
"items": {
"type": "string"
}
},
"documentTypes": {
"title": "Document types",
"type": "array",
"description": "Which kinds of Federal Register documents to keep. Leave empty for all types.",
"items": {
"type": "string",
"enum": [
"RULE",
"PRORULE",
"NOTICE",
"PRESDOCU"
],
"enumTitles": [
"Final rules",
"Proposed rules",
"Notices",
"Presidential documents"
]
}
},
"sinceDays": {
"title": "Look back this many days",
"minimum": 1,
"maximum": 3650,
"type": "integer",
"description": "Only include documents published within the last N days. Sets the publication-date window. Keep it small for a scheduled monitor.",
"default": 30
},
"maxResults": {
"title": "Max documents per run",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Stop after collecting this many matching documents. Caps cost and runtime on broad queries.",
"default": 100
},
"monitorMode": {
"title": "Monitor mode (alert on new documents only)",
"type": "boolean",
"description": "Remember documents already seen across runs and return only new ones. Built for a scheduled run: the first run establishes the baseline, later runs report and charge for new documents only.",
"default": false
},
"webhookUrl": {
"title": "Webhook URL (Slack-compatible)",
"type": "string",
"description": "When monitor mode finds new documents, post a text digest here (Slack incoming webhook or any endpoint accepting {\"text\": \"...\"} JSON)."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```