API para desarrolladores
Los datos que mueven eltiempoen.net, disponibles en JSON. Gratis para proyectos personales y educativos con atribución.
| Endpoint | Descripción |
|---|---|
GET
/api/search?q={texto}
|
Buscador de municipios (España y LATAM). Devuelve id, nombre, slug y provincia. Probar: /api/search?q=cuenca |
GET
/api/stations[?limit={n}&community={id}&province={id}]
|
Estaciones meteorológicas activas con su última lectura. Devuelve 100 por defecto; limit admite hasta 2500, y community o province (id numérico) filtran por zona. No incluye las redes de Euskalmet, Navarra, SIAM, SIAR, Tenerife ni la Comunidad de Madrid. Probar: /api/stations |
GET
/api/stations/{codigo}/history?hours={n}
|
Observaciones crudas de una estación (hasta 720 h). Si no hay horarias, devuelve resúmenes diarios. Probar: /api/stations/3195/history?hours=48 |
GET
/api/stations/{codigo}/windrose
|
Rosa de los vientos: frecuencia por 16 sectores × 4 rangos de velocidad, últimos 12 meses. Probar: /api/stations/3195/windrose |
GET
/api/model-comparison?lat={lat}&lon={lon}
|
Pronóstico multi-modelo (ECMWF, GFS, ICON…) con ensemble (media, min, max, desviación; sin UK Met Office, cuya serie va aparte con licencia CC BY-SA 4.0) horario y diario. Solo coordenadas de España. Probar: /api/model-comparison?lat=40.42&lon=-3.70 |
GET
/api/mapa/viento
|
Campo de viento observado interpolado a rejilla de 0,35° en formato leaflet-velocity (componentes u/v en m/s). Probar: /api/mapa/viento |
GET
/api/mapa/superficie?var=temperature
|
Temperatura observada interpolada a rejilla (máscara a >70 km de la estación más cercana). Probar: /api/mapa/superficie?var=temperature |
GET
/api/mapa/temperatura
|
Temperatura actual interpolada (IDW) a una rejilla de 0,05° con corrección por altitud (0,65 °C/100 m sobre Copernicus DEM), en décimas de grado; incluye las estaciones usadas. Solo redes cuya licencia permite derivados. Se recalcula cada 10 min. Probar: /api/mapa/temperatura |
GET
/api/mapa/viento-prevision[?t={unix}]
|
Viento a 10 m previsto por ECMWF IFS 0,25° para las próximas 48 h (Open-Meteo.com, CC BY 4.0). Sin parámetro lista las horas; con t devuelve la rejilla u/v de esa hora en décimas de m/s. Probar: /api/mapa/viento-prevision |
GET
/api/mapa/timelapse[?t={unix}]
|
Frames archivados del grid de temperatura (últimas 24 h, uno cada 10 min). Sin parámetro lista los timestamps; con t devuelve un frame. Probar: /api/mapa/timelapse |
GET
/api/historico/year?lat={lat}&lon={lon}&year={año}
|
Serie diaria de un año completo (Tmax, Tmin, precipitación) desde 1940. Archivo ERA5 con fallback a estación propia. Probar: /api/historico/year?lat=40.42&lon=-3.70&year=2024 |
GET
/api/radar/archivo?zona=canarias[&horas={n}]
|
Frames del archivo propio del radar regional de AEMET en Canarias (uno cada 10 min, retención 48 h). Fuente: AEMET. Probar: /api/radar/archivo?zona=canarias&horas=3 |
GET
/api/radar/aemet[?horas={1-3}]
|
Radar propio con los radares regionales de AEMET, uno cada 10 min: por zona (peninsula = composición de los 14 radares de la Península y Baleares, o el código de cada radar, ca = Canarias) su caja [sur, oeste, norte, este] y los fotogramas PNG en Web Mercator para L.imageOverlay; escala de dBZ con color y mm/h. Fuente: AEMET. Probar: /api/radar/aemet?horas=1 |
GET
/api/radar/lluvia
|
Lluvia de la última hora en los pluviómetros (AEMET, MeteoGalicia, Meteocat, GRAFCAN): frase de dónde llueve y estaciones con más lluvia. Caché de 10 min. Probar: /api/radar/lluvia |
GET
/api/widget?slug={slug}
|
Datos del widget embebible de pronóstico. Probar: /api/widget?slug=madrid |
¿Tienes una estación meteorológica? Envíanos sus datos
Soportamos cuatro protocolos de ingesta — crea tu cuenta, registra tu estación y obtén tus claves en tu panel:
POST /api/v1/stations/{clave}/data— API REST propia (JSON, unidades métricas)POST /data/report/— protocolo Ecowitt (configura el host en tu consola)GET /weatherstation/updateweatherstation.php— protocolo WundergroundGET /v01/set/…— protocolo Weathercloud
Tu estación tendrá página pública con gráficas, rosa de los vientos e histórico, y aparecerá en el mapa en vivo y en los rankings de /ahora.
Condiciones de uso
- Uso razonable: cachea las respuestas (la mayoría cambian cada 10-15 minutos) y no superes ~1 petición/segundo.
- Atribución con enlace a eltiempoen.net en cualquier uso público.
- Los datos de terceros conservan sus licencias (AEMET, Open-Meteo CC BY 4.0, redes autonómicas).
- Sin garantía de disponibilidad. Para usos comerciales o de gran volumen, contáctanos.