API reference

Weather and pollution accumulation forecast

The next hours of a city, up to 72: temperature, wind, humidity, precipitation and the pollution accumulation index 0–100 — how strongly the weather keeps particles near the ground. A weather estimate, not a PM2.5 forecast.

Weather and pollution accumulation forecast

GEThttps://api.atmy.ai/v1/air-quality/forecast

Query parameters

city string optional

City name in any of the site languages, slug (country/city) or id.

country string optional

Country name or slug, to tell apart cities with the same name.

hours integer optional

Hours ahead, up to 72.

Default: 24

lang string optional

Language of city and country names and of the page link.

Default: en

GET/air-quality/forecast?city=germany/berlin&hours=24

curl "https://api.atmy.ai/v1/air-quality/forecast?city=germany/berlin&hours=24"

const response = await fetch("https://api.atmy.ai/v1/air-quality/forecast?city=germany/berlin&hours=24");
const data = await response.json();

import requests

data = requests.get("https://api.atmy.ai/v1/air-quality/forecast?city=germany/berlin&hours=24").json()

200Response

{
  "city": {
    "id": 50037,
    "slug": "germany/berlin",
    "name": "Berlin",
    "country": "Germany",
    "timezone": "Europe/Berlin",
    "center": {
      "lat": 52.5073,
      "lon": 13.3979
    },
    "page": "https://atmy.ai/air-quality/germany/berlin/"
  },
  "generated_at": "2026-10-27T11:07:04+00:00",
  "local_time": "2026-10-27 12:07",
  "air_now": {
    "value": 3.8,
    "min": 0,
    "max": 105.3,
    "sensors": 173,
    "level": "good",
    "approximate": true,
    "basis": "mean_of_latest_per_sensor",
    "snapshot_at": "2026-10-27T11:00:01.147Z"
  },
  "weather_now": {
    "temp": 14,
    "feels_like": 11,
    "humidity": 62,
    "pressure": 1020,
    "wind": 3,
    "gust": 8,
    "clouds": 90,
    "precipitation": 0,
    "condition": "cloudy",
    "icon": "03d",
    "wind_deg": 185,
    "weather_id": 803
  },
  "hours": [
    {
      "time": "2026-10-27T11:00:00Z",
      "temperature_c": 13,
      "wind_m_s": 3.1,
      "gust_m_s": 7.6,
      "humidity_percent": 63,
      "clouds_percent": 87,
      "precipitation_mm": 0,
      "accumulation_risk": 6
    },
    {
      "time": "2026-10-27T12:00:00Z",
      "temperature_c": 14,
      "wind_m_s": 3.2,
      "gust_m_s": 7.2,
      "humidity_percent": 64,
      "clouds_percent": 77,
      "precipitation_mm": 0,
      "accumulation_risk": 6
    }
  ],
  "accumulation_risk": {
    "scale": "0-100",
    "meaning": "How strongly the weather (calm, inversion, humidity) keeps particles near the ground: low disperses them, high traps them. A weather estimate, not a PM2.5 forecast."
  },
  "methodology": "https://api.atmy.ai/air-quality/methodology"
}