API リファレンス

履歴

2017 年以降の任意の期間の都市の日平均と、年平均や記録を含む月別の全履歴。

日別の履歴

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

Data Hubの日平均（UTC）。days=で直近の日数、またはfrom=とto=で2017年以降の任意の期間を指定できます（1回のリクエストで最大400日）。センサーが少なすぎる日は含まれません。2026-01-19 以降、各日にはその日の天気も含まれます：平均・最低・最高気温、湿度、気圧、風、最大瞬間風速、雲量。

クエリパラメーター

city string 任意

サイトのいずれかの言語での都市名、slug（国/都市）、または id。

country string 任意

同名の都市を区別するための国名または slug。

days integer 任意

直近の完了日からさかのぼる日数。from と to を指定すると無視されます。

既定値: 30

from date 任意

最初の日（UTC）、2017-01-01 以降。

to date 任意

最後の日（UTC）。既定は直近の完了日。1 回 400 日まで。

lang string 任意

都市名・国名とページリンクの言語。

既定値: en

GET/air-quality/history?city=germany/berlin&days=30

curl "https://api.atmy.ai/v1/air-quality/history?city=germany/berlin&days=30"

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

import requests

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

200レスポンス

{
  "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/"
  },
  "unit": "ug/m3",
  "method": "datahub_daily",
  "period_timezone": "UTC",
  "category_scale": "US_EPA_2024",
  "from": "2026-10-24",
  "to": "2026-10-26",
  "available_since": "2017-01-01",
  "days": [
    {
      "date": "2026-10-24",
      "pm25": 3.4,
      "sensors": 172,
      "level": "good",
      "weather": {
        "temperature_c": 10.1,
        "temperature_min_c": 6.7,
        "temperature_max_c": 14.7,
        "humidity_percent": 71,
        "pressure_hpa": 1010,
        "wind_m_s": 4.3,
        "wind_gust_max_m_s": 12.7,
        "clouds_percent": 83,
        "observations": 7
      }
    },
    {
      "date": "2026-10-25",
      "pm25": 3.9,
      "sensors": 174,
      "level": "good",
      "weather": {
        "temperature_c": 9.8,
        "temperature_min_c": 7.2,
        "temperature_max_c": 14.6,
        "humidity_percent": 72,
        "pressure_hpa": 1002,
        "wind_m_s": 5,
        "wind_gust_max_m_s": 14.7,
        "clouds_percent": 86,
        "observations": 7
      }
    },
    {
      "date": "2026-10-26",
      "pm25": 4.6,
      "sensors": 176,
      "level": "good",
      "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
      }
    }
  ],
  "weather_since": "2026-01-19",
  "weather_notes": "weather: means of the readings Atmy stored for the city on the UTC day (observations: how many); temperature_min_c and temperature_max_c are the lowest and highest the provider reported for the day; wind_gust_max_m_s the strongest gust. No precipitation sum: the readings are instants.",
  "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."
}

月別の履歴

GEThttps://api.atmy.ai/v1/air-quality/history/monthly

都市の測定履歴全体を月ごとに：年平均（完全な年に印付き）、最も汚れた月と日、最もきれいな月と日。センサーネットワーク自体の日平均に基づく値には印が付きます。2026年1月以降、各月にはその月の天気も含まれます。