{"service":"QuakeIndex API","version":"1","base":"https://quakeindex.com/api","licence":"Underlying earthquake data is USGS, public domain. Attribution to QuakeIndex is appreciated and required for the embeddable widget.","method":"https://quakeindex.com/method/","contact":"team at voittovirta.com","conventions":{"timestamps":"Epoch milliseconds UTC, plus an ISO 8601 string alongside.","provenance":"Every response carries `generated` and `source`. Every event carries `source_url` pointing at the USGS event page, which is the record of authority for all of its values.","freshness":"Events are ingested from the USGS all_hour feed every 30 seconds.","no_forecasts":"Nothing in this API is a forecast. The QuakeIndex score describes observed activity against a place’s own history."},"rate_limits":{"scheme":"Fixed window per IP address, counted in memory on the server.","note":"A fixed window can admit a burst at a boundary. That is an accepted trade for a public read-only API and is stated here rather than hidden.","endpoints":{"/api/latest":"120 requests per 60 seconds","/api/near":"60 requests per 60 seconds","/api/felt":"60 requests per 60 seconds"},"on_exceed":"HTTP 429 with a Retry-After header and `retry_after_seconds`."},"endpoints":[{"path":"/api/latest","params":{"limit":"1-100, default 20","min_magnitude":"optional float"},"returns":"The most recent events, newest first.","notes":"Reads the database the 30-second ingest writes. `checked_at` is when the USGS feed was last confirmed; `newest_event_time` is the most recent event."},{"path":"/api/near","params":{"lat":"required, -90..90","lon":"required, -180..180","km":"1-1000, default 50","days":"1-365, default 30","limit":"1-200, default 20","min_magnitude":"optional float"},"returns":"Events within `km` of the point, newest first, each with `distance_km`.","notes":"`truncated` is true when the result hit `limit`, so a caller can tell a full page from a complete answer."},{"path":"/api/felt","params":{"lat":"required","lon":"required","minutes":"5-180, default 60","km":"10-500, default 150"},"returns":"`answer` is one of `yes`, `not_yet_reported`, `no`, with a `message`.","notes":"`not_yet_reported` is returned for windows of 30 minutes or less when nothing is found, because a small earthquake can take several minutes to reach the USGS catalogue. It is not the same as `no`."},{"path":"/sitemap-quakes.xml","returns":"Indexable events from the last 48 hours, as a sitemap."}],"indexing_rule":{"description":"Which events get an indexable page (and appear in the quake sitemap).","united_states":"magnitude 2.5 and above","rest_of_world":"magnitude 4.5 and above","excluded":"Quarry blasts, explosions and other non-earthquake events USGS catalogues, and events USGS has withdrawn.","note":"Smaller events still get a page; it carries noindex and is listed on its place pages."}}