earthquake.phivolcs.dost.gov.ph APIearthquake.phivolcs.dost.gov.ph ↗
Access real-time and historical Philippines earthquake data from PHIVOLCS — latest events, monthly archives, and detailed bulletins with intensities and depth.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/59541784-c125-412a-a5b4-0b05b4d4e4b9/get_latest_earthquakes' \ -H 'X-API-Key: $PARSE_API_KEY'
Get latest earthquake listings from the PHIVOLCS home page for the current month. Returns an array of earthquake records with date/time, coordinates, depth, magnitude, location, and bulletin URL.
No input parameters required.
{
"type": "object",
"fields": {
"earthquakes": "array of earthquake objects with date_time, latitude, longitude, depth_km, magnitude, location, and bulletin_url"
},
"sample": {
"data": {
"earthquakes": [
{
"depth_km": "011",
"latitude": "19.94",
"location": "045km S 14° W of Sabtang (Batanes)",
"date_time": "14 May 2026 - 10:15 AM",
"longitude": "121.77",
"magnitude": "2.2",
"bulletin_url": "https://earthquake.phivolcs.dost.gov.ph/2026_Earthquake_Information/May/2026_0514_0215_B1.html"
}
]
},
"status": "success"
}
}About the earthquake.phivolcs.dost.gov.ph API
This API exposes 5 endpoints covering earthquake data from the Philippine Institute of Volcanology and Seismology (PHIVOLCS), returning fields like magnitude, depth, coordinates, tectonic origin, and shaking intensities. Use get_latest_earthquakes to pull current-month seismic events directly from the PHIVOLCS bulletin system, or query any historical month going back through the full archive. Detailed bulletin pages include damage expectations, aftershock outlooks, and epicentral map image URLs.
Earthquake Listings and Archives
get_latest_earthquakes returns the current month's seismic events as an array of objects, each carrying date_time, latitude, longitude, depth_km, magnitude, location, and a bulletin_url linking to the full event record. For any past month, get_monthly_earthquakes accepts a year (integer) and a full month name (e.g., "March") and returns the same data shape. To discover which year/month combinations are available in the archive, call list_available_archives, which returns an array of objects with year, month, and url.
Bulletin Detail
get_earthquake_detail takes a bulletin_url from any listing endpoint and returns the full event record: origin (tectonic type), magnitude_full (with scale designation), depth_of_focus_km, location_full (narrative description with coordinates), expecting_damage, date_time, issued_on, bulletin_no, prepared_by initials, and a map_image_url pointing to the epicentral map. The map_image_url field may be null if no map was published with the bulletin.
URL Construction Helper
get_earthquake_bulletin_url is a client-side utility that constructs a bulletin URL from a date_time_code (format YYYY_MMDD_HHMM) and a bulletin_suffix (e.g., "B3F", "B1"). No network request is made — it assembles the standard PHIVOLCS URL pattern and returns the url string, which can then be passed directly to get_earthquake_detail.
Coverage Notes
All data reflects official PHIVOLCS bulletin records for the Philippines region. Event records span multiple years via the archive system. The get_earthquake_detail endpoint surfaces the shaking intensity table where published, covering affected provinces and municipalities at various intensity levels.
- Monitor real-time seismic activity in the Philippines using magnitude and depth fields from
get_latest_earthquakes - Build historical earthquake frequency charts for a given province by iterating
get_monthly_earthquakesacross archived months - Trigger damage-assessment workflows when
expecting_damageis affirmative in a bulletin detail response - Display epicentral maps in a web app by consuming the
map_image_urlfield fromget_earthquake_detail - Construct time-series datasets of Philippine seismicity by looping through all entries returned by
list_available_archives - Cross-reference tectonic origin types using the
originfield to study fault activity patterns over time - Feed bulletin numbers and preparer initials into an audit log for official PHIVOLCS record tracking
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does PHIVOLCS provide an official developer API?+
What does `get_earthquake_detail` return beyond what the listing endpoints provide?+
get_earthquake_detail expands a bare listing record into the full bulletin: tectonic origin, magnitude_full with scale type, depth_of_focus_km, location_full narrative, expecting_damage, shaking intensities by area, bulletin_no, issued_on timestamp, prepared_by initials, and a map_image_url. The listing endpoints (get_latest_earthquakes, get_monthly_earthquakes) only return the summary row fields — coordinates, depth, magnitude, location string, and bulletin URL.How far back does the archive go?+
list_available_archives to get the actual set of year/month combinations currently accessible; it reflects only what the bulletin system makes available, not a fixed historical window.