Referência da API

Histórico

As médias diárias de uma cidade para qualquer período desde 2017 e todo o seu histórico por mês, com médias anuais e recordes.

Histórico diário

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

As médias diárias do Data Hub (UTC): os últimos dias com days= ou qualquer período desde 2017 com from= e to=, até 400 dias por requisição; falta um dia com poucos sensores. A partir de 2026-01-19, cada dia traz também o seu tempo: temperatura média, mínima e máxima, umidade, pressão, vento, rajada mais forte e nebulosidade.

Parâmetros de consulta

city string opcional

Nome da cidade em qualquer um dos idiomas do site, slug (país/cidade) ou id.

country string opcional

Nome ou slug do país, para distinguir cidades com o mesmo nome.

days integer opcional

Dias para trás a partir do último dia completo; ignorado com from e to.

Padrão: 30

from date opcional

Primeiro dia (UTC), 2017-01-01 ou depois.

to date opcional

Último dia (UTC); por padrão o último dia completo. No máximo 400 dias por solicitação.

lang string opcional

Idioma dos nomes de cidade e país e do link da página.

Padrão: 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()

200Resposta

{
  "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."
}

Histórico mensal

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

Todo o histórico de medições de uma cidade por mês: médias anuais (anos completos marcados), os meses e dias mais poluídos e mais limpos. Valores baseados nas médias diárias da própria rede de sensores são marcados. A partir de janeiro de 2026, cada mês traz também o seu tempo.