Data can be obtained using any program supporting the HTTP-GET method, e.g. your favourite web browser:
https://esmdev.mi.ingv.it/esmws/website-events/1/query?esm-id=INT-20220209_0000149https://esmdev.mi.ingv.it/esmws/website-events/1/query?hypocentral-depth-to=10&output-format=geojsonhttps://esmdev.mi.ingv.it/esmws/website-events/1/query?magnitude-from=5&magnitude-to=6&min-number-of-records=50&pagination-limit=50ESM Administrators and users with special authorizations can access data intended for internal use and/or embargoed.
Data can be obtained using any program supporting the HTTP-POST method, e.g. CURL:
curl -X POST -F "message=@path/to/token.txt" "https://esmdev.mi.ingv.it/esmws/website-events/1/query?network-code=NP&station-code=1581"HTTP-POST variables (required)
| Option | Description |
|---|---|
| message | The clearsign token obtained from the generate-signed-message authentication webservice. |
| Option | Description | Default |
|---|---|---|
| output-file | Filename of the output file. '.csv' in case of '--oformat csv', '.json' with '--oformat geojson', and '.kml' with '--oformat kml' | output.csv |
| output-format | {json,geojson,kml,csv} Specify format of result | json |
| json-output-style | {compact,verbose} Specify a style for output | compact |
| indent-json | {True,False} Valid only in combination with 'json' format. Prettifies output setting a 4 spaces indentation style. | False |
| pagination-limit | Pagination limit. Dafault value '0' corresponds to no limit raws for the results. | 0 |
| pagination-offset | {True,False} Pagination offset. Dafault value '0' corresponds to no pgination. | False |
| orderby-field | Results are shown ordered by field-direction | date |
| orderby-direction | {'desc','asc'} Direction of the orderby-field parameter. | desc |
| QUICK SEARCH | ||
| esm-id | Select a specific event by ESM-ID according to the ESM database. Event ids containing the specified string will be selected. | n/a |
| event-name | Select a specific event by ID; Event names containing the specified string will be selected. | n/a |
| date-time-from | Limit to events on or after the specified start time. Allowed formats: 'YYYY-MM-DDTHH:MM:SS' and 'YYYY-MM-DD'. | 1900-01-01T00:00:00 |
| date-time-to | Limit to events on or before the specified end time. Allowed formats: 'YYYY-MM-DDTHH:MM:SS' and 'YYYY-MM-DD'. | '2100-01-01T00:00:00' |
| min-number-of-records | Limit to events with an associated waveforms number larger than the specified minimum. | 0 |
| GEOPHYSICAL METADATA | ||
| hypocentral-depth-from | Limit to events with hypocentral depth (in km) greater than the specified minimum. | 0 |
| hypocentral-depth-to | Limit to events with hypocentral depth (in km) smaller than the specified minimum. | 100000 |
| magnitude-from | Limit to events with the preferred magnitude larger than the specified minimum. | 0 |
| magnitude-to | Limit to events with the preferred magnitude smaller than the specified minimum. | 10 |
| style-of-faulting | {NF,NS,O,SS,TF,TS,U,any} Specify the style of faulting ('NF' = normal faulting; 'TF' = thrust faulting; 'SS' = strike-slip faulting; 'U' = unknown). | any |
| GEOGRAPHIC METADATA | ||
| latitude-from | Limit to events with a latitude larger than or equal to the specified minimum. | -90 |
| latitude-to | Limit to events with a latitude smaller than or equal to the specified maximum. | 90 |
| longitude-from | Limit to events with a longitude larger than or equal to the specified minimum. | -180 |
| longitude-to | Limit to events with a longitude smaller than or equal to the specified maximum. | 180 |
| event-country | ISO code of country in which the event occurred. | any |
| EVENTS PER STATION | ||
| network-code | Select one network code. | n/a |
| station-code | Specify one station code. | n/a |
Backend Python software used by this web service is developed and maintained by Felicetta C. and Russo E.