API de WhatAWeather
Una API REST con el tiempo, las estaciones de esquí, el surf, las playas, los embalses y la previsión a lo largo de una ruta. La misma climatología que hay detrás de las páginas de este sitio, calculada sobre el reanálisis ERA5 del Climate Data Store de Copernicus.
Empezar
Pide una clave con tu correo o entrando con Google, y úsala en la cabecera
X-API-Key. Nada más.
Toda respuesta tiene la misma forma: {"data": …, "meta": {…}}, y los errores
{"error": {"code": …, "message": …}}. El límite de peticiones viaja en las cabeceras
X-RateLimit-Limit, X-RateLimit-Remaining y
X-RateLimit-Reset.
Qué puedes consultar
| Recurso | Qué devuelve | Plan |
|---|---|---|
/ski/resorts | 114 estaciones del mundo con cota de base y de cima, filtrables por país, caja o cercanía. | Gratuito |
/ski/resorts/{id} | Ficha y climatología mes a mes: nevadas, días de nieve polvo, heladas, viento y temporada típica. | Gratuito |
/ski/resorts/{id}/conditions | Espesor, temperatura y viento a cota de base y de cima por separado, nieve de las últimas 24 y 72 horas y de las próximas, isoterma de 0 °C y visibilidad. | Pro |
/surf/spots | 18 spots del litoral español con su orientación de playa. | Gratuito |
/surf/spots/{id} | Climatología de oleaje mes a mes, con la dirección dominante del mar de fondo. | Gratuito |
/surf/spots/{id}/conditions | Ola, periodo, mar de fondo, temperatura del agua y viento, con el tipo relativo a la playa: offshore, onshore o cross-shore. | Pro |
/beaches/{id} | Climatología de 30 playas: aire, agua, oleaje, viento, sol y días de lluvia. | Gratuito |
/reservoirs | Reserva de agua por embalse y por demarcación, con el dato oficial del Ministerio para la Transición Ecológica. | Gratuito |
/weather | Tiempo actual y previsión hasta 16 días, por coordenadas o por nombre de lugar. | Pro |
/route | Previsión a lo largo de una ruta, para coche, bici, BTT, senderismo y montaña. | Pro |
La previsión de ruta, que es la que no vas a encontrar en otro sitio
No devuelve el tiempo que hace ahora en doce puntos: devuelve el que hará en cada punto a la hora estimada de paso. Esa es toda la diferencia entre una previsión de ruta y doce consultas sueltas.
Las actividades de montaña —hiking, mtb y mountain—
añaden isoterma de 0 °C, nieve, índice UV y riesgo de tormenta calculado a partir del CAPE. Los
umbrales de aviso cambian con la actividad: sesenta kilómetros por hora de racha son una molestia
en coche y un problema serio en una cresta o sobre una bici.
Admite hasta 24 puntos; una traza más larga se remuestrea a lo largo del recorrido conservando siempre el inicio y el final.
Planes
| Gratuito | Pro | |
|---|---|---|
| Catálogo y climatología | Sí | Sí |
| Embalses | Sí | Sí |
| Previsión en vivo y rutas | No | Sí |
| Peticiones por hora | 500 | 20.000 |
El plan gratuito se activa solo al crear la clave. El Pro se contrata desde tu cuenta.
De dónde salen los datos
La climatología de esquí, surf y playas es propia: se calcula sobre el reanálisis ERA5 del Climate Data Store de Copernicus, con licencia CC-BY 4.0. Los embalses son el dato oficial del Ministerio para la Transición Ecológica. La previsión en vivo procede de modelos numéricos servidos por Open-Meteo (ECMWF, ICON y GFS) y del modelo marino para el oleaje.
Cada respuesta declara su fuente y su licencia en meta, para que puedas atribuirla
sin tener que adivinar. Lo que la API no hace es sustituir a un aviso oficial: para alertas
meteorológicas manda AEMET, y en una emergencia, el 112.
Condiciones de uso
Una clave por aplicación, hasta cinco por cuenta. No la pongas en el código de una app que se distribuye: cualquiera puede extraerla de un binario. Lo correcto es que la app hable con tu servidor y tu servidor con esta API.
Si una clave se filtra, dala de baja desde tu cuenta y crea otra: es inmediato. Consulta también las condiciones de uso y la política de privacidad.