AHEAD - Bibliography web service

Using this web service, it is possible to retrieve bibliographical metadata of AHEAD data sources.

In case you encounter problems using this service do not hesitate contacting the developers.

Requests based on the data source identifier

You may retrieve the bibliographic metadata of a data source by directly entering its code or doi.

Parameter	Description	Example
biblioid	Type: text Bibliographical code used in AHEAD.	ALBRV010
doi	Type: text DOI associated to the data source.	10.1007/s10950-010-9187-6

Examples of Query

Requests based on the earthquake identifier

You may retrieve the bibliographic metadata of all the data sources related to a given earthquake by directly entering its event ID.

Parameter	Description	Example
eventid	Type: text Earthquake identifier in the AHEAD archive	18020512_0930_000

Example of Query

Bibliographic metadata

You may retrieve the bibliographic metadata of data sources by directly entering one or more metadata parameters.

Parameter	Default	Description	Example
author		Type: text Request publications by a specific author surname.	albini
authorsearchmethod		Type: text Allowed values: exact, startwith, endwith, contains Specify the method for searching a author.
title		Type: text Request publications having a specific title.	lisbon
titlesearchmethod		Type: text Allowed values: exact, startwith, endwith, contains Specify the method for searching a title.
journal		Type: text Request papers published in a specific journal.	journal of seismology
publisher		Type: text Request studies by a specific publisher.	springer
year		Type: integer Unit: year Limit to data sources published in a specific year.	2010
yearstart	1900	Type: integer Unit: year Limit to data sources published on or after the specified start year.
yearend		Type: integer Unit: year Limit to data sources published on or before the specified end year.	2011

Example of Query

Geographic constraints

You may retrieve the bibliographic metadata of data sources related to earthquakes with epicenters occurred in a given area as specified below.

Box area constraints (in alternative to Circular constraints)

Parameter	Default	Description
minlatitude (alias minlat)	-90	Type: float Unit: decimal degrees Allowed values: between -90 and 90 Limit to events with a latitude larger than or equal to the specified minimum.
maxlatitude (alias maxlat)	90	Type: float Unit: decimal degrees Allowed values: between -90 and 90 Limit to events with a latitude smaller than or equal to the specified maximum.
minlongitude (alias minlon)	-180	Type: float Unit: decimal degrees Allowed values: between -180 and 180 Limit to events with a longitude larger than or equal to the specified minimum.
maxlongitude (alias maxlon)	180	Type: float Unit: decimal degrees Allowed values: between -180 and 180 Limit to events with a longitude smaller than or equal to the specified maximum.

Example of Query

Circular constraints (in alternative to Box area constraints)

Parameter	Default	Description
latitude (alias lat)	0	Type: float Unit: decimal degrees Allowed values: between -90 and 90 Specify the latitude to be used for a radius search.
longitude (alias lon)	0	Type: float Unit: decimal degrees Allowed values: between -180 and 180 Specify the longitude to the used for a radius search.
minradius	0	Type: float Unit: geographical degrees Limit to events within the specified minimum number of degrees from the geographic point defined by the latitude and longitude parameters.
maxradius	1	Type: float Unit: geographical degrees Allowed values: between 1 and 5 Limit to events within the specified maximum number of degrees from the geographic point defined by the latitude and longitude parameters.
minradiuskm	0	Type: float Unit: km Limit to events within the specified minimum number of kilometers from the geographic point defined by the latitude and longitude parameters.
maxradiuskm	1	Type: float Unit: km Allowed values: between 1 and 500 Limit to events within the specified maximum number of kilometers from the geographic point defined by the latitude and longitude parameters.

Example of query

Output data structure

You can specify the format of the output of the query.

Parameter	Default	Description
format	xml_dc	Type: text Allowed values: xml_oai, xml_dc, rdf, bib, text, textshort, json Specify the format of result, either ‘xml’ (default) or ‘xml_complete’. The xml format is encoded using a custom scheme, highly inspired by the macroseismic extension of QuakeML 2.0. The text format will output a complete biliographic citation. The textshort format will output the short citation. The json format will output the most relevant metadata encoded in JSON.
orderby	year	Type: text Allowed values: author, year, title Order the result by place or identifier, using the following possibilities: author: order by the first author surname year: order by year of publication title: order by title of the publication
nodata	204	Type: boolean Allowed values: 204, 404 Select status code for “no data”, either ‘204’ or ‘404’.

Example of query

AHEAD European Archive of Historical EArthquake Data