# EPA ECHO Compliance & Enforcement Scraper - Facility API (`pink_comic/epa-echo-facility-compliance-enforcement`) Actor Search official EPA ECHO facility compliance, inspection, enforcement, penalty, permit, emissions, and environmental-justice evidence. Filter by facility, FRS/program ID, geography, NAICS, program, violation status, enforcement, or penalty history. - **URL**: https://apify.com/pink\_comic/epa-echo-facility-compliance-enforcement.md - **Developed by:** [Ava Torres](https://apify.com/pink_comic) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results 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 ## EPA ECHO Compliance & Enforcement Facility Scraper API Search official U.S. Environmental Protection Agency ECHO facility evidence without an API key. Find regulated facilities by name, exact EPA FRS registry ID, environmental program ID, geography, NAICS, media program, compliance status, inspection history, enforcement activity, penalties, TRI reporting, or impaired-water discharge flag. Built for environmental due diligence, supplier and site screening, ESG research, compliance monitoring, insurance and credit review, legal research, community-impact analysis, and public-record enrichment. ### Fast first run Click **Start** with the prefilled input. It returns up to 25 active Texas facilities currently in significant noncompliance with reported five-year penalties, sorted by total penalties. Clear `state` or change any filters for your workflow. ```json { "state": "TX", "activeOnly": true, "compliance": "significant", "penaltyFilter": "any", "sortBy": "highestPenalty", "maxResults": 25 } ```` ### High-value searches #### Exact facility evidence by EPA FRS ID ```json { "registryId": "110067678622" } ``` An exact `registryId` takes precedence over all other filters and returns at most one record. #### Company facilities in one state ```json { "facilityName": "Exxon", "nameSearchType": "contains", "state": "TX", "media": "air", "activeOnly": true, "compliance": "any", "penaltyFilter": "any", "sortBy": "highestPenalty", "maxResults": 50 } ``` #### Recent enforcement and penalties ```json { "state": "LA", "formalEnforcement5Years": true, "penaltyFilter": "within36", "sortBy": "latestEnforcement", "maxResults": 100 } ``` #### Current TRI reporters in an industry ```json { "state": "OH", "naics": "325", "media": "tri", "currentTriReporter": true, "compliance": "any", "penaltyFilter": "any", "sortBy": "highestTriReleases", "maxResults": 100 } ``` ### What each facility can include The actor emits stable, normalized fields for: - identity: facility name, FRS registry ID, address, county/FIPS, EPA region, coordinates and coordinate-quality metadata - program coverage: Clean Air Act, NPDES/Clean Water Act, RCRA hazardous waste, drinking water, TRI, and GHG flags and program IDs - compliance: current integrated and program-level status, significant-noncompliance flags, programs in significant noncompliance, and quarter histories - inspections: integrated and program-level counts, latest inspection, and days since inspection - enforcement: formal and informal action counts and dates, plus federal enforcement case evidence - penalties: integrated and program-level five-year totals, count, latest date, and latest amount - releases and risk context: TRI releases/transfers, GHG CO2e, impaired-water and nonattainment flags, and selected EJScreen indicators - provenance: official EPA detailed-facility-report URL, retrieval time, source refresh caveat, query count, and screening disclaimer No-match searches return one explicit `NO_MATCHING_FACILITIES` item rather than an ambiguous empty dataset. Temporary official-source failures return `SOURCE_UNAVAILABLE` evidence and do not pretend that no facility exists. ### Source and refresh cadence Data comes from EPA's official public **ECHO Facilities ArcGIS map service**, which is refreshed from ECHO's integrated facility data on a weekly cadence. ECHO combines federal and state program systems; each underlying system has its own reporting schedule and can lag. Official source and bulk-data documentation: [EPA ECHO data downloads](https://echo.epa.gov/tools/data-downloads#exporter) ### Important interpretation limits - ECHO is screening and research evidence, not a substitute for reviewing permits, enforcement documents, consent decrees, or the responsible agency's case file. - A violation or significant-noncompliance indicator may represent alleged or agency-identified conditions and does not by itself prove final liability or adjudication. - Five-year counts and totals use ECHO's current reporting windows and source definitions. - Null fields usually mean that the source did not report that measure for the facility or program; they do not prove zero activity. - Coordinates can have different collection methods and accuracy. Use `coordinateAccuracyMeters` and the official detailed report before property-level conclusions. - Exact identifiers are stronger evidence than name-only matches. Verify material decisions against `sourceRecordUrl` and the relevant EPA/state program. ### Pricing This actor uses pay-per-event pricing. Check the live Apify Store pricing panel for the current per-start and per-result rates. # Actor input Schema ## `facilityName` (type: `string`): Facility-name search term. Use nameSearchType to choose contains, begins-with, or exact matching. ## `nameSearchType` (type: `string`): How facilityName is matched. ## `registryId` (type: `string`): Exact 12-digit Facility Registry Service ID. Takes precedence over every other filter and returns at most one record. ## `programId` (type: `string`): Search an AIR, NPDES, RCRA, SDWA, TRI, or GHG program identifier. ## `street` (type: `string`): Case-insensitive street-address substring. ## `city` (type: `string`): Exact city name, case-insensitive. ## `county` (type: `string`): Exact county name, case-insensitive. ## `state` (type: `string`): Two-letter abbreviation, such as TX, CA, or PR. Clear TX to search nationwide. ## `zipCode` (type: `string`): Exact five-digit facility ZIP code. ## `countyFips` (type: `string`): Exact five-digit county FIPS code. ## `epaRegion` (type: `string`): Exact two-digit EPA region, 01 through 10. ## `naics` (type: `string`): Two- through six-digit NAICS prefix or full code. ## `media` (type: `string`): Require participation in a specific environmental program. ## `activeOnly` (type: `boolean`): Require the ECHO facility to be active. ## `majorOnly` (type: `boolean`): Require ECHO's major-facility flag. ## `compliance` (type: `string`): Filter current or recent noncompliance indicators. ## `formalEnforcement5Years` (type: `boolean`): Require at least one formal enforcement action in ECHO's five-year history window. ## `informalEnforcement5Years` (type: `boolean`): Require at least one informal enforcement action in ECHO's five-year history window. ## `inspectedWithinYears` (type: `integer`): Require a reported inspection within 1 to 5 years. Zero disables the filter. ## `penaltyFilter` (type: `string`): Filter facilities by reported five-year penalty history or latest penalty date. ## `currentTriReporter` (type: `boolean`): Require current Toxic Release Inventory reporting status. ## `dischargesToImpairedWater` (type: `boolean`): Require ECHO's impaired-water discharge flag. ## `sortBy` (type: `string`): Order the complete filtered result set before applying maxResults. ## `maxResults` (type: `integer`): Total response cap after all filters and sorting are applied. ## Actor input object example ```json { "nameSearchType": "contains", "state": "TX", "media": "all", "activeOnly": true, "majorOnly": false, "compliance": "significant", "formalEnforcement5Years": false, "informalEnforcement5Years": false, "inspectedWithinYears": 0, "penaltyFilter": "any", "currentTriReporter": false, "dischargesToImpairedWater": false, "sortBy": "highestPenalty", "maxResults": 25 } ``` # 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 = { "nameSearchType": "contains", "state": "TX", "media": "all", "activeOnly": true, "majorOnly": false, "compliance": "significant", "formalEnforcement5Years": false, "informalEnforcement5Years": false, "inspectedWithinYears": 0, "penaltyFilter": "any", "currentTriReporter": false, "dischargesToImpairedWater": false, "sortBy": "highestPenalty", "maxResults": 25 }; // Run the Actor and wait for it to finish const run = await client.actor("pink_comic/epa-echo-facility-compliance-enforcement").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 = { "nameSearchType": "contains", "state": "TX", "media": "all", "activeOnly": True, "majorOnly": False, "compliance": "significant", "formalEnforcement5Years": False, "informalEnforcement5Years": False, "inspectedWithinYears": 0, "penaltyFilter": "any", "currentTriReporter": False, "dischargesToImpairedWater": False, "sortBy": "highestPenalty", "maxResults": 25, } # Run the Actor and wait for it to finish run = client.actor("pink_comic/epa-echo-facility-compliance-enforcement").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 '{ "nameSearchType": "contains", "state": "TX", "media": "all", "activeOnly": true, "majorOnly": false, "compliance": "significant", "formalEnforcement5Years": false, "informalEnforcement5Years": false, "inspectedWithinYears": 0, "penaltyFilter": "any", "currentTriReporter": false, "dischargesToImpairedWater": false, "sortBy": "highestPenalty", "maxResults": 25 }' | apify call pink_comic/epa-echo-facility-compliance-enforcement --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=pink_comic/epa-echo-facility-compliance-enforcement", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "EPA ECHO Compliance & Enforcement Scraper - Facility API", "description": "Search official EPA ECHO facility compliance, inspection, enforcement, penalty, permit, emissions, and environmental-justice evidence. Filter by facility, FRS/program ID, geography, NAICS, program, violation status, enforcement, or penalty history.", "version": "0.1", "x-build-id": "WGFGxON3AhN1eKr42" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pink_comic~epa-echo-facility-compliance-enforcement/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pink_comic-epa-echo-facility-compliance-enforcement", "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/pink_comic~epa-echo-facility-compliance-enforcement/runs": { "post": { "operationId": "runs-sync-pink_comic-epa-echo-facility-compliance-enforcement", "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/pink_comic~epa-echo-facility-compliance-enforcement/run-sync": { "post": { "operationId": "run-sync-pink_comic-epa-echo-facility-compliance-enforcement", "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": { "facilityName": { "title": "Facility Name", "minLength": 2, "type": "string", "description": "Facility-name search term. Use nameSearchType to choose contains, begins-with, or exact matching." }, "nameSearchType": { "title": "Facility Name Match", "enum": [ "contains", "begins", "exact" ], "type": "string", "description": "How facilityName is matched.", "default": "contains" }, "registryId": { "title": "Exact EPA FRS Registry ID", "pattern": "^[0-9]{12}$", "type": "string", "description": "Exact 12-digit Facility Registry Service ID. Takes precedence over every other filter and returns at most one record." }, "programId": { "title": "EPA Program ID", "pattern": "^[A-Za-z0-9._-]{3,40}$", "type": "string", "description": "Search an AIR, NPDES, RCRA, SDWA, TRI, or GHG program identifier." }, "street": { "title": "Street Address Contains", "type": "string", "description": "Case-insensitive street-address substring." }, "city": { "title": "City", "type": "string", "description": "Exact city name, case-insensitive." }, "county": { "title": "County", "type": "string", "description": "Exact county name, case-insensitive." }, "state": { "title": "State or Territory", "pattern": "^[A-Za-z]{2}$", "type": "string", "description": "Two-letter abbreviation, such as TX, CA, or PR. Clear TX to search nationwide.", "default": "TX" }, "zipCode": { "title": "ZIP Code", "pattern": "^[0-9]{5}$", "type": "string", "description": "Exact five-digit facility ZIP code." }, "countyFips": { "title": "County FIPS", "pattern": "^[0-9]{5}$", "type": "string", "description": "Exact five-digit county FIPS code." }, "epaRegion": { "title": "EPA Region", "pattern": "^(0[1-9]|10)$", "type": "string", "description": "Exact two-digit EPA region, 01 through 10." }, "naics": { "title": "NAICS Code", "pattern": "^[0-9]{2,6}$", "type": "string", "description": "Two- through six-digit NAICS prefix or full code." }, "media": { "title": "Environmental Program", "enum": [ "all", "air", "water", "hazardous_waste", "drinking_water", "tri", "ghg" ], "type": "string", "description": "Require participation in a specific environmental program.", "default": "all" }, "activeOnly": { "title": "Active Facilities Only", "type": "boolean", "description": "Require the ECHO facility to be active.", "default": true }, "majorOnly": { "title": "Major Facilities Only", "type": "boolean", "description": "Require ECHO's major-facility flag.", "default": false }, "compliance": { "title": "Compliance Status", "enum": [ "any", "noncompliance", "significant", "multiple" ], "type": "string", "description": "Filter current or recent noncompliance indicators.", "default": "significant" }, "formalEnforcement5Years": { "title": "Formal Enforcement in Last 5 Years", "type": "boolean", "description": "Require at least one formal enforcement action in ECHO's five-year history window.", "default": false }, "informalEnforcement5Years": { "title": "Informal Enforcement in Last 5 Years", "type": "boolean", "description": "Require at least one informal enforcement action in ECHO's five-year history window.", "default": false }, "inspectedWithinYears": { "title": "Inspected Within Years", "minimum": 0, "maximum": 5, "type": "integer", "description": "Require a reported inspection within 1 to 5 years. Zero disables the filter.", "default": 0 }, "penaltyFilter": { "title": "Penalty History", "enum": [ "any", "never", "within12", "within36", "within60" ], "type": "string", "description": "Filter facilities by reported five-year penalty history or latest penalty date.", "default": "any" }, "currentTriReporter": { "title": "Current TRI Reporter", "type": "boolean", "description": "Require current Toxic Release Inventory reporting status.", "default": false }, "dischargesToImpairedWater": { "title": "Discharges to Impaired Water", "type": "boolean", "description": "Require ECHO's impaired-water discharge flag.", "default": false }, "sortBy": { "title": "Sort Results", "enum": [ "highestPenalty", "latestPenalty", "latestInspection", "latestEnforcement", "mostNoncompliance", "highestTriReleases", "name" ], "type": "string", "description": "Order the complete filtered result set before applying maxResults.", "default": "highestPenalty" }, "maxResults": { "title": "Maximum Facilities", "minimum": 1, "maximum": 500, "type": "integer", "description": "Total response cap after all filters and sorting are applied.", "default": 25 } } }, "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 } } } } } } } } } } ```