{"ok":true,"site":"earthquake-usgs","host":"earthquake.usgs.gov","about":"USGS Earthquake Hazards Program (Latest Earthquakes map). This CLI queries real-time earthquake feeds, the ComCat FDSN event search and count APIs, event details with products such as PAGER, ShakeMap and aftershock forecasts, geoserve nearby-place and region lookups, and catalog/contributor metadata.","commands":[{"command":"get-feed","summary":"Get a real-time earthquake summary feed (GeoJSON) for a magnitude threshold and time window, e.g. M2.5+ past day or significant past month","params":[{"name":"magnitude","type":"string","description":"Magnitude threshold of the feed, or 'significant' for significant events only","oneOf":["significant","4.5","2.5","1.0","all"],"default":"2.5"},{"name":"period","type":"string","description":"Time window of the feed","oneOf":["hour","day","week","month"],"default":"day"}],"exampleUrl":"https://clify-dev.netlify.app/earthquake-usgs/get-feed"},{"command":"search-earthquakes","summary":"Search the ComCat earthquake catalog (FDSN) by time range, magnitude, bounding box or radius, depth, PAGER alert level and event type, with sorting and paging","params":[{"name":"starttime","type":"string","description":"Start time, ISO 8601 date or datetime in UTC, e.g. 2026-10-01 or 2026-10-01T00:00:00. Defaults server-side to 30 days ago."},{"name":"endtime","type":"string","description":"End time, ISO 8601 date or datetime in UTC. Defaults to now."},{"name":"minmagnitude","type":"number","description":"Minimum magnitude"},{"name":"maxmagnitude","type":"number","description":"Maximum magnitude"},{"name":"minlatitude","type":"number","description":"Bounding box south edge, decimal degrees (-90 to 90)"},{"name":"maxlatitude","type":"number","description":"Bounding box north edge, decimal degrees"},{"name":"minlongitude","type":"number","description":"Bounding box west edge, decimal degrees (-360 to 360)"},{"name":"maxlongitude","type":"number","description":"Bounding box east edge, decimal degrees"},{"name":"latitude","type":"number","description":"Center latitude for a radius search (use together with longitude and maxradiuskm)"},{"name":"longitude","type":"number","description":"Center longitude for a radius search"},{"name":"maxradiuskm","type":"number","description":"Search radius in km around latitude/longitude (max 20001.6)"},{"name":"mindepth","type":"number","description":"Minimum depth in km"},{"name":"maxdepth","type":"number","description":"Maximum depth in km"},{"name":"alertlevel","type":"string","description":"Limit to events with this PAGER alert level","oneOf":["green","yellow","orange","red"]},{"name":"eventtype","type":"string","description":"Event type, e.g. earthquake, quarry blast, explosion (see get-catalog-metadata eventtypes)"},{"name":"catalog","type":"string","description":"Limit to a catalog, e.g. us, ak, ci (see get-catalog-metadata catalogs)"},{"name":"producttype","type":"string","description":"Only events that have this product type, e.g. shakemap, losspager, dyfi, moment-tensor"},{"name":"orderby","type":"string","description":"Sort order","oneOf":["time","time-asc","magnitude","magnitude-asc"],"default":"time"},{"name":"api_limit","type":"number","description":"Maximum number of events to return (1-20000) (sent to the site as \"limit\"; clify's own --limit only shapes the output)","default":20},{"name":"offset","type":"number","description":"1-based index of the first result to return, used for paging","default":1}],"exampleUrl":"https://clify-dev.netlify.app/earthquake-usgs/search-earthquakes?starttime=2026-10-01&endtime=2026-10-18&minmagnitude=5&orderby=magnitude&api_limit=20"},{"command":"count-earthquakes","summary":"Count catalog events that match search filters (time, magnitude, location radius or bbox, depth, event type) without downloading them","params":[{"name":"starttime","type":"string","description":"Start time, ISO 8601 UTC, e.g. 2026-10-01"},{"name":"endtime","type":"string","description":"End time, ISO 8601 UTC"},{"name":"minmagnitude","type":"number","description":"Minimum magnitude"},{"name":"maxmagnitude","type":"number","description":"Maximum magnitude"},{"name":"latitude","type":"number","description":"Center latitude for a radius filter (use with longitude and maxradiuskm)"},{"name":"longitude","type":"number","description":"Center longitude for a radius filter"},{"name":"maxradiuskm","type":"number","description":"Radius in km around latitude/longitude"},{"name":"minlatitude","type":"number","description":"Bounding box south edge"},{"name":"maxlatitude","type":"number","description":"Bounding box north edge"},{"name":"minlongitude","type":"number","description":"Bounding box west edge"},{"name":"maxlongitude","type":"number","description":"Bounding box east edge"},{"name":"mindepth","type":"number","description":"Minimum depth in km"},{"name":"maxdepth","type":"number","description":"Maximum depth in km"},{"name":"alertlevel","type":"string","description":"PAGER alert level","oneOf":["green","yellow","orange","red"]},{"name":"eventtype","type":"string","description":"Event type, e.g. earthquake"}],"exampleUrl":"https://clify-dev.netlify.app/earthquake-usgs/count-earthquakes?starttime=2026-10-01&minmagnitude=4&latitude=7.5868&longitude=-80.769&maxradiuskm=400"},{"command":"get-event","summary":"Get full detail for one earthquake event by id, including all products (origin, shakemap, losspager, dyfi, moment-tensor, oaf) and their content file URLs","params":[{"name":"eventid","type":"string","required":true,"description":"Event id as returned in feed or search results (feature id), e.g. us6000u18k"}],"exampleUrl":"https://clify-dev.netlify.app/earthquake-usgs/get-event"},{"command":"get-aftershock-forecast","summary":"Get the aftershock forecast (oaf product forecast.json: observed counts, model parameters, probabilities) for an event's oaf product","params":[{"name":"productId","type":"string","required":true,"description":"Full oaf product id from get-event properties.products.oaf[0].id, e.g. urn:usgs-product:us:oaf:us6000u18k:1792252672761"}],"exampleUrl":"https://clify-dev.netlify.app/earthquake-usgs/get-aftershock-forecast"},{"command":"get-shakemap-contours","summary":"Get ShakeMap intensity (MMI) contour lines as GeoJSON for an event's shakemap product","params":[{"name":"productId","type":"string","required":true,"description":"Full shakemap product id from get-event properties.products.shakemap[0].id, e.g. urn:usgs-product:us:shakemap:us6000u2mq:1792208324795"}],"exampleUrl":"https://clify-dev.netlify.app/earthquake-usgs/get-shakemap-contours"},{"command":"find-nearby-places","summary":"Find populated places (GeoNames) near a latitude/longitude within a radius, optionally filtered by minimum population","params":[{"name":"latitude","type":"number","required":true,"description":"Latitude in decimal degrees"},{"name":"longitude","type":"number","required":true,"description":"Longitude in decimal degrees"},{"name":"maxradiuskm","type":"number","description":"Search radius in km"},{"name":"minpopulation","type":"number","description":"Minimum population of returned places"},{"name":"api_limit","type":"number","description":"Maximum number of places to return (sent to the site as \"limit\"; clify's own --limit only shapes the output)"}],"exampleUrl":"https://clify-dev.netlify.app/earthquake-usgs/find-nearby-places?latitude=34.05&longitude=-118.25&maxradiuskm=50&minpopulation=10000"},{"command":"get-event-places","summary":"Get the 5 reference places the event page lists near an epicenter (distance and azimuth), as used in event titles","params":[{"name":"latitude","type":"number","required":true,"description":"Epicenter latitude"},{"name":"longitude","type":"number","required":true,"description":"Epicenter longitude"}],"exampleUrl":"https://clify-dev.netlify.app/earthquake-usgs/get-event-places?latitude=7.5868&longitude=-80.769"},{"command":"get-regions","summary":"Get regional info for a lat/lon: admin region/country, Flinn-Engdahl region, authoritative network, NEIC catalog/response regions, offshore and tectonic summary","params":[{"name":"latitude","type":"number","required":true,"description":"Latitude in decimal degrees"},{"name":"longitude","type":"number","required":true,"description":"Longitude in decimal degrees"}],"exampleUrl":"https://clify-dev.netlify.app/earthquake-usgs/get-regions?latitude=7.5868&longitude=-80.769"},{"command":"get-catalog-metadata","summary":"List the allowed values for FDSN search filters: catalogs, contributors, product types, event types and magnitude types","params":[],"exampleUrl":"https://clify-dev.netlify.app/earthquake-usgs/get-catalog-metadata"},{"command":"list-contributors","summary":"List ComCat contributing seismic networks with id, full name, aliases and info URL","params":[],"exampleUrl":"https://clify-dev.netlify.app/earthquake-usgs/list-contributors"}]}