Philadelphia's Air Quality Right Now, and the API Behind It
Today isn't a hypothetical example. Philadelphia is under an actual Code Red air quality alert as this is written — here's what that means, and the free API quietly tracking it live on this site's own Portfolio page.
As of today, Philadelphia's Department of Public Health has designated it a Code Red Air Quality Action Day for particulate matter. The cause is smoke drifting down from a large outbreak of Canadian wildfires, combined with a regional heat wave that's pushed the heat index close to 100°F under an active Heat Advisory. Skies across the city have turned visibly hazy, and the National Weather Service has issued air quality alerts covering Pennsylvania, New Jersey, and Delaware.
This isn't a one-off. Wildfire smoke events like this have become a recurring summer pattern in the Northeast over the past several years, and this site's own Live Air Quality Index widget — sourced from the same category of data the city and National Weather Service use — has been tracking exactly this kind of day live, automatically, without anyone having to remember to check a dashboard.
What "Code Red" actually means
Air quality alerts in the Philadelphia region follow a color-coded scale, similar in spirit to the national AQI scale but tied to specific regional forecasting from the Delaware Valley Regional Planning Commission and state environmental agencies. A Code Red day means some people may experience real health effects from the particulate matter in the air, and sensitive groups — people with heart or lung disease, older adults, children, pregnant people, outdoor workers, and anyone without reliable access to air filtration — face a meaningfully higher risk and are advised to avoid extended outdoor activity.
Reading the actual AQI number
The Air Quality Index itself is a single number, but it's built from the worst-performing pollutant at that moment — often fine particulate matter (PM2.5) during a smoke event, or ground-level ozone on a hot, sunny day with no smoke involved. The general scale:
- 0–50 (Good) — air quality is considered satisfactory, minimal risk.
- 51–100 (Moderate) — acceptable, though unusually sensitive individuals may notice minor effects.
- 101–150 (Unhealthy for Sensitive Groups) — the general public is unlikely to be affected, but at-risk groups should limit prolonged outdoor exertion.
- 151–200 (Unhealthy) — everyone may begin to experience health effects; sensitive groups face more serious risk. Several real-time monitors across the Philadelphia region were reading in this range this morning.
- 201+ (Very Unhealthy / Hazardous) — emergency conditions; the entire population is likely to be affected.
The API actually powering this
The weather and air quality widgets on this site's Portfolio page run on Open-Meteo, a free, keyless weather API — no signup, no rate-limit headaches for a project this size. Two separate endpoints are doing the work:
- Weather Forecast API — current temperature, apparent ("feels like") temperature, humidity, and wind, refreshed automatically.
- Air Quality API — US AQI plus the individual PM2.5 and PM10 readings behind it, which is what actually distinguishes "hazy but fine" from "Code Red."
Both are genuinely live — refresh this site's Portfolio page right now and you'll see today's real numbers for Philadelphia, not a cached screenshot from whenever this post was written.
Where this fits into a bigger picture
A single live widget is a nice demo. The more useful version of this, for an actual business, is the same weather and air quality data landing inside a proper Power BI report — trended over time, cross-referenced against your own operational data (crew hours, delivery delays, incident reports), and refreshed on a schedule instead of checked manually. That's the same pattern as every other live integration on this site: a free, well-documented API, connected once, then quietly doing useful work in the background from then on.
This post describes general public air quality information and is not medical or health advice. If you or someone you're with is experiencing symptoms like trouble breathing, dizziness, or chest discomfort, seek medical attention. For official, up-to-the-minute alerts for your specific location, check the National Weather Service or your state's environmental agency directly rather than relying on any single dashboard, including this one.