What it returns
Official air quality data from EPA AirNow, the US government's national air quality system run with state, local and tribal agencies. Covers every US reporting area and US embassy and consulate cities abroad. Updated hourly.
Common uses
Health and fitness apps, smart home and HVAC, real estate and travel sites, schools and outdoor event planning, wildfire smoke alerts and dashboards. Pay per row returned.
Request
POST https://api.pushbuild.com/us-air-quality/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
mode | string: current, forecast, monitors | What to return. Default: "current". |
states | string | Two-letter codes, comma separated, e.g. CA,NY |
city | string | Text match on the reporting area name, e.g. Denver |
near | string | Only areas or monitors within the radius of this point, e.g. 34.05,-118.24 (sorted by distance). |
radiusMiles | number | Used with Near. Default: 50. |
pollutants | list of strings | Empty for all. |
minAqi | integer | Only rows at or above this AQI, e.g. 101 for unhealthy for sensitive groups. |
sort | string: default, worst | Ignored when Near is set. Default: "default". |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/us-air-quality/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.08 per 1,000 readings. No charge for errors or empty searches.
Related APIs
Italy Train Status API: Trenitalia Live Delays API
Live status of Italian trains (Frecciarossa, Intercity, Regionale) from the official ViaggiaTreno feed: every stop with scheduled and actual times, delay and platform, or a station's live departures and arrivals board..
NOAA Buoy Data API
Live and recent observations from about 900 NOAA National Data Buoy Center buoys and coastal stations: wave height and period, wind speed, gusts and direction, water and air temperature, pressure, dew point, visibility and tide.
Private Jet Tracker API: Live Positions & FAA Owners API
Live positions of private and business jets from open ADS-B data, joined to the FAA registry owner: track by tail number, transponder hex, owner name (e.g.
Private Jet Trips API: Flights by Tail, Owner & Airport API
Recent private and business jet trips with departure and arrival airports, times and duration, recorded from open ADS-B data every 10 minutes and joined to FAA registered owners.
Public Holidays API
Public and bank holidays for 100+ countries by year or date range, with regional (state/province) holidays, holiday types, long weekends with bridge days, worldwide upcoming holidays, and an is-it-a-holiday check for any list of dates..
Tide Times API
Official NOAA tide predictions (high/low and hourly), observed water levels, water and air temperature, wind and pressure for 3,000+ US coastal stations.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com