Using the GEOFON/FDSN web services

GEOFON offers access to seismic waveform and station metadata using the FDSN web services. Requests may be submitted by anyone, using any suitable web client.

We offer the following services from geofon.gfz-potsdam.de:

  • fdsnws-station - Inventory for networks archived at GFZ. A current list of networks is available. In particular, networks which are coordinated as part of EIDA but not archived here are not available by web service. Their data can be accessed using our data portal or by other methods.
  • fdsnws-dataselect - Real time and archive data for those networks archived at GFZ (not other EIDA data centres). You can check availability with our availability database.

A few example URLs are given below.

We do not offer an fdsnws-event earthquake parameter service, but you may find our popular eqinfo event catalog helpful.

Examples

fdsnws-station

http://geofon.gfz-potsdam.de/fdsnws/station/1/version
Returns the string "1.1.0".
http://geofon.gfz-potsdam.de/fdsnws/station/1/query?net=GE&level=station
Returns basic information as FDSN StationXML about all stations in the GEOFON seismic network.
http://geofon.gfz-potsdam.de/fdsnws/station/1/query?net=GE&sta=BKB&cha=BHZ&level=channel
Returns channel-level information as FDSN StationXML for the BHZ channel at GEOFON station Balikpapan, Kalimantan.

fdsnws-dataselect

http://geofon.gfz-potsdam.de/fdsnws/dataselect/1/version
Returns the string "1.1.0".
http://geofon.gfz-potsdam.de/fdsnws/dataselect/1/query?net=GE&sta=BKB&cha=BHZ&starttime=2011-03-11T06:00:00Z&endtime=2011-03-11T06:05:00Z
Returns 300 seconds of data from 0600 UTC on 11 March 2011, for the BHZ channel at GEOFON station Balikpapan, Kalimantan.
http://geofon.gfz-potsdam.de/fdsnws/dataselect/1/query?net=GE&sta=KBU&starttime=2012-06-01&endtime=2012-06-04&nodata=404
Requests data from the GEOFON station in Kabul, Afghanistan; since this is not available, the service returns "404 Not Found" instead.

Access to restricted data with webservices

Stations with restricted channels are not available through the FDSN webservices at this stage.

Notes

  1. The current implementation supports the version 1.0 specification. [Web Services Version 1.0 Specification] There are a few special features, described further at the SeisComP online documentation for
    fdsnws
    [Specific page for the 2013.340 release]. In particular you may add
    &nodata=404
    to return a HTTP response code 404 instead of the usual 204, should no data was found.
  2. There are some limits on the size of requests which will be accepted:
    • There is a maximum number of objects which fdsnws-station will return. This is currently 100000 objects.
    • There is a maximum number of samples which fdsnws-dataselect will return. This is currently 100 million samples.
    There are also some limits on the total number of simultaneous users. If you plan to send many automatic requests, please arrange to send them slowly (no faster than one per minute) to avoid inconveniencing other users.