← clify home · catalogue

airnow API for agents (unofficial) — JSON over curl | clify

AirNow.gov (EPA) U.S. air quality: current and forecast AQI by location, reporting-area and monitor-site history, state tables, national top AQI list, state alerts and site search. The CLI calls airnowgovapi.com and related JSON endpoints directly.

Host: airnow.gov. Call these verified read commands with plain curl; no install, key, or account. Use the public JSON API with plain curl. No install, key, account, or browser is needed. Example: curl 'https://clify-dev.netlify.app/sites.json'. Start with /search?q=weather, then call /abc/COMMAND. Responses are one JSON object. The hosted MCP and GitHub repo are also available.

Commands

suggest-reporting-areas

Autocomplete AirNow reporting area names (e.g. 'Denver-Boulder, CO') from a city name or ZIP fragment Params: term*, maxSuggestions

curl 'https://clify-dev.netlify.app/airnow/suggest-reporting-areas?term=Denver'

geocode-location

Resolve a U.S. city, region or ZIP code to latitude/longitude (x=longitude, y=latitude) for use with get-current-aqi and get-weather Params: location*, maxLocations

curl 'https://clify-dev.netlify.app/airnow/geocode-location?location=94103'

get-current-aqi

Get current observed AQI and today/tomorrow forecasts per pollutant for the reporting area nearest a latitude/longitude Params: latitude*, longitude*, stateCode, maxDistance

curl 'https://clify-dev.netlify.app/airnow/get-current-aqi?latitude=39.738453&longitude=-104.984853&stateCode=CO'

get-reporting-area-location

Get the latitude/longitude of a named reporting area Params: reportingArea*, stateCode*

curl 'https://clify-dev.netlify.app/airnow/get-reporting-area-location?reportingArea=Austin&stateCode=TX'

get-reporting-area-providers

Get the data and forecast provider agencies (with URLs) for a reporting area Params: reportingArea*, stateCode*

curl 'https://clify-dev.netlify.app/airnow/get-reporting-area-providers?reportingArea=Denver-Boulder&stateCode=CO'

get-interpolated-pm25

Get the current interpolated PM2.5 AQI and category for a reporting area Params: reportingArea*, stateCode*

curl 'https://clify-dev.netlify.app/airnow/get-interpolated-pm25'

get-weather

Get current weather (temperature °F, wind, humidity, pressure) at a latitude/longitude Params: latitude*, longitude*

curl 'https://clify-dev.netlify.app/airnow/get-weather?latitude=39.751099&longitude=-104.987198'

get-reporting-area-hourly

Get the last 24 hours of hourly AQI (with dominant pollutant) for a reporting area Params: reportingArea*, stateCode*

curl 'https://clify-dev.netlify.app/airnow/get-reporting-area-hourly'

get-reporting-area-daily

Get the last 30 days of daily AQI (with dominant pollutant) for a reporting area Params: reportingArea*, stateCode*

curl 'https://clify-dev.netlify.app/airnow/get-reporting-area-daily'

get-site-hourly

Get the last 24 hours of hourly AQI and concentrations per pollutant for a monitoring site Params: siteId*

curl 'https://clify-dev.netlify.app/airnow/get-site-hourly'

get-site-daily

Get the last 30 days of daily AQI and concentrations per pollutant for a monitoring site Params: siteId*

curl 'https://clify-dev.netlify.app/airnow/get-site-daily'

list-state-aqi

List current observations and forecasts for every reporting area in a state Params: stateCode*

curl 'https://clify-dev.netlify.app/airnow/list-state-aqi'

get-state-history

Get daily AQI for ozone, PM2.5 and PM10 for every reporting area in a state on a past date Params: state*, year*, month*, day*

curl 'https://clify-dev.netlify.app/airnow/get-state-history'

get-top-aqi

List the U.S. reporting areas with the highest current NowCast AQI Params: none

curl 'https://clify-dev.netlify.app/airnow/get-top-aqi'

list-state-alerts

List states that currently have an AirNow notification (e.g. Wildfires) and its alert type Params: none

curl 'https://clify-dev.netlify.app/airnow/list-state-alerts'

search-site

Keyword search of AirNow.gov pages and documents (EPA search, scoped to www.airnow.gov), 10 results per page Params: q*, start, filter

curl 'https://clify-dev.netlify.app/airnow/search-site?q=wildfire+smoke&filter=filetype_s%3A%22PDF%22'