# eCFR & Federal Register Change Report (`taroyamada/regulatory-obligation-change-impact-report`) Actor Track eCFR sections and Federal Register notices across regulatory watchlists. Deliver source-linked changes, obligation-impact alerts, reports, and exports. - **URL**: https://apify.com/taroyamada/regulatory-obligation-change-impact-report.md - **Developed by:** [naoki anzai](https://apify.com/taroyamada) (community) - **Categories:** Business - **Stats:** 1 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $8.00 / 1,000 regulatory change rows 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 ## eCFR & Federal Register Change Report Compliance and regulatory operations teams provide CFR watchlists and a stable monitor key. The actor compares official eCFR content and Federal Register publication metadata. It returns source-linked change alerts, a portfolio impact report, and an optional export for human review. This actor is an unofficial research and triage tool. It does not determine legal effect, compliance status, effective dates, or required actions, and it is not legal advice. ### Start with a low-cost paid trial Use this capped input to verify the source and buyer-facing output before buying a full report. It disables the report and export events and caps the run at **$1.00**. It delivers both a source row (`regulatory-change-row`, $0.008) and a buyer-facing signal (`obligation-impact-alert`, $0.30) when the starter evidence matches. A zero-row run has zero event charge. [Open the maintained starter input](https://github.com/luxslime/apify-paid-report-starter-kits/blob/master/inputs/regulatory-obligation-change-impact-report.json) if you prefer a standalone JSON file. ```json { "watchlists": [ { "id": "electronic-records", "cfrTitle": 21, "part": "11", "keywords": [ "electronic record" ] } ], "monitorKey": "starter-electronic-records", "initialRunMode": "emit_backfill", "generateReport": false, "emitRawRows": true, "emitUnchanged": false, "emitExport": false, "maxFederalRegisterDocuments": 1, "lookbackDays": 30, "maxChargeUsd": 1, "dryRun": false } ```` When the result fits your workflow, enable the full `regulatory-impact-report` output (**$12.00 per delivered report**) and set a buyer-approved `maxChargeUsd`. ### Store Quickstart ```json { "watchlists": [{ "id": "electronic-records", "name": "Electronic records", "cfrTitle": 21, "part": "11", "keywords": ["electronic record", "electronic signature"], "federalRegisterTerms": ["electronic records"] }], "monitorKey": "qa-electronic-records", "initialRunMode": "emit_backfill", "generateReport": true, "emitRawRows": false, "emitUnchanged": false, "emitExport": true, "maxChargeUsd": 25, "dryRun": false } ``` Use `emit_backfill` for a source-linked first report. For scheduled monitoring, use `baseline_only`: the first successful run saves the comparison baseline with zero rows and zero charge. Every later unchanged run also produces zero rows and zero charge. #### Agency portfolio ```json { "watchlists": [{ "id": "privacy-rules", "cfrTitle": 16, "part": "314", "keywords": ["information security program", "customer information"], "agencySlugs": ["federal-trade-commission"] }], "monitorKey": "privacy-rules", "initialRunMode": "baseline_only", "generateReport": true, "emitRawRows": false, "emitUnchanged": false, "maxChargeUsd": 20, "dryRun": false } ``` #### Section-level watch ```json { "watchlists": [{ "id": "part-11-controls", "cfrTitle": 21, "part": "11", "sections": ["10", "30"], "obligationLabel": "Electronic record controls" }], "monitorKey": "part-11-controls", "initialRunMode": "baseline_only", "generateReport": true, "emitRawRows": true, "emitUnchanged": false, "emitExport": true, "maxChargeUsd": 30, "dryRun": false } ``` ### Output Report-first output uses four PAY\_PER\_EVENT rows: | Event | Price | Delivered when | | --- | ---: | --- | | `regulatory-change-row` | $0.008 | A changed source observation is requested as a raw row | | `obligation-impact-alert` | $0.30 | A monitored obligation has a changed source observation | | `regulatory-impact-report` | $12.00 | A changed portfolio report is generated | | `regulatory-impact-export` | $7.00 | An export handoff row is generated | There is no start charge. Billing is preflighted against `maxChargeUsd` before the first row is delivered. Unknown billing events and missing `chargedCount` fail closed. Key fields include `rowType`, `billingEventName`, `stableKey`, `sourceUrls`, `watchlistId`, `obligationId`, `cfrCitation`, `changeKinds`, `watchTermHits`, `checkedAt`, `limitations`, and `prohibitedInterpretations`. ### Monitoring contract - `baseline_only` first run: zero rows and zero charge. - Unchanged run: zero rows and zero charge. - State is committed only after complete official-source collection and successful delivery. - A source error, delivery error, or state error fails closed. - eCFR is an editorial compilation; linked Federal Register metadata must be reviewed by a qualified person. ### Compliance Only official public eCFR and Federal Register endpoints are used. The actor does not access private filings, login-only material, sealed records, or personal enrichment. Output must not be represented as agency-approved, legally binding, or a substitute for counsel. See [source compliance](docs/source-compliance.md), [integration guide](docs/integration-guide.md), [sample output](docs/sample-output.json), and [competitive snapshot](docs/store-competitive-snapshot.md). ### Run the next report - [Federal Register Digest](https://apify.com/taroyamada/federal-register-digest) for broad publication monitoring. - [eCFR Section Change Watch](https://apify.com/taroyamada/ecfr-cfr-section-change-watch-scraper) for lower-level section change alerts. # Actor input Schema ## `watchlists` (type: `array`): CFR titles, parts, or sections to compare with the official eCFR and Federal Register APIs. ## `monitorKey` (type: `string`): Stable state namespace for this monitor. Use a distinct key for each monitored portfolio. ## `initialRunMode` (type: `string`): baseline\_only saves a zero-charge baseline; emit\_backfill emits a source-linked initial report. ## `generateReport` (type: `boolean`): Emit one report event for a changed run. ## `emitRawRows` (type: `boolean`): Emit one source-linked change row per changed watchlist and one export handoff row. ## `emitUnchanged` (type: `boolean`): Accepted for explicit run intent, but unchanged runs are always suppressed to preserve the zero-row, zero-charge invariant. ## `maxChargeUsd` (type: `number`): The complete planned charge must fit this cap before any billable row is pushed. ## `dryRun` (type: `boolean`): Return an illustrative report/alert shape without network calls, state writes, or charges. ## `emitExport` (type: `boolean`): Optional compatibility switch for a handoff export when raw rows are not requested. ## `delivery` (type: `string`): Delivery mode for this run. ## `webhookUrl` (type: `string`): Optional HTTPS handoff after dataset event delivery. ## `requestTimeoutSeconds` (type: `integer`): Request timeout seconds for this run. ## `rateLimitMs` (type: `integer`): Minimum request interval milliseconds for this run. ## `maxRetries` (type: `integer`): Maximum retries for this run. ## `backoffBaseMs` (type: `integer`): Backoff base milliseconds for this run. ## `maxBackoffMs` (type: `integer`): Maximum backoff milliseconds for this run. ## `maxFederalRegisterDocuments` (type: `integer`): Maximum Federal Register documents for this run. ## `lookbackDays` (type: `integer`): Default Federal Register lookback days for this run. ## Actor input object example ```json { "watchlists": [ { "id": "electronic-records", "cfrTitle": 21, "part": "11", "keywords": [ "electronic record" ] } ], "monitorKey": "starter-electronic-records", "initialRunMode": "emit_backfill", "generateReport": false, "emitRawRows": true, "emitUnchanged": false, "maxChargeUsd": 1, "dryRun": false, "emitExport": false, "delivery": "dataset", "requestTimeoutSeconds": 30, "rateLimitMs": 250, "maxRetries": 2, "backoffBaseMs": 250, "maxBackoffMs": 4000, "maxFederalRegisterDocuments": 1, "lookbackDays": 30 } ``` # 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("taroyamada/regulatory-obligation-change-impact-report").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("taroyamada/regulatory-obligation-change-impact-report").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 taroyamada/regulatory-obligation-change-impact-report --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=taroyamada/regulatory-obligation-change-impact-report", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "eCFR & Federal Register Change Report", "description": "Track eCFR sections and Federal Register notices across regulatory watchlists. Deliver source-linked changes, obligation-impact alerts, reports, and exports.", "version": "0.1", "x-build-id": "4vxdYUBkWRb8wj8VJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/taroyamada~regulatory-obligation-change-impact-report/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-taroyamada-regulatory-obligation-change-impact-report", "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/taroyamada~regulatory-obligation-change-impact-report/runs": { "post": { "operationId": "runs-sync-taroyamada-regulatory-obligation-change-impact-report", "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/taroyamada~regulatory-obligation-change-impact-report/run-sync": { "post": { "operationId": "run-sync-taroyamada-regulatory-obligation-change-impact-report", "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": [ "watchlists", "monitorKey", "initialRunMode", "generateReport", "emitRawRows", "emitUnchanged", "maxChargeUsd", "dryRun" ], "properties": { "watchlists": { "title": "Obligation watchlists", "minItems": 1, "maxItems": 100, "type": "array", "description": "CFR titles, parts, or sections to compare with the official eCFR and Federal Register APIs.", "default": [ { "id": "electronic-records", "cfrTitle": 21, "part": "11", "keywords": [ "electronic record" ] } ] }, "monitorKey": { "title": "Monitor key", "minLength": 1, "maxLength": 120, "type": "string", "description": "Stable state namespace for this monitor. Use a distinct key for each monitored portfolio.", "default": "starter-electronic-records" }, "initialRunMode": { "title": "Initial run mode", "enum": [ "baseline_only", "emit_backfill" ], "type": "string", "description": "baseline_only saves a zero-charge baseline; emit_backfill emits a source-linked initial report.", "default": "emit_backfill" }, "generateReport": { "title": "Generate impact report", "type": "boolean", "description": "Emit one report event for a changed run.", "default": false }, "emitRawRows": { "title": "Emit raw change rows", "type": "boolean", "description": "Emit one source-linked change row per changed watchlist and one export handoff row.", "default": true }, "emitUnchanged": { "title": "Emit unchanged rows", "type": "boolean", "description": "Accepted for explicit run intent, but unchanged runs are always suppressed to preserve the zero-row, zero-charge invariant.", "default": false }, "maxChargeUsd": { "title": "Maximum charge USD", "minimum": 0, "maximum": 5000, "type": "number", "description": "The complete planned charge must fit this cap before any billable row is pushed.", "default": 1 }, "dryRun": { "title": "Dry run", "type": "boolean", "description": "Return an illustrative report/alert shape without network calls, state writes, or charges.", "default": false }, "emitExport": { "title": "Emit export without raw rows", "type": "boolean", "description": "Optional compatibility switch for a handoff export when raw rows are not requested.", "default": false }, "delivery": { "title": "Delivery mode", "enum": [ "dataset", "webhook" ], "type": "string", "description": "Delivery mode for this run.", "default": "dataset" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "Optional HTTPS handoff after dataset event delivery." }, "requestTimeoutSeconds": { "title": "Request timeout seconds", "minimum": 2, "maximum": 120, "type": "integer", "description": "Request timeout seconds for this run.", "default": 30 }, "rateLimitMs": { "title": "Minimum request interval milliseconds", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Minimum request interval milliseconds for this run.", "default": 250 }, "maxRetries": { "title": "Maximum retries", "minimum": 0, "maximum": 4, "type": "integer", "description": "Maximum retries for this run.", "default": 2 }, "backoffBaseMs": { "title": "Backoff base milliseconds", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Backoff base milliseconds for this run.", "default": 250 }, "maxBackoffMs": { "title": "Maximum backoff milliseconds", "minimum": 0, "maximum": 15000, "type": "integer", "description": "Maximum backoff milliseconds for this run.", "default": 4000 }, "maxFederalRegisterDocuments": { "title": "Maximum Federal Register documents", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum Federal Register documents for this run.", "default": 1 }, "lookbackDays": { "title": "Default Federal Register lookback days", "minimum": 1, "maximum": 365, "type": "integer", "description": "Default Federal Register lookback days for this run.", "default": 30 } } }, "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 } } } } } } } } } } ```