Returns a GeoJSON FeatureCollection containing earthquake events with properties like magnitude, location, time, depth, and links to detailed information. Use this to retrieve actual earthquake data for display, analysis, or processing.
From spec: Returns earthquake event data matching specified query parameters in GeoJSON format.
Usage Tips
- Default format is GeoJSON (use format=geojson explicitly)
- Supports spatial queries (latitude/longitude/radius)
- Supports magnitude and time filters
- Returns max 20,000 events per request
- Use offset parameter for pagination
- All times are in UTC milliseconds since epoch
import zingu_apis
api = zingu_apis.api("usgs-earthquake")
result = api.fetch("query", starttime="2024-01-01", endtime="2024-01-31", minmagnitude=5.0, eventid="ci40453703", catalog="us", contributor="us", eventtype="earthquake")
for item in result:
print(item)
const resp = await fetch("https://earthquake.usgs.gov/fdsnws/event/1/query?starttime=2024-01-01&endtime=2024-01-31&minmagnitude=5.0&eventid=ci40453703&catalog=us&contributor=us&eventtype=earthquake");
const data = await resp.json();
import zingu_apis
api = zingu_apis.api("usgs-earthquake")
result = api.fetch("query", starttime="2024-01-01", endtime="2024-01-02")
for item in result:
print(item)
const resp = await fetch("https://earthquake.usgs.gov/fdsnws/event/1/query?starttime=2024-01-01&endtime=2024-01-02");
const data = await resp.json();
Query earthquakes by date range with paginationprobe-gate
Demonstrates basic earthquake query with date filtering and result limiting.
import zingu_apis
api = zingu_apis.api("usgs-earthquake")
result = api.fetch("query", format="geojson", starttime="2024-01-01", endtime="2024-01-02", limit=2)
for item in result:
print(item)
const resp = await fetch("https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&starttime=2024-01-01&endtime=2024-01-02&limit=2");
const data = await resp.json();
Query earthquakes by geographic locationprobe-gate
Demonstrates spatial query to find earthquakes near a specific location.
import zingu_apis
api = zingu_apis.api("usgs-earthquake")
result = api.fetch("query", format="geojson", latitude=37.7749, longitude=-122.4194, maxradiuskm=100, limit=2)
for item in result:
print(item)
const resp = await fetch("https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&latitude=37.7749&longitude=-122.4194&maxradiuskm=100&limit=2");
const data = await resp.json();
Query significant earthquakes by minimum magnitudeprobe-gate
Demonstrates filtering for significant earthquakes using minimum magnitude threshold.
import zingu_apis
api = zingu_apis.api("usgs-earthquake")
result = api.fetch("query", format="geojson", minmagnitude=5.0, starttime="2024-01-01", limit=2)
for item in result:
print(item)
const resp = await fetch("https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&minmagnitude=5.0&starttime=2024-01-01&limit=2");
const data = await resp.json();