Entwickler

API-Referenz

Luftqualität jetzt

Der aktuelle Wert (Mittel der letzten Messung jedes Sensors, höchstens 60 Minuten alt, alle 15 Minuten neu berechnet) und der letzte abgeschlossene Tag wie im Data Hub, mit US-EPA-Stufe, Sensornetzwerken und Link zur Stadtseite. Dazu kommt das Wetter jetzt (Temperatur, Luftfeuchtigkeit, Luftdruck, Wind, Bewölkung, Niederschlag) und das Wetter des abgeschlossenen Tages. Eine Stadt wird nach Namen in einer der 25 Sprachen, nach Slug oder ID gefunden oder nach Koordinaten – die nächste Stadt mit Übersicht im Umkreis von 50 km. Bei gleichen Namen country= angeben.

Luftqualität jetzt

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

Abfrageparameter

city string optional

Stadtname in einer der Sprachen der Website, Slug (Land/Stadt) oder ID.

country string optional

Ländername oder Slug, um gleichnamige Städte zu unterscheiden.

lat number optional

Breitengrad, mit lon, statt city: die nächste Stadt mit Zusammenfassung im Umkreis von 50 km.

lon number optional

Längengrad, mit lat.

lang string optional

Sprache der Stadt- und Ländernamen und des Seitenlinks.

Standard: en

GET/air-quality/current?city=germany/berlin
curl "https://api.atmy.ai/v1/air-quality/current?city=germany/berlin"
200Antwort
{
  "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/"
  },
  "now": {
    "status": "current",
    "pm25": 3.8,
    "median": 2.4,
    "min": 0,
    "max": 105.32,
    "unit": "ug/m3",
    "category": {
      "scale": "US_EPA_2024",
      "level": "good",
      "approximate": true
    },
    "sensors": 173,
    "observed": {
      "start": "2026-10-27T10:42:02.000Z",
      "end": "2026-10-27T10:53:14.000Z"
    },
    "updated_at": "2026-10-27T11:00:01.147Z",
    "method": "mean_of_latest_reading_per_sensor_at_most_60_minutes_old"
  },
  "weather": {
    "observed_at": "2026-10-27T11:07:04Z",
    "temperature_c": 14,
    "feels_like_c": 11,
    "humidity_percent": 62,
    "pressure_hpa": 1020,
    "wind_m_s": 3,
    "wind_gust_m_s": 8,
    "wind_direction_deg": 185,
    "clouds_percent": 90,
    "precipitation_mm": 0,
    "condition": "cloudy"
  },
  "completed_day": {
    "date": "2026-10-26",
    "period": "2026-10-26T00:00:00Z/2026-10-27T00:00:00Z",
    "pm25": 4.6,
    "unit": "ug/m3",
    "sensors": 176,
    "category": {
      "scale": "US_EPA_2024",
      "level": "good"
    },
    "method": "datahub_daily",
    "weather": {
      "temperature_c": 9,
      "temperature_min_c": 7.2,
      "temperature_max_c": 13.4,
      "humidity_percent": 73,
      "pressure_hpa": 1014,
      "wind_m_s": 3.2,
      "wind_gust_max_m_s": 11.2,
      "clouds_percent": 44,
      "observations": 7
    }
  },
  "attribution": "Atmy (atmy.ai), aggregated public and citizen sensor networks; approximate values, not official monitoring.",
  "weather_attribution": "Weather: OpenWeatherMap (to 2026-07-08, CC BY-SA 4.0) and Open-Meteo.com (from 2026-07-09, CC BY 4.0), collected by Atmy.",
  "sources": {
    "networks": {
      "Sensor.Community": 169,
      "AirGradient": 4
    },
    "methodology": "https://api.atmy.ai/air-quality/methodology",
    "license": "https://api.atmy.ai/legal/data",
    "city_json": "https://api.atmy.ai/api/public/v1/cities/germany/berlin/air-quality"
  }
}