API de calidad del aire: previsiones, AQI y valores medidos

Partículas, gases, UV y los índices de calidad del aire europeo y estadounidense para cualquier lugar del planeta, hora a hora hasta cinco días, además del polen en Europa. Junto a la previsión, la misma clave te da lo que miden ahora mismo las estaciones oficiales y los sensores ciudadanos cercanos.

curl "https://geo.runningcat.dev/v1/air?lon=6.869&lat=45.924&hours=48" \
  -H "Authorization: Bearer YOUR_KEY"
Ejemplo de solicitud

Previsión para un punto

{
  "lon": 6.869, "lat": 45.924,
  "current": { "time": "2026-11-07T17:00:00Z", "pm25": 6.3, "pm10": 7.5,
               "nitrogenDioxide": 5.3, "ozone": 51, "sulphurDioxide": 0.2, "carbonMonoxide": 154,
               "dust": 0, "uvIndex": 0, "europeanAqi": 23, "usAqi": 27,
               "alderPollen": 0, "birchPollen": 0, "grassPollen": 0,
               "mugwortPollen": 0, "olivePollen": 0, "ragweedPollen": 0 },
  "hourly": [ { "time": "2026-11-07T17:00:00Z", "pm25": 6.3, ... }, ... ]
}
Horas
de 1 a 120, por defecto 48
Contaminantes
PM2.5, PM10, dióxido de nitrógeno, ozono, dióxido de azufre, monóxido de carbono y polvo, en µg/m³; sobre Europa también amoníaco
Índices
AQI europeo y AQI estadounidense, y el índice UV
Polen
Aliso, abedul, gramíneas, artemisa, olivo y ambrosía, en granos por m³, en Europa; consulta la API de polen

Las previsiones proceden del Servicio de Vigilancia de la Atmósfera de Copernicus (CAMS): su modelo europeo para Europa y su modelo global para el resto del mundo.

Sobre un área

GET /v1/air/area?bbox=west,south,east,north&cells=&hours= devuelve todos los valores en una cuadrícula de hasta 400 celdas, hora a hora, para mapas de humo, polvo u ozono sobre una región. Usa la misma cuadrícula que la petición de tiempo por área.

Lo que miden ahora las estaciones

Una previsión es un modelo. Para saber cómo está el aire en este momento, /v1/air/stations lista las estaciones cercanas a un punto, dentro de un recuadro o a lo largo de una ruta, cada una con sus últimos valores horarios y sus últimos siete días.

{
  "stations": [
    { "id": "gios:400", "name": "Kraków, Aleja Krasińskiego", "kind": "government",
      "lon": 19.92619, "lat": 50.05768, "distanceKm": 1.02, "time": "2026-11-07T17:00:00.000Z",
      "values": { "co": 750, "no2": 52.1, "pm10": 48.1, "pm25": 41.2 } },
    { "id": "sensorcommunity:68207", "name": null, "kind": "citizen",
      "lon": 19.936, "lat": 50.078, "distanceKm": 2.02, "time": "2026-11-07T17:28:37.000Z",
      "values": { "pm10": 39.3, "pm25": 20.5 } }
  ],
  "credits": [ "..." ]
}

Las estaciones oficiales cubren Albania, Andorra, Austria, Bélgica, Bosnia y Herzegovina, Bulgaria, Croacia, Chipre, Chequia, Dinamarca, Estonia, Finlandia, Francia, Alemania, Grecia, Hungría, Islandia, Irlanda, Italia, Letonia, Luxemburgo, Malta, Montenegro, los Países Bajos, Macedonia del Norte, Noruega, Polonia, Portugal, Rumanía, Serbia, Eslovaquia, Eslovenia, Suecia, Suiza y el Reino Unido; los sensores ciudadanos miden partículas en miles de lugares de todo el mundo. Cada estación indica de qué kind es, y puedes pedir solo un tipo. Los sensores ciudadanos muestran bien si el aire está mal ahora mismo, pero marcan valores altos con niebla y no son tan exactos como las estaciones oficiales.

Junto con todo lo demás sobre un lugar

GET /v1/point devuelve el nombre del lugar, la zona horaria, la altitud, el tiempo, la previsión de calidad del aire, las estaciones de aire cercanas y las estaciones de aforo de ríos en una sola petición, que cuenta como una. Para un recuadro, GET /v1/area hace lo mismo por cada parte.

Precio

El plan gratuito da 500 peticiones al día, también para aplicaciones comerciales. Developer cuesta 14,99 $ al mes por 5000 al día y Pro 39,99 $ al mes por 20 000 al día, con tiempo, datos de mapas, niveles de ríos, altitudes y rutas con la misma clave.

Créditos: previsiones de calidad del aire de Open-Meteo.com (CC BY 4.0), basadas en datos del Servicio de Vigilancia de la Atmósfera de Copernicus. Valores medidos: colaboradores de Sensor.Community (ODbL 1.0); Instituto Hidrometeorológico Checo, ČHMÚ (CC BY 4.0); Źródło danych: GIOŚ - EKOINFONET (CC BY 4.0; los datos actuales no están verificados); Agencia Europea de Medio Ambiente, datos actualizados notificados por los países (CC BY 4.0; sin verificar); red de sensores Syngeos (syngeos.pl).

El plan gratuito incluye 500 solicitudes al día, también para apps comerciales. Crea una cuenta con Google o con tu correo y genera tus claves al instante.