{ "openapi": "3.0.1", "info": { "title": "EPA Air Quality Index Scraper", "description": "Scrape US EPA annual Air Quality Index (AQI) data from the public EPA AQS database - no API key required. Get AQI statistics, pollutant breakdowns (PM2.5, PM10, ozone, NO2, CO), and health category day counts for US counties, metro areas (CBSAs), and states. Historical data from 1980 to present.", "version": "1.0", "x-build-id": "txpOqprG3pBfg0dyb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~epa-air-quality-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-epa-air-quality-scraper", "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/crawlerbros~epa-air-quality-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-epa-air-quality-scraper", "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/crawlerbros~epa-air-quality-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-epa-air-quality-scraper", "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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "byCounty", "byMetro", "byState" ], "type": "string", "description": "What geographic level to scrape.", "default": "byCounty" }, "year": { "title": "Year", "minimum": 1980, "maximum": 2024, "type": "integer", "description": "Calendar year for which to fetch AQI data. EPA publishes data for 1980–present. Defaults to most recent available year (2024).", "default": 2024 }, "years": { "title": "Multiple years", "type": "array", "description": "Fetch data for multiple years in one run. Each year produces separate records. Leave empty to use the single `year` field.", "default": [], "items": { "type": "string" } }, "stateFilter": { "title": "State filter", "type": "string", "description": "Only include records for this US state name (e.g. `California`, `Texas`). Case-insensitive. Leave empty for all states." }, "minMedianAqi": { "title": "Min median AQI", "minimum": 0, "maximum": 500, "type": "integer", "description": "Only include records where Median AQI is at or above this value (e.g. 50)." }, "maxMedianAqi": { "title": "Max median AQI", "minimum": 0, "maximum": 500, "type": "integer", "description": "Only include records where Median AQI is at or below this value." }, "minDaysWithAqi": { "title": "Min days with AQI data", "minimum": 1, "maximum": 366, "type": "integer", "description": "Only include records with at least this many days of AQI monitoring." }, "minMaxAqi": { "title": "Min max AQI", "minimum": 0, "maximum": 500, "type": "integer", "description": "Only include records where Max AQI is at or above this value (useful for finding worst-air-quality areas)." }, "pollutantFilter": { "title": "Dominant pollutant filter", "enum": [ "", "co", "no2", "ozone", "pm25", "pm10" ], "type": "string", "description": "Only include records where this pollutant has the most monitoring days.", "default": "" }, "sortBy": { "title": "Sort results by", "enum": [ "medianAqi", "maxAqi", "unhealthyDays", "goodDays", "daysWithAqi", "state" ], "type": "string", "description": "Field to sort records by (descending). Applied after filtering.", "default": "medianAqi" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of records to emit.", "default": 500 } } }, "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 } } } } } } } } } }