ATMOS API
OperationalATMOS — Climate & Air Quality Intelligence
Clean, aggregated air-quality and climate intelligence for any location — current conditions, 5-day forecasts, decades of history, and an explainable 0–100 risk score — unified from Open-Meteo, OpenAQ, and EPA AirNow into one fast, honest API.
{
"status": "ok",
"location": { "name": "Port of Spain, TT", "lat": 10.6667, "lon": -61.5189 },
"data": {
"aqi_us": 42,
"category": "Good",
"dominant_pollutant": "pm25",
"pollutants": { "pm25": 9.4, "o3": 61.2 },
"health_guidance": "Air quality is good — ideal for outdoor activity."
},
"sources": ["openaq", "open-meteo"],
"generated_at": "2026-07-18T14:00:00Z"
}THE GAP
Why another climate API?
Existing providers leave real gaps. Here's what ATMOS does differently.
Four sources, one call
Air and climate data is scattered across government and open datasets — each with its own format, station IDs, and units. ATMOS unifies Open-Meteo, OpenAQ, and EPA AirNow behind a single, consistent JSON API.
Explainable risk, not a black box
Every risk subscore is a documented linear map of a real measured quantity against a fixed reference range — deterministic and reproducible. No opaque ML, no invented precision.
Honest by design
The `sources` array on every response is always accurate. If an upstream is down with no cached data, ATMOS returns a 503 — it never fabricates numbers.
Fast, cached responses
Responses are served from a local cache (typically well under 300 ms), not by proxying upstream on every request — with a scheduler keeping hot locations fresh.
CAPABILITIES
Everything you need to ship air & climate features
Real-time AQI (US + EU)
Merges the nearest OpenAQ ground station with the Open-Meteo CAMS model — pollutants, dominant pollutant, and plain-English health guidance. `measurement_type` tells you which.
Forecasts & history
5-day air-quality forecast with daily max AQI, plus up to 365 days of AQI/PM2.5 history with an unhealthy-day count and trend.
Decades of climate data
Per-year temperature, precipitation, and extreme-heat aggregates back to 1970 — plus computed warming, precipitation, and extreme-heat-day trends.
Explainable risk score
A composite 0–100 climate-risk score with A–F subscores for heat, air quality, and precipitation volatility — each with a one-sentence explanation of the numbers behind it.
API REFERENCE
9 endpoints across four groups
Air quality, climate, risk, and meta — each with parameters, example responses, and copy-paste code.
Current conditions, 5-day forecast, and historical air quality by location.
Current AQI (US + European), pollutants, dominant pollutant, and health guidance — nearest OpenAQ station blended with the Open-Meteo CAMS model.
Parameters
| Param | Type | Required | Description |
|---|---|---|---|
| location | string | optional | Free-text place name (geocoded & cached). Use this OR lat + lon.e.g. Port of Spain |
| lat | number | optional | Latitude (use with lon).e.g. 10.6667 |
| lon | number | optional | Longitude (use with lat).e.g. -61.5189 |
Example response
{
"status": "ok",
"location": { "name": "Port of Spain, TT", "lat": 10.6667, "lon": -61.5189 },
"data": {
"aqi_us": 42,
"aqi_eu": 2,
"category": "Good",
"dominant_pollutant": "pm25",
"pollutants": { "pm25": 9.4, "pm10": 16.1, "o3": 61.2, "no2": 22.8, "so2": 1.1, "co": 210 },
"health_guidance": "Air quality is good — ideal for outdoor activity.",
"measurement_type": "station"
},
"sources": ["openaq", "open-meteo"],
"generated_at": "2026-07-18T14:00:00Z"
}Request
curl --request GET \
--url 'https://atmos-climate-air-quality-intelligence.p.rapidapi.com/v1/air/current?location=Port%20of%20Spain' \
--header 'X-RapidAPI-Key: YOUR_KEY' \
--header 'X-RapidAPI-Host: atmos-climate-air-quality-intelligence.p.rapidapi.com'Use cases
- Show a live AQI badge in a weather or travel app
- Warn sensitive users when PM2.5 crosses a threshold
- Enrich IoT dashboards with reference-grade data
TRY IT
Request in, answer out
curl --request GET \
--url 'https://atmos-climate-air-quality-intelligence.p.rapidapi.com/v1/air/current?location=Port%20of%20Spain' \
--header 'X-RapidAPI-Key: YOUR_KEY' \
--header 'X-RapidAPI-Host: atmos-climate-air-quality-intelligence.p.rapidapi.com'{
"status": "ok",
"location": { "name": "Port of Spain, TT", "lat": 10.6667, "lon": -61.5189 },
"data": {
"aqi_us": 42,
"aqi_eu": 2,
"category": "Good",
"dominant_pollutant": "pm25",
"pollutants": { "pm25": 9.4, "pm10": 16.1, "o3": 61.2, "no2": 22.8, "so2": 1.1, "co": 210 },
"health_guidance": "Air quality is good — ideal for outdoor activity.",
"measurement_type": "station"
},
"sources": ["openaq", "open-meteo"],
"generated_at": "2026-07-18T14:00:00Z"
}Want to test live? Try it in the RapidAPI console.
Open in RapidAPIPRICING
Indie-friendly from day one
Start free with 100 calls a month. Subscribe to any plan on RapidAPI — no enterprise sales call.
BASIC
100 / month
- All 9 endpoints
- Composite risk score
- No card required
- Great for evaluation
MEGA
1,000,000 / month
- Everything in Ultra
- High-volume / enterprise
- Custom terms available
How ATMOS stacks up
More data, clearer methodology, indie pricing — versus the usual options.
| Feature | ATMOS | OpenWeatherMap | Tomorrow.io |
|---|---|---|---|
| Air quality included | add-on | ||
| Explainable risk scoring | |||
| Decades of climate history | limited | enterprise | |
| Transparent, cited sources | |||
| Entry price | $9/mo | $40/mo | $0–custom |
TRANSPARENCY
Know exactly where your data comes from
| Source | Coverage | Updates | Cost |
|---|---|---|---|
| Open-Meteo | Global weather, CAMS air-quality model, and climate archive (keyless) | Hourly | Open data |
| OpenAQ | Global ground-station air-quality measurements | Hourly | Open data |
| EPA AirNow | Authoritative US air-quality index | Hourly | Open data |
NO BLACK BOXES
How the risk score works
Every subscore is a linear map of a real measured quantity against a fixed, documented reference range — deterministic and reproducible. The composite is 0.40·heat + 0.35·air + 0.25·precip; if a component can't be computed, its weight is dropped and the rest renormalized. Heat blends 20-year extreme-heat days (0→90) and the warming trend (0→0.6 °C/decade) 70/30; air blends mean US AQI (25→150) and unhealthy-day share (0→30%) 60/40; precipitation uses the 20-year coefficient of variation (0.10→0.50).
score = 0.40·heat + 0.35·air + 0.25·precip
Grade scale
FAQ
Questions, answered
Subscribe to any plan on RapidAPI — including the free BASIC tier — and your key is issued instantly in your RapidAPI dashboard. No card required for the free tier.
100 free calls. No card required.
Get an API key today and start building air & climate features.