{ "openapi": "3.0.1", "info": { "title": "EPA Data API - ECHO Facility Violations & Compliance Scraper", "description": "Search EPA ECHO for US facilities by state, city, ZIP, NAICS/SIC code or programme (Clean Air Act, Clean Water Act, RCRA). Environmental compliance data: filter for violations and significant noncompliance, and pull inspection and penalty history per facility.", "version": "0.1", "x-build-id": "MQqCPSKOFhtWX7x9E" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/captainhandsome~epa-echo-facility-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-captainhandsome-epa-echo-facility-search", "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/captainhandsome~epa-echo-facility-search/runs": { "post": { "operationId": "runs-sync-captainhandsome-epa-echo-facility-search", "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/captainhandsome~epa-echo-facility-search/run-sync": { "post": { "operationId": "run-sync-captainhandsome-epa-echo-facility-search", "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": { "state": { "title": "State", "type": "string", "description": "Two-letter state code, e.g. RI.", "default": "RI" }, "city": { "title": "City", "type": "string", "description": "City name." }, "county": { "title": "County", "type": "string", "description": "County name." }, "zip": { "title": "ZIP code", "type": "string", "description": "Five-digit ZIP code." }, "facility_name": { "title": "Facility name contains", "type": "string", "description": "Part of the facility name." }, "naics_code": { "title": "NAICS code", "type": "string", "description": "Industry code, e.g. 327910." }, "sic_code": { "title": "SIC code", "type": "string", "description": "Older industry code, e.g. 3496." }, "program": { "title": "Environmental program", "enum": [ "A", "W", "S", "R" ], "type": "string", "description": "Limit to facilities regulated under one programme. Verified by checking which compliance column comes back populated.", "default": "A" }, "major_facilities_only": { "title": "Major facilities only", "type": "boolean", "description": "Only facilities EPA classifies as major emitters or dischargers.", "default": false }, "active_only": { "title": "Active facilities only", "type": "boolean", "description": "Exclude facilities no longer operating.", "default": false }, "include_details": { "title": "Include permit expiry and demographics", "type": "boolean", "description": "Also fetch each facility's detailed report for permit expiration dates, permit universes and the ACS demographic block around the site. Costs one extra request per facility, so runs take noticeably longer. Off by default; the columns are still present, as empty values.", "default": false }, "violations_only": { "title": "Violations only", "type": "boolean", "description": "Keep only facilities currently showing a violation or significant non-compliance. Applied to returned rows: EPA offers no server-side filter for this.", "default": true }, "max_items": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on facilities returned. Also caps your spend.", "default": 10 } } }, "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 } } } } } } } } } }