Atmy air quality API

A small public API for AI assistants, agents and developers. It answers from the same aggregation and quality check as the city pages and the Data Hub: no key, read-only, JSON.

Air quality now

The current value (mean of the latest reading of each sensor, at most 60 minutes old, rebuilt every 15 minutes) and the last completed day as in the Data Hub, with the US EPA category, sensor networks and a link to the city page. Find a city by name in any of 17 languages, by slug or id, or by coordinates — the nearest city with a summary within 50 km. Add country= when two cities share a name.

Request

GET https://api.atmy.ai/v1/air-quality/current?city=Krasnoyarsk
GET https://api.atmy.ai/v1/air-quality/current?lat=56.01&lon=92.87

Answer (shortened)

{
  "city": {
    "id": 50003,
    "slug": "russia/krasnoyarsk",
    "name": "Krasnoyarsk",
    "country": "Russia",
    "timezone": "Asia/Krasnoyarsk",
    "page": "https://atmy.ai/air-quality/russia/krasnoyarsk/"
  },
  "now": {
    "status": "current",
    "pm25": 10.5,
    "unit": "ug/m3",
    "category": {
      "scale": "US_EPA_2024",
      "level": "moderate"
    },
    "sensors": 22,
    "updated_at": "2026-10-22T14:00:01Z"
  },
  "completed_day": {
    "date": "2026-10-21",
    "pm25": 13.8,
    "sensors": 21,
    "category": {
      "scale": "US_EPA_2024",
      "level": "moderate"
    }
  },
  "attribution": "Atmy (atmy.ai), aggregated public and citizen sensor networks; approximate values, not official monitoring."
}

Daily history

The Data Hub’s daily means for up to 400 completed days (UTC); a day with too few sensors is missing.

Request

GET https://api.atmy.ai/v1/air-quality/history?city=russia/krasnoyarsk&days=30

Cities

The cities with an Atmy summary, their pages and the request for each of them; filter by country.

Request

GET https://api.atmy.ai/v1/cities?country=serbia

Terms

Read-only, no key, 60 requests a minute per IP. Values are approximate (low-cost sensors, not official monitoring); attribute them as “Atmy (atmy.ai)”. Data terms: atmy.ai/legal/data/.

OpenAPI 3.1 — the machine-readable description agents and code generators use. · llms.txt

Methodology and data sources · City ranking · API · Data terms