{"contractVersion":"parcelops.connector.v1","name":"usgs-earthquake","displayName":"USGS Earthquake History","description":"Worldwide published earthquake events for property and site-context screening.","tags":["earthquakes","seismicity","hazards","history","global","property"],"authentication":{"type":"none","required":false},"provenance":{"sourceName":"USGS Earthquake Hazards Program","sourceUrl":"https://earthquake.usgs.gov/fdsnws/event/1/query","apiBaseUrl":"https://earthquake.usgs.gov/fdsnws/event/1","documentationUrl":"https://earthquake.usgs.gov/fdsnws/event/1/"},"freshness":{"status":"declared","value":{"mode":"near_real_time","observedAtField":"time","updatedAtField":"updated","notes":"Real-time feeds are updated as contributing networks publish and review events."}},"coverage":{"geographic":{"status":"declared","value":["Worldwide"]},"temporal":{"status":"not_declared"}},"methods":{"total":5,"items":[{"name":"searchByRadius","description":"Search published events within 500 km of a coordinate.","requiredParams":["latitude","longitude"],"inputSchema":{"type":"object","properties":{"latitude":{"type":"number","minimum":-90,"maximum":90},"longitude":{"type":"number","minimum":-180,"maximum":180},"radiusKm":{"type":"number","exclusiveMinimum":0,"maximum":500},"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"minMagnitude":{"type":"number","minimum":-2,"maximum":10},"limit":{"type":"integer","minimum":1,"maximum":1000},"orderBy":{"type":"string","enum":["time","time-asc","magnitude","magnitude-asc"]},"catalog":{"type":"string","maxLength":40},"contributor":{"type":"string","maxLength":40}},"required":["latitude","longitude"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"near_real_time","observedAtField":"time","updatedAtField":"updated","notes":"Real-time feeds are updated as contributing networks publish and review events."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Published event history is not a parcel-specific seismic hazard, engineering, or insurance determination."]},{"name":"searchEarthquakes","description":"Search events by bounded place, time, magnitude, or network.","inputSchema":{"type":"object","properties":{"startTime":{"type":"string","format":"date-time"},"endTime":{"type":"string","format":"date-time"},"minLatitude":{"type":"number","minimum":-90,"maximum":90},"maxLatitude":{"type":"number","minimum":-90,"maximum":90},"minLongitude":{"type":"number","minimum":-180,"maximum":180},"maxLongitude":{"type":"number","minimum":-180,"maximum":180},"minMagnitude":{"type":"number","minimum":-2,"maximum":10},"maxMagnitude":{"type":"number","minimum":-2,"maximum":10},"limit":{"type":"integer","minimum":1,"maximum":1000},"orderBy":{"type":"string","enum":["time","time-asc","magnitude","magnitude-asc"]},"catalog":{"type":"string","maxLength":40},"contributor":{"type":"string","maxLength":40}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"near_real_time","observedAtField":"time","updatedAtField":"updated","notes":"Real-time feeds are updated as contributing networks publish and review events."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Published event history is not a parcel-specific seismic hazard, engineering, or insurance determination."]},{"name":"getEventDetail","description":"Get one earthquake event by its USGS event ID.","requiredParams":["eventid"],"inputSchema":{"type":"object","properties":{"eventid":{"type":"string","minLength":1,"maxLength":80}},"required":["eventid"],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"near_real_time","observedAtField":"time","updatedAtField":"updated","notes":"Real-time feeds are updated as contributing networks publish and review events."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Published event history is not a parcel-specific seismic hazard, engineering, or insurance determination."]},{"name":"getRecentEvents","description":"Get a curated real-time feed by magnitude and time window.","inputSchema":{"type":"object","properties":{"minMagnitude":{"oneOf":[{"type":"string","enum":["significant"]},{"type":"number","enum":[1,2.5,4.5]}]},"period":{"type":"string","enum":["hour","day","week","month"]}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"near_real_time","observedAtField":"time","updatedAtField":"updated","notes":"Real-time feeds are updated as contributing networks publish and review events."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Published event history is not a parcel-specific seismic hazard, engineering, or insurance determination."]},{"name":"getServiceInfo","description":"Return source coverage, limits, and use notes.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"near_real_time","observedAtField":"time","updatedAtField":"updated","notes":"Real-time feeds are updated as contributing networks publish and review events."},"scope":"connector"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Published event history is not a parcel-specific seismic hazard, engineering, or insurance determination."]}]},"caveats":["Published event history is not a parcel-specific seismic hazard, engineering, or insurance determination."]}