# Federal Register Scraper — Rules & Regulations (`maximedupre/federal-register`) Actor Search official U.S. Federal Register documents or browse the newest entries. Get rules, notices, dates, agencies, CFR references, citations, and official PDF and HTML links. - **URL**: https://apify.com/maximedupre/federal-register.md - **Developed by:** [Maxime Dupré](https://apify.com/maximedupre) (community) - **Categories:** News, Developer tools, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $1.80 / 1,000 federal documents This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ### 🏛️ Search official Federal Register documents Federal Register Scraper — Rules & Regulations helps compliance teams, policy researchers, lawyers, and journalists find official U.S. Federal Register data. Search rules, proposed rules, notices, and presidential documents, then save dates, agencies, legal references, and official links in clear rows. - Find **[Federal Register Notice H1B](https://apify.com/maximedupre/federal-register/examples/federal-register-notice-h1b)** documents about H-1B policy. - Search a **[Federal Register Notice](https://apify.com/maximedupre/federal-register/examples/federal-register-notice)** by topic, agency, or date. - Collect **[Federal Register H1B Notices](https://apify.com/maximedupre/federal-register/examples/federal-register-h1b-notices)** with dates and official links. - Find documents about the **[Federal Register Act](https://apify.com/maximedupre/federal-register/examples/federal-register-act)**. - Track **[Federal Register Proposed Rules](https://apify.com/maximedupre/federal-register/examples/federal-register-proposed-rules)** by topic, agency, or date. - Save **[Federal Register Notices](https://apify.com/maximedupre/federal-register/examples/federal-register-notices)** with agencies, dates, and citations. #### 📦 Returned data Choose one target per run. You can get published documents, upcoming public inspection documents, or the Federal Register agency list. Published document rows can include summaries, key dates, agencies, CFR references, docket IDs, citations, page details, and official HTML and PDF links. The Actor returns metadata and direct official links. It does not return full document body text, explain legal duties, submit comments, or copy linked files. #### ▶️ Running the Actor 1. Choose a target. 2. Add search words and any filters you need. 3. Pick the result order. 4. Set a document limit, or leave it empty to return all available results until the source is exhausted. 5. Run the Actor and open the dataset. #### 🎛️ Input | Field | Type | What it does | | --- | --- | --- | | `target` | string | Chooses Federal Register documents, public inspection documents, or agencies. | | `query` | string | Finds published documents that match these words. Leave it blank to browse the newest documents first. | | `agencies` | string[] | Keeps documents from listed agency names or Federal Register slugs. | | `documentTypes` | string[] | Keeps rules, proposed rules, notices, or presidential documents. | | `publicationFrom` | date | Keeps documents published on or after this date. | | `publicationTo` | date | Keeps documents published on or before this date. | | `cfrReferences` | object[] | Keeps documents tied to any listed CFR title and part pair. | | `cfrReferences[].title` | integer | Sets a CFR title number from 1 to 50. | | `cfrReferences[].part` | integer | Sets a CFR part number. | | `significantOnly` | boolean | Keeps significant regulatory actions only. | | `order` | string | Orders matches by newest, oldest, or relevance. | | `monitorNewDocuments` | boolean | On recurring runs, returns only documents not delivered by the prior successful run for the same search. Each document is saved on its first eligible occurrence. | | `maxResults` | integer | Stops after this many published or public inspection documents. Leave it empty to return all available results until the source is exhausted. | Options that do not apply to the chosen target are ignored. ```json { "target": "documents", "query": "clean energy", "significantOnly": false, "order": "newest", "monitorNewDocuments": false, "maxResults": 5 } ```` #### 📤 Output Each row has one of these three shapes. Fields that the Federal Register does not provide may be left out. ##### Published document | Field | Type | What it does | | --- | --- | --- | | `resultType` | string | Shows `publishedDocument`. | | `documentNumber` | string | Gives the stable Federal Register document number. | | `title` | string | Gives the document title. | | `type` | string | Gives the document category. | | `abstract` | string | Gives the Federal Register summary. | | `action` | string | Gives the stated action. | | `publicationDate` | date | Gives the publication date. | | `effectiveOn` | date | Gives the effective date. | | `commentsCloseOn` | date | Gives the last public comment date. | | `agencies` | object\[] | Lists the agencies tied to the document. | | `agencies[].name` | string | Gives the agency name. | | `agencies[].slug` | string | Gives its Federal Register slug. | | `significant` | boolean | Says if this is a significant regulatory action. | | `docketIds` | string\[] | Lists docket IDs. | | `regulationIds` | string\[] | Lists Regulation Identification Numbers. | | `citation` | string | Gives the Federal Register citation. | | `cfrReferences` | object\[] | Lists related CFR titles and parts. | | `cfrReferences[].title` | integer | Gives the CFR title number. | | `cfrReferences[].part` | integer | Gives the CFR part number. | | `htmlUrl` | URL | Opens the official Federal Register page. | | `pdfUrl` | URL | Opens the official PDF. | | `startPage` | integer | Gives the first Federal Register page. | | `endPage` | integer | Gives the last Federal Register page. | | `pageCount` | integer | Gives the page count. | ```json { "resultType": "publishedDocument", "documentNumber": "2026-15096", "title": "Determination Pursuant to Section 102 of the Illegal Immigration Reform and Immigrant Responsibility Act of 1996, as Amended", "type": "Notice", "abstract": "The Secretary of Homeland Security has determined, pursuant to law, that it is necessary to waive certain laws, regulations, and other legal requirements in order to ensure the expeditious construction of barriers and roads in the vicinity of the international land border in the state of Texas.", "action": "Notice of determination.", "publicationDate": "2026-07-27", "effectiveOn": "2026-07-27", "agencies": [ { "name": "Homeland Security Department", "slug": "homeland-security-department" } ], "docketIds": [], "regulationIds": [], "citation": "91 FR 46939", "cfrReferences": [], "htmlUrl": "https://www.federalregister.gov/documents/2026/07/27/2026-15096/determination-pursuant-to-section-102-of-the-illegal-immigration-reform-and-immigrant-responsibility", "pdfUrl": "https://www.govinfo.gov/content/pkg/FR-2026-07-27/pdf/2026-15096.pdf", "startPage": 46939, "endPage": 46941, "pageCount": 3 } ``` ##### Public inspection document | Field | Type | What it does | | --- | --- | --- | | `resultType` | string | Shows `publicInspectionDocument`. | | `documentNumber` | string | Gives the document number when assigned. | | `title` | string | Gives the document title. | | `type` | string | Gives the document category. | | `agencies` | object\[] | Lists the agencies tied to the document. | | `agencies[].name` | string | Gives the agency name. | | `agencies[].slug` | string | Gives its Federal Register slug. | | `filingType` | string | Gives the public inspection filing type. | | `publicationDate` | date | Gives the planned publication date. | | `htmlUrl` | URL | Opens the official Federal Register page. | | `pdfUrl` | URL | Opens the official public inspection PDF. | ```json { "resultType": "publicInspectionDocument", "documentNumber": "2026-15209", "title": "Request for Information: National Wildlife Refuge System; Implementation of Drain Tile Setbacks; Correction", "type": "Notice", "agencies": [ { "name": "Fish and Wildlife Service", "slug": "fish-and-wildlife-service" } ], "filingType": "special", "publicationDate": "2026-07-28", "htmlUrl": "https://www.federalregister.gov/public-inspection/2026-15209/request-for-information-national-wildlife-refuge-system-implementation-of-drain-tile-setbacks", "pdfUrl": "https://public-inspection.federalregister.gov/2026-15209.pdf" } ``` ##### Agency | Field | Type | What it does | | --- | --- | --- | | `resultType` | string | Shows `agency`. | | `name` | string | Gives the agency name. | | `shortName` | string | Gives its short name. | | `slug` | string | Gives its Federal Register slug. | | `parentName` | string | Gives the parent agency name. | | `url` | URL | Opens the official agency page. | ```json { "resultType": "agency", "name": "ACTION", "shortName": "ACTION", "slug": "action", "url": "https://www.federalregister.gov/agencies/action" } ``` Open rows in the Apify dataset or use dataset exports and the Apify API. #### 💳 Pricing Check the Pricing tab for the active model. With pay-per-event pricing, you pay for each published or public inspection document saved. Agency rows, setup, empty runs, and searches with no saved documents are not charged as document events. #### 🔌 Integrations Use Apify Schedules for repeat searches. You can send saved rows through the Apify API, webhooks, and the integrations in your Apify account. https://www.youtube.com/watch?v=bNACk1\_S\_6w\&list=PLObrtcm1Kw6MUrlLNDbK9QRg8VDJg0gOW\&index=4 #### ❓ FAQ ##### Can I get a Federal Register PDF? The dataset includes direct official PDF and HTML links when the source provides them. The Actor does not store copies. ##### Does this return the Code of Federal Regulations? No. It returns Federal Register documents and their available CFR title and part references. It does not return CFR books or full CFR text. ##### Can I search one agency or document type? Yes. Use `agencies` for agency names or slugs. Use `documentTypes` for rules, proposed rules, notices, or presidential documents. ##### How does recurring monitoring work? Turn on `monitorNewDocuments` and run the same search again. The next successful run returns documents not delivered by the prior successful run for that search. A document found more than once is kept only for its first saved match. ##### Does this search GovInfo? No. It searches Federal Register data. Some official PDF links point to GovInfo. ##### What does the Federal Register contain? It publishes U.S. agency rules, proposed rules, notices, and presidential documents. This Actor helps you search that public record and save its metadata. ### 📝 Changelog - 0.2: Added reliable recurring monitoring, shared result limits for document targets, complete multi-reference CFR filtering, and improved agency parent details. - 0.0: Initial release ### 🆘 Support For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~federal-register/issues) and I'll fix or implement it in less than 24h 🫡 ### 🔗 Related Actors - [FDA Food Recall Monitor](https://apify.com/maximedupre/fda-food-recalls-scraper) — search and monitor official FDA food recall actions. - [FCC License Search](https://apify.com/maximedupre/fcc-license-search-scraper) — search public FCC licenses and recent license activity. - [FEC Campaign Finance Scraper](https://apify.com/maximedupre/fec-campaign-finance-scraper) — collect official campaign finance records and source links. - [FEMA Disaster Declarations Scraper](https://apify.com/maximedupre/fema-disaster-declarations-scraper) — filter official disaster declaration area records. - [CISA KEV Scraper](https://apify.com/maximedupre/cisa-kev-scraper) — collect official known exploited vulnerability records. **Made with ❤️ by Maxime Dupré** # Actor input Schema ## `__isDebug` (type: `boolean`): Add safe debug logs and resource telemetry. ## `target` (type: `string`): Choose what to find. ## `query` (type: `string`): Find Federal Register documents that match these words. Leave this blank to browse the newest documents first. ## `agencies` (type: `array`): Only include documents from these federal agencies. Enter agency names or Federal Register agency slugs. ## `documentTypes` (type: `array`): Only include these Federal Register document categories. ## `publicationFrom` (type: `string`): Only include documents published on or after this date. ## `publicationTo` (type: `string`): Only include documents published on or before this date. ## `cfrReferences` (type: `array`): Only include documents tied to any listed Code of Federal Regulations title and part pair. ## `significantOnly` (type: `boolean`): Only include significant regulatory actions. ## `order` (type: `string`): Choose how to order matching documents. ## `monitorNewDocuments` (type: `boolean`): On recurring runs, return only documents not delivered by the prior successful run for this same search. Each document is saved on its first eligible occurrence. ## `maxResults` (type: `integer`): For Federal Register documents and Public inspection documents, stop after this many matches. Leave this empty to return all available results until the source is exhausted. ## Actor input object example ```json { "__isDebug": false, "target": "documents", "query": "clean energy", "agencies": [ "environmental-protection-agency" ], "significantOnly": false, "order": "newest", "monitorNewDocuments": false, "maxResults": 5 } ``` # Actor output Schema ## `dataset` (type: `string`): Open the saved documents or agencies. # 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 = { "target": "documents", "query": "clean energy", "maxResults": 5 }; // Run the Actor and wait for it to finish const run = await client.actor("maximedupre/federal-register").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 = { "target": "documents", "query": "clean energy", "maxResults": 5, } # Run the Actor and wait for it to finish run = client.actor("maximedupre/federal-register").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 '{ "target": "documents", "query": "clean energy", "maxResults": 5 }' | apify call maximedupre/federal-register --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=maximedupre/federal-register", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Federal Register Scraper — Rules & Regulations", "description": "Search official U.S. Federal Register documents or browse the newest entries. Get rules, notices, dates, agencies, CFR references, citations, and official PDF and HTML links.", "version": "0.2", "x-build-id": "sh28k5qOTby5djjvh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~federal-register/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-federal-register", "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/maximedupre~federal-register/runs": { "post": { "operationId": "runs-sync-maximedupre-federal-register", "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/maximedupre~federal-register/run-sync": { "post": { "operationId": "run-sync-maximedupre-federal-register", "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", "required": [ "target" ], "properties": { "__isDebug": { "title": "Debug mode", "type": "boolean", "description": "Add safe debug logs and resource telemetry.", "default": false }, "target": { "title": "Target", "enum": [ "documents", "publicInspection", "agencies" ], "type": "string", "description": "Choose what to find." }, "query": { "title": "Search words", "type": "string", "description": "Find Federal Register documents that match these words. Leave this blank to browse the newest documents first." }, "agencies": { "title": "Agencies", "type": "array", "description": "Only include documents from these federal agencies. Enter agency names or Federal Register agency slugs.", "items": { "type": "string", "minLength": 1 } }, "documentTypes": { "title": "Document types", "uniqueItems": true, "type": "array", "description": "Only include these Federal Register document categories.", "items": { "type": "string", "enum": [ "rule", "proposed-rule", "notice", "presidential-document" ], "enumTitles": [ "Rule", "Proposed rule", "Notice", "Presidential document" ] } }, "publicationFrom": { "title": "Published from", "type": "string", "description": "Only include documents published on or after this date." }, "publicationTo": { "title": "Published through", "type": "string", "description": "Only include documents published on or before this date." }, "cfrReferences": { "title": "CFR references", "type": "array", "description": "Only include documents tied to any listed Code of Federal Regulations title and part pair.", "items": { "type": "object", "properties": { "title": { "type": "integer", "title": "CFR title", "description": "Code of Federal Regulations title number.", "minimum": 1, "maximum": 50 }, "part": { "type": "integer", "title": "CFR part", "description": "Code of Federal Regulations part number.", "minimum": 1 } }, "required": [ "title", "part" ], "additionalProperties": false } }, "significantOnly": { "title": "Significant actions only", "type": "boolean", "description": "Only include significant regulatory actions.", "default": false }, "order": { "title": "Result order", "enum": [ "newest", "oldest", "relevance" ], "type": "string", "description": "Choose how to order matching documents.", "default": "newest" }, "monitorNewDocuments": { "title": "Only new documents", "type": "boolean", "description": "On recurring runs, return only documents not delivered by the prior successful run for this same search. Each document is saved on its first eligible occurrence.", "default": false }, "maxResults": { "title": "Maximum documents", "minimum": 1, "type": "integer", "description": "For Federal Register documents and Public inspection documents, stop after this many matches. Leave this empty to return all available results until the source is exhausted." } } }, "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 } } } } } } } } } } ```