Referencia de la API

Pronóstico del tiempo y de la acumulación de contaminación

Las próximas horas de una ciudad, hasta 72: temperatura, viento, humedad, precipitaciones e índice de acumulación de contaminación 0–100 — cuánto retienen las condiciones meteorológicas las partículas cerca del suelo. Una estimación meteorológica, no un pronóstico de PM2.5.

Pronóstico del tiempo y de la acumulación de contaminación

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

Parámetros de consulta

city string opcional

Nombre de la ciudad en cualquiera de los idiomas del sitio, slug (país/ciudad) o id.

country string opcional

Nombre o slug del país, para distinguir ciudades con el mismo nombre.

hours integer opcional

Horas hacia adelante, hasta 72.

Por defecto: 24

lang string opcional

Idioma de los nombres de ciudad y país y del enlace a la página.

Por defecto: 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()

200Respuesta

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