# Earthquake Phivolcs Dost — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access real-time and historical earthquake data from the Philippines, including the latest seismic events, monthly records, detailed information about specific earthquakes, and official bulletins. Search through archived earthquake data to track seismic activity over time.

**Category:** Government & Public Data | **Website:** [earthquake.phivolcs.dost.gov.ph/](https://earthquake.phivolcs.dost.gov.ph/) | **Docs:** [parse.bot/marketplace/dd52d729-ac3e-4bba-9c2e-3c3362e22b4f/earthquake-phivolcs-dost-gov-ph-api](https://parse.bot/marketplace/dd52d729-ac3e-4bba-9c2e-3c3362e22b4f/earthquake-phivolcs-dost-gov-ph-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-earthquake-phivolcs-dost-gov-ph-api-dd52d729/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_earthquake_bulletin_url

Constructs the bulletin URL for a specific earthquake event from its date/time code and bulletin suffix. No network request is made; this is a deterministic URL builder. Useful for constructing URLs when you know the event identifiers but do not have the full URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bulletin_suffix` | string | Yes | Bulletin suffix code appended to the filename (e.g. 'B1', 'B2', 'B1F', 'B2F', 'B3F'). |
| `date_time_code` | string | Yes | Date-time code in format YYYY_MMDD_HHMM (e.g. '2025_0204_2134'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-earthquake-phivolcs-dost-gov-ph-api-dd52d729/get_earthquake_bulletin_url \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bulletin_suffix":"<string>","date_time_code":"<string>"}'
```

### get_earthquake_detail

Fetches the full bulletin for a single earthquake event. Returns tectonic origin, precise date/time, magnitude with scale type, location with coordinates, depth, reported intensities, damage/aftershock expectations, issue metadata, and an epicentral map image URL when available. The bulletin_url is obtained from get_latest_earthquakes or get_monthly_earthquakes results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `bulletin_url` | string | Yes | Full URL to the earthquake bulletin page, obtained from the bulletin_url field in get_latest_earthquakes or get_monthly_earthquakes results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-earthquake-phivolcs-dost-gov-ph-api-dd52d729/get_earthquake_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bulletin_url":"<string>"}'
```

### get_latest_earthquakes

Fetches the current month's earthquake listings from the PHIVOLCS home page. Returns all recorded seismic events with date/time, coordinates, depth, magnitude, location description, and a link to the full bulletin. The list is ordered most-recent-first and covers the current calendar month only; for older data use get_monthly_earthquakes.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-earthquake-phivolcs-dost-gov-ph-api-dd52d729/get_latest_earthquakes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_monthly_earthquakes

Retrieves earthquake listings for a specific month and year from the PHIVOLCS archive. Returns the same structure as get_latest_earthquakes. Available months can be discovered via list_available_archives.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `month` | string | Yes | Full month name: January, February, March, April, May, June, July, August, September, October, November, December. |
| `year` | integer | Yes | Four-digit year of the archive (e.g. 2025). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-earthquake-phivolcs-dost-gov-ph-api-dd52d729/get_monthly_earthquakes \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"month":"<string>","year":"<integer>"}'
```

### list_available_archives

Lists all available year/month combinations for the earthquake archive by scanning the PHIVOLCS home page for archive links. Each entry includes the year, month name, and direct URL to the monthly archive page. Use the year and month values as inputs to get_monthly_earthquakes.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-earthquake-phivolcs-dost-gov-ph-api-dd52d729/list_available_archives \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```