# Federal Register Notices API (`automly/federal-register-notices-api`) Actor Search Federal Register notices and export structured document records with publication dates, agency details, and PDF links. - **URL**: https://apify.com/automly/federal-register-notices-api.md - **Developed by:** [Automly](https://apify.com/automly) (community) - **Categories:** Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN 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 Notices API Federal Register Notices API helps you search the Federal Register and export structured notice records with titles, publication dates, agency details, and PDF links. Use it for regulatory monitoring, policy research, legal workflows, and content intelligence. ### Why use this actor? This actor turns the Federal Register into a clean dataset you can use for monitoring rulemaking, tracking notices, and feeding AI or research pipelines. It is useful when you need a quick, searchable export of current or historical notices without building your own integration. ### Features - Search Federal Register documents by keyword - Filter results by publication date range - Sort newest-first or oldest-first - Export title, type, agency names, and document links - Include or hide abstracts and PDF links - Pay-per-event pricing tied to successful notice records ### Input #### Example input: keyword search ```json { "query": "artificial intelligence", "publicationDateFrom": "2026-05-01", "publicationDateTo": "2026-05-25", "order": "newest", "maxResults": 25 } ```` #### Example input: latest notices ```json { "query": "", "order": "newest", "maxResults": 10, "includeAbstract": false, "includePdfUrls": true } ``` #### Input fields - `query` (string): Search term for Federal Register documents. Leave empty to browse the latest notices. - `publicationDateFrom` (string): Earliest publication date in `YYYY-MM-DD` format. - `publicationDateTo` (string): Latest publication date in `YYYY-MM-DD` format. - `order` (string): Sort order. Use `newest` or `oldest`. - `maxResults` (integer): Maximum records to return. Values above 100 are clamped. - `pageSize` (integer): Results fetched per API call. Values above 100 are clamped. - `includeAbstract` (boolean): Include the abstract text. - `includeAgencies` (boolean): Include the agency list. - `includePdfUrls` (boolean): Include PDF and public inspection PDF URLs. ### Output Sample record: ```json { "recordType": "notice", "query": "artificial intelligence", "documentNumber": "2026-12345", "title": "Announcement of Requirements and Registration for EHIgnite Challenge", "documentType": "Notice", "publicationDate": "2026-05-25", "htmlUrl": "https://www.federalregister.gov/documents/2026/05/25/2026-12345/example", "pdfUrl": "https://www.govinfo.gov/content/pkg/FR-2026-05-25/pdf/2026-12345.pdf", "publicInspectionPdfUrl": "https://public-inspection.federalregister.gov/2026-12345.pdf", "abstract": "The EHIgnite Challenge addresses ...", "agencyNames": "Executive Office of the President", "agencyIds": "538", "excerpt": "The EHIgnite Challenge addresses ...", "sourceUrl": "https://www.federalregister.gov/documents/2026/05/25/2026-12345/example", "apiUrl": "https://www.federalregister.gov/api/v1/documents/2026-12345", "page": 1, "positionOnPage": 1 } ``` ### Use cases - Track regulatory and policy updates - Monitor agency notices in a specific date range - Build legal research and compliance datasets - Feed notice summaries into AI workflows - Create alerts for relevant government publications ### Limits and caveats - Search quality depends on the keywords you provide. - Very broad searches may return many results, so use date filters when possible. - Some notices do not include abstracts or PDF links. - Historical coverage and metadata completeness can vary by document. ### Pricing This actor uses pay-per-event pricing: | Event | Price | When it's charged | |-------|-------|-------------------| | `notice-produced` | $0.0008 / item | Per notice successfully written to the dataset | You pay only for records that the actor produces, so small test runs stay inexpensive. ### FAQ #### Do I need an API key? No. The Federal Register API is public. #### Can I run this without a search term? Yes. Leave `query` empty to fetch the latest notices. #### What if my run charge limit is reached? The actor stops gracefully after the last chargeable record and keeps the records already produced. # Actor input Schema ## `query` (type: `string`): Search term for Federal Register documents. Leave empty to browse the latest notices. ## `publicationDateFrom` (type: `string`): Earliest publication date in YYYY-MM-DD format. ## `publicationDateTo` (type: `string`): Latest publication date in YYYY-MM-DD format. ## `order` (type: `string`): Sort order for the results: newest or oldest. ## `maxResults` (type: `integer`): Maximum number of documents to return. Values above 100 are clamped. ## `pageSize` (type: `integer`): API page size. Values above 100 are clamped. ## `includeAbstract` (type: `boolean`): Include the document abstract in each dataset row. ## `includeAgencies` (type: `boolean`): Include a compact list of agencies on each record. ## `includePdfUrls` (type: `boolean`): Include PDF and public inspection PDF URLs when available. ## Actor input object example ```json { "query": "", "publicationDateFrom": "", "publicationDateTo": "", "order": "newest", "maxResults": 50, "pageSize": 100, "includeAbstract": true, "includeAgencies": true, "includePdfUrls": true } ``` # Actor output Schema ## `records` (type: `string`): All records produced by this run. ## `overview` (type: `string`): Dataset presented using the dataset schema overview view. # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("automly/federal-register-notices-api").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 = {} # Run the Actor and wait for it to finish run = client.actor("automly/federal-register-notices-api").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 '{}' | apify call automly/federal-register-notices-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automly/federal-register-notices-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Federal Register Notices API", "description": "Search Federal Register notices and export structured document records with publication dates, agency details, and PDF links.", "version": "1.0", "x-build-id": "9XCaX1gCjd8d3zpCZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automly~federal-register-notices-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automly-federal-register-notices-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/automly~federal-register-notices-api/runs": { "post": { "operationId": "runs-sync-automly-federal-register-notices-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/automly~federal-register-notices-api/run-sync": { "post": { "operationId": "run-sync-automly-federal-register-notices-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": { "query": { "title": "Search query", "type": "string", "description": "Search term for Federal Register documents. Leave empty to browse the latest notices.", "default": "" }, "publicationDateFrom": { "title": "Publication date from", "type": "string", "description": "Earliest publication date in YYYY-MM-DD format.", "default": "" }, "publicationDateTo": { "title": "Publication date to", "type": "string", "description": "Latest publication date in YYYY-MM-DD format.", "default": "" }, "order": { "title": "Sort order", "enum": [ "newest", "oldest" ], "type": "string", "description": "Sort order for the results: newest or oldest.", "default": "newest" }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of documents to return. Values above 100 are clamped.", "default": 50 }, "pageSize": { "title": "Page size", "minimum": 1, "maximum": 100, "type": "integer", "description": "API page size. Values above 100 are clamped.", "default": 100 }, "includeAbstract": { "title": "Include abstract", "type": "boolean", "description": "Include the document abstract in each dataset row.", "default": true }, "includeAgencies": { "title": "Include agencies", "type": "boolean", "description": "Include a compact list of agencies on each record.", "default": true }, "includePdfUrls": { "title": "Include PDF URLs", "type": "boolean", "description": "Include PDF and public inspection PDF URLs when available.", "default": true } } }, "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 } } } } } } } } } } ```