Earthquake API
FreemiumReal-time earthquakes worldwide from the USGS: recent quakes, quakes near a location, historical search and event details.
Documentation
Real-time earthquakes worldwide from the USGS: recent quakes, quakes near a location, historical search and event details.
What you get
- Recent earthquakes — last hour, day, week or month
- Nearby earthquakes within a radius of any point
- Search history by date, magnitude and region
- Event details — magnitude, depth, felt reports, tsunami flag, alert level
Great for safety and alert apps, news, insurance, research and education.
Quick start
Subscribe to a plan (the Basic plan is free), then call the API at https://earthquakes.p.apihiver.com with your key in the X-API-Key header:
curl "https://earthquakes.p.apihiver.com/v1/recent?limit=3" \
-H "X-API-Key: YOUR_API_KEY"Endpoints
| Method | Path | What it does |
|---|---|---|
GET | /v1/recent | Recent earthquakes worldwide |
GET | /v1/nearby | Earthquakes near a point |
GET | /v1/search | Search earthquakes by date range, magnitude and region box |
GET | /v1/event/{event_id} | Details of one earthquake |
Open the Endpoints tab to see every parameter, example request and example response, and to try the API live.
Errors
Every error is JSON with the same shape:
{"error": {"code": "INVALID_INPUT", "message": "coords: Field required"}}| HTTP | Code | Meaning |
|---|---|---|
| 400 | INVALID_INPUT | A parameter is missing or has the wrong format — the message says which |
| 401 | UNAUTHORIZED | Missing or invalid X-API-Key |
| 404 | NOT_FOUND | Nothing matched the code, id or name you sent |
| 429 | — | Plan quota or rate limit reached (see the X-RateLimit-* headers) |
| 502 / 503 / 504 | — | A data source or the API server is temporarily unavailable — retry after a few seconds |
Data & privacy
Data comes from the US Geological Survey (USGS) earthquake feeds, public domain.
Earthquake API FAQ
- Is the Earthquake API free?
- Yes. The Basic plan is free and includes 500 requests per month — no card needed. Paid plans start at ₹299 per month for 10,000 requests.
- How much does the Earthquake API cost?
- Basic: free for 500 requests; Pro: ₹299/month for 10,000 requests; Ultra: ₹999/month for 50,000 requests; Mega: ₹2,499/month for 2,00,000 requests. Billing is monthly and you can cancel any time.
- How do I use the Earthquake API?
- Subscribe to a plan on APIHiver, create an API key in the Console, then send requests to https://earthquakes.p.apihiver.com with your key in the X-API-Key header. You can also try every endpoint in the browser playground first.
- What endpoints does the Earthquake API have?
- It has 4 endpoints: Recent earthquakes worldwide (GET /v1/recent); Earthquakes near a point (GET /v1/nearby); Search earthquakes by date range, magnitude and region box (GET /v1/search); Details of one earthquake (GET /v1/event/{event_id}).
- What are the Earthquake API rate limits?
- Basic: 2 requests per second; Pro: 5 requests per second; Ultra: 10 requests per second; Mega: 20 requests per second. Monthly quotas depend on the plan; every response includes X-RateLimit headers showing what's left.
- Can I use one API key for the Earthquake API and other APIs?
- Yes. One APIHiver key works for every API you subscribe to, so you don't need a separate account or key per provider.
Related APIs
Current weather, 9-day forecasts, hourly forecasts, and sunrise/sunset/moon phase for any city or coordinates worldwide.
Evaluate expressions, solve equations, and compute derivatives, integrals and simplifications — with exact and decimal answers.
Medicine information from the US FDA: uses, dosage, warnings, side effects, reported adverse events and recalls.
BMI, daily calories (BMR/TDEE), ideal weight, body-fat percentage and water intake — using standard medical formulas.
Nutrition facts, ingredients, Nutri-Score and allergens for millions of packaged foods — by barcode or name.
Endpoints
4 endpoints — full list is in the sidebar on larger screens.