RESTful Operations

The Springer API supports a number of different operations and return formats. These can be controlled by issuing RESTful requests to the API service at http://api.springer.com.

Requests must always include both a Collection and a ResultFormat. The Collection identifies what repository should be searched for results and the ResultFormat indicates how data should be returned by the API. For example, in this request:

http://api.springer.com/metadata/pam/doi/10.1007/s11276-008-0131-4?api_key=yourKeyHere

The first bold element is the Collection and the second is the ResultFormat. In this case the metadata repository is being searched and the resulting metadata should be returned in pam format. Allowable values for these parameters are listed in the table below:

Valid Collection and ResultFormat parameters
Collection Description ResultFormat Description
meta versioned
Stores journal articles and book chapters in new version pam Returns XML results with each record in PRISM Aggregator Message format (*with some additional journal- or book-specific fields not covered by PAM at this time [e.g., openAccess])
json Returns JSON formatted results
jsonp Returns JSON formatted results with padding
metadata Stores journal articles and book chapters pam Returns XML results with each record in PRISM Aggregator Message format (*with some additional journal- or book-specific fields not covered by PAM at this time [e.g., openAccess])
json Returns JSON formatted results
jsonp Returns JSON formatted results with padding
openaccess

Stores open access content

app Returns XML data in Springer's A++ format
    jats Returns JATS formatted xml results (JATS for Articles, BITS for Chapters)
    json Returns JSON formatted metadata results
    jsonp Returns JSON formatted metadata with padding
integro Stores Springer’s journals xml Returns XML data

In example below the third part of the URI path doi is a short-hand method of requesting metadata for a single article. It is equivalent to doing a query for a single DOI using the q parameter:

http://api.springer.com/metadata/pam?q=doi:10.1007/s11276-008-0131-4&api_key=yourKeyHere

Available short-hand methods
method Description
doi Find a single article based on the DOI
issn Find a set of articles in a single Journal ISSN
isbn Find a set of chapters in a single Book ISBN

More complex requests can be made using querystring parameters. For further information on these read the next section.


Privacy Policy