API pública — Centinela Venezuela

API abierta y gratuita de solo lectura para que otras webs o apps consuman los datos sísmicos y de apagones de Venezuela. Sin clave. CORS habilitado. Cacheada.

⚠️ Atribución obligatoria. Si usas estos datos, cita: "Datos vía Centinela Venezuela · Fuentes USGS / EMSC / FUNVISIS (vía SismosVE)" y enlaza a centinelavenezuela.aguilaiastudio.es. Es una herramienta informativa, no sustituye a Protección Civil.

1. Sismos

GET/api/sismos.php

Devuelve los sismos de las últimas horas (USGS, EMSC y FUNVISIS vía SismosVE), ya normalizados y deduplicados.

Parámetro	Valores	Por defecto
`horas`	1–168	48
`min_mag`	número (ej. 2.5)	—
`formato`	`geojson` \| `simple`	geojson

Ejemplos:

GET https://centinelavenezuela.aguilaiastudio.es/api/sismos.php
GET https://centinelavenezuela.aguilaiastudio.es/api/sismos.php?horas=24&min_mag=3&formato=simple

Respuesta formato=simple:

{
  "ok": true,
  "generado": "2026-06-27T20:00:00+00:00",
  "total": 3,
  "atribucion": "Datos vía Centinela Venezuela · USGS / EMSC / FUNVISIS (vía SismosVE)",
  "sismos": [
    { "id":"usgs_us6000t8k6", "mag":4.7, "lugar":"54 km N of El Limón, Venezuela",
      "lat":10.8, "lng":-67.59, "prof_km":10, "fecha":"2026-06-27T00:16:00+00:00",
      "region":"Venezuela", "fuente":"USGS" }
  ]
}

Con formato=geojson devuelve un FeatureCollection estándar (compatible con Leaflet/Mapbox).

2. Apagones (reportes ciudadanos)

GET/api/apagones.php

Reportes ciudadanos de "sin luz", agregados por estado, de las últimas 6 horas (anónimos).

GET https://centinelavenezuela.aguilaiastudio.es/api/apagones.php

{ "ok":true, "ventana_h":6, "total_estados":2,
  "zonas":[ {"estado":"Miranda","reportes":14,"ultimo":1782...}, ... ] }

3. Uso desde JavaScript

fetch('https://centinelavenezuela.aguilaiastudio.es/api/sismos.php?formato=simple')
  .then(r => r.json())
  .then(d => console.log(d.total, d.sismos));

4. Límites y términos

Datos cacheados ~2 min; no consultes más de ~1 vez por minuto por buena práctica.
Datos sísmicos: USGS (dominio público), EMSC (requiere atribución) y FUNVISIS servidos por el proyecto SismosVE (rafnixg). Reportes de apagón: ciudadanos.
Sin garantía de disponibilidad ni exactitud. Uso informativo. Ante emergencia, autoridades oficiales.
Contacto: info@aguilaiastudio.es