Data / API
API Endpoint Reference.
Operational JSON endpoints used by monitors, maps and resource sections.
Core Feeds
- GET /api/earthquakes.php
Merged earthquake events and KPI fields.
- GET /api/volcanoes.php
Weekly volcano bulletin stream with parsed metadata.
- GET /api/tremors.php
Tremor signal model and cluster metrics.
Hazard Feeds
- GET /api/tsunami.php
Active tsunami alerts and warning levels.
- GET /api/space-weather.php
NOAA SWPC Kp stream and forecast summary.
- GET /api/bulletins.php
Institutional RSS/Atom bulletin aggregation.
Derived Feeds
- GET /api/aftershocks.php
Automatic aftershock sequences (M6+ mainshock trigger, 7d/150km tracking).
- GET /api/hotspots.php
Volcano hotspot ranking from volcano event snapshots.
- GET /api/volcano-cams.php
Curated volcano cams and stream metadata.
- GET /api/earthquakes-archive.php
Paginated historical earthquake archive with server-side filters.
- GET /api/event-history.php
Historical archive for an event zone (paginated + strongest in area).
- GET /api/tectonic-context.php
Tectonic plates and active faults (global or local focus).
- GET /api/health.php
Operational health summary (feed freshness + archive DB availability).
Refresh Endpoint
Force refresh all configured feeds in one call. For production, schedule refresh scripts by cron.
- GET /api/refresh.php?force_refresh=1&token=YOUR_REFRESH_TOKEN
Returns per-target refresh status (token required).
- /scripts/refresh-feeds.sh
Quick refresh for all operational feeds + tectonic context.
- /scripts/prewarm-all.sh
Deep refresh including event history hotspots by active seismic zones.