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
|
Listado de estaciones meteorológicas activas con su última lectura. 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) 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/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
|
Frames del archivo propio de radar (composición nacional AEMET, retención 48 h). Probar: /api/radar/archivo |
GET
/api/widget?slug={slug}
|
Datos del widget embebible de pronóstico. Probar: /api/widget?slug=madrid |
sensors ¿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.