# EPA ECHO Facility Compliance & Enforcement Feed (`thoob/epa-echo-facility-feed`) Actor Clean, flat environmental-compliance records for regulated facilities from the official EPA ECHO web services: compliance status, violations, inspections, formal actions, and penalties, with a what-changed-since-last-run mode. Billed only per delivered record. - **URL**: https://apify.com/thoob/epa-echo-facility-feed.md - **Developed by:** [Pono Data](https://apify.com/thoob) (community) - **Categories:** Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $1.00 / 1,000 facility records 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.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 ## EPA ECHO Facility Compliance & Enforcement Feed Clean, flat environmental-compliance records for regulated facilities, pulled from the official EPA ECHO web services. Filter by state, county, and industry, get one useful row per facility with its compliance status, violations, inspections, enforcement actions, and penalties, and run a changes-only mode that returns just what changed since your last run. You pay only for a delivered facility record. Filtered-out rows, unchanged rows in changes mode, and malformed records cost nothing. There is no start fee. ### What a record is One flat row per facility, pulled from the EPA ECHO facility report: - identity and location: `facilityName`, `registryId` (the EPA Facility Registry ID), `street`, `city`, `state`, `zip`, `county`, `latitude`, `longitude` - classification: `naicsCodes`, `sicCodes`, `federalFacilityFlag` - compliance status: `complianceStatus`, plus per-program status for Clean Air Act (`caaComplianceStatus`), Clean Water Act (`cwaComplianceStatus`), hazardous waste / RCRA (`rcraComplianceStatus`), and Safe Drinking Water Act (`sdwaComplianceStatus`) - non-compliance signals: `significantNonComplianceFlag`, `quartersWithNonCompliance`, `programsWithSignificantNonCompliance` - inspections: `inspectionCount`, `lastInspectionDate` - enforcement: `formalActionCount`, `lastFormalActionDate` - penalties: `totalPenalties`, `penaltyCount`, `lastPenaltyDate`, `lastPenaltyAmount` - provenance: `sourceUrl`, `retrievedAt`, `confidence`, `jurisdiction`, `dataSource`, and in changes mode `changeType` Every value appears verbatim at the facility's own ECHO Detailed Facility Report in `sourceUrl`. Dates are normalized to ISO (YYYY-MM-DD) and penalty amounts to numbers. Nothing is guessed. ### Sample output A real slice of Delaware facilities, with one carrying enforcement (abbreviated): | facilityName | city | naicsCodes | complianceStatus | formalActionCount | totalPenalties | sourceUrl | |---|---|---|---|---|---|---| | ADESIS, INC. | NEW CASTLE | 54171 | No Violation Identified | 1 | 10000 | echo.epa.gov/detailed-facility-report?fid=110006816936 | | 1-711 - SALEM CHURCH RD. OVER I-95 | NEWARK | 238320 | No Violation Identified | 0 | 0 | echo.epa.gov/detailed-facility-report?fid=110072036227 | A facility can show "No Violation Identified" as its current headline status while still carrying recent quarters of non-compliance and a past penalty. Both are reported, so you see the full picture, not just the headline. ### Two modes - **full**: every facility matching your filter. - **changes**: only facilities that are new, have a changed compliance status, a new enforcement action or penalty, or a newer inspection date since this account's last run. The state is tracked per account in a named store, so it is your timeline. The first changes run has no baseline, so it returns everything matching once, then tracks deltas from there. ### Filters - **states**: US state or territory codes. ECHO runs one state per query, so this is required; pass one or many. Non-US or invalid codes are turned away unbilled. - **counties**: keep only facilities in these counties. - **naics**: keep only facilities whose NAICS industry code starts with one of these prefixes (for example 3241 for petroleum, 562 for waste management). - **sic**: keep only facilities with one of these legacy SIC codes. - **onlyWithViolations**: keep only facilities the record shows as out of compliance, flagged for significant non-compliance, or carrying quarters of non-compliance. - **onlyActive**: restrict to active facilities (default on) rather than the full historical registry. - **federalOnly**: keep only federal-government facilities. - **maxRecords**: a cap on how many records a run delivers and bills. 0 means no cap; the platform spend cap is honored regardless. ### What to expect - ECHO covers hundreds of thousands of regulated facilities, refreshed by EPA on its own schedule. A filter narrows that to the slice you care about. - The raw ECHO web services are public and free directly from EPA. What this actor sells is the flat, typed record, the client-side industry and violation filtering, and the per-account change feed, so you do not have to walk the service, page its map endpoint one row at a time, or diff it yourself. - A state pull is a few dollars at most; a daily changes feed on one state is pennies a run. ### Source and scope What this collects: public environmental-compliance records on regulated facilities (businesses and government sites). Source: the official EPA ECHO REST web services (echo.epa.gov), a US EPA system, public domain, no key, no anti-bot, called with a declared identifying User-Agent. Scope: United States facilities only. `jurisdiction=US` is stamped on every row. Billing: charged only on a delivered facility record; rejects are free; no start fee. Provenance: every row carries its source URL (the facility's ECHO report) and retrieval time. These are business-level and government-facility public records, not consumer data. This is a data tool, not legal, environmental, or investment advice. A compliance record is a public filing, not a verdict. ### See also More clean, pay-only-for-results data tools from Pono Data: - [Federal Spending Feed](https://apify.com/thoob/federal-spending-feed) - US federal awards from USAspending.gov - [Regulatory Change Monitor](https://apify.com/thoob/regulatory-change-monitor) - federal rulemaking from the Federal Register Full catalog: https://apify.com/thoob # Actor input Schema ## `states` (type: `array`): US state or territory codes to pull facilities for (for example CA, TX, NY). ECHO runs one state per query; this actor loops them. At least one is required. Non-US or invalid codes are turned away unbilled. ## `counties` (type: `array`): Optional. Keep only facilities in these counties (applied by ECHO). County names as ECHO spells them, for example NEW CASTLE. ## `naics` (type: `array`): Optional. Keep only facilities whose NAICS industry code starts with one of these (for example 3241 for petroleum, 562 for waste management). Applied by ECHO and re-checked on the record. ## `sic` (type: `array`): Optional. Keep only facilities with one of these SIC industry codes (legacy classification). Applied by ECHO. ## `onlyWithViolations` (type: `boolean`): When on, keep only facilities the record shows as out of compliance, flagged for significant non-compliance, or carrying quarters of non-compliance. Off returns every matching facility regardless of status. ## `onlyActive` (type: `boolean`): When on (default), restrict to facilities ECHO marks active, rather than the full historical registry which includes closed sites. ## `federalOnly` (type: `boolean`): When on, keep only federal-government facilities. Off returns all facility types. ## `mode` (type: `string`): full returns every facility matching your filter. changes returns only facilities that are new, have a changed compliance status, a new enforcement action or penalty, or a newer inspection since this account's last run, tracked per account. The first changes run has no baseline, so it returns everything matching once, then tracks deltas. ## `maxRecords` (type: `integer`): Safety cap on how many facilities this run delivers and bills. 0 means no cap. In changes mode, facilities beyond the cap are not dropped: they are delivered on a later run, never billed twice. The platform spend cap (ACTOR_MAX_TOTAL_CHARGE_USD) is honored regardless. ## Actor input object example ```json { "states": [ "DE" ], "counties": [], "naics": [], "sic": [], "onlyWithViolations": false, "onlyActive": true, "federalOnly": false, "mode": "full", "maxRecords": 0 } ```` # Actor output Schema ## `facilities` (type: `string`): One row per regulated facility matching your filter. # 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 = { "states": [ "DE" ], "counties": [], "naics": [], "sic": [] }; // Run the Actor and wait for it to finish const run = await client.actor("thoob/epa-echo-facility-feed").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 = { "states": ["DE"], "counties": [], "naics": [], "sic": [], } # Run the Actor and wait for it to finish run = client.actor("thoob/epa-echo-facility-feed").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 '{ "states": [ "DE" ], "counties": [], "naics": [], "sic": [] }' | apify call thoob/epa-echo-facility-feed --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=thoob/epa-echo-facility-feed", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "EPA ECHO Facility Compliance & Enforcement Feed", "description": "Clean, flat environmental-compliance records for regulated facilities from the official EPA ECHO web services: compliance status, violations, inspections, formal actions, and penalties, with a what-changed-since-last-run mode. Billed only per delivered record.", "version": "0.0", "x-build-id": "nqybxWwOe5xJ6TPSS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thoob~epa-echo-facility-feed/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thoob-epa-echo-facility-feed", "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/thoob~epa-echo-facility-feed/runs": { "post": { "operationId": "runs-sync-thoob-epa-echo-facility-feed", "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/thoob~epa-echo-facility-feed/run-sync": { "post": { "operationId": "run-sync-thoob-epa-echo-facility-feed", "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": [ "states" ], "properties": { "states": { "title": "US states", "maxItems": 60, "type": "array", "description": "US state or territory codes to pull facilities for (for example CA, TX, NY). ECHO runs one state per query; this actor loops them. At least one is required. Non-US or invalid codes are turned away unbilled.", "items": { "type": "string" } }, "counties": { "title": "Counties", "type": "array", "description": "Optional. Keep only facilities in these counties (applied by ECHO). County names as ECHO spells them, for example NEW CASTLE.", "items": { "type": "string" } }, "naics": { "title": "NAICS code prefixes", "type": "array", "description": "Optional. Keep only facilities whose NAICS industry code starts with one of these (for example 3241 for petroleum, 562 for waste management). Applied by ECHO and re-checked on the record.", "items": { "type": "string" } }, "sic": { "title": "SIC codes", "type": "array", "description": "Optional. Keep only facilities with one of these SIC industry codes (legacy classification). Applied by ECHO.", "items": { "type": "string" } }, "onlyWithViolations": { "title": "Only facilities with current violations", "type": "boolean", "description": "When on, keep only facilities the record shows as out of compliance, flagged for significant non-compliance, or carrying quarters of non-compliance. Off returns every matching facility regardless of status.", "default": false }, "onlyActive": { "title": "Only active facilities", "type": "boolean", "description": "When on (default), restrict to facilities ECHO marks active, rather than the full historical registry which includes closed sites.", "default": true }, "federalOnly": { "title": "Only federal facilities", "type": "boolean", "description": "When on, keep only federal-government facilities. Off returns all facility types.", "default": false }, "mode": { "title": "Mode", "enum": [ "full", "changes" ], "type": "string", "description": "full returns every facility matching your filter. changes returns only facilities that are new, have a changed compliance status, a new enforcement action or penalty, or a newer inspection since this account's last run, tracked per account. The first changes run has no baseline, so it returns everything matching once, then tracks deltas.", "default": "full" }, "maxRecords": { "title": "Max delivered records", "minimum": 0, "maximum": 500000, "type": "integer", "description": "Safety cap on how many facilities this run delivers and bills. 0 means no cap. In changes mode, facilities beyond the cap are not dropped: they are delivered on a later run, never billed twice. The platform spend cap (ACTOR_MAX_TOTAL_CHARGE_USD) is honored regardless.", "default": 0 } } }, "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 } } } } } } } } } } ```