SHERPA/RoMEO Logo   . . . opening access to research  
Home  •  Search •  Journals •  Publishers •  FAQ •  Suggest •  About  

Application Programmers' Interface

English | Español | Magyar | Português  

RoMEO Home | Introduction | Versions & Documentation | Recent Changes | How to use the API | Searching for Journals by Title | Wish List

Introduction

The SHERPA/RoMEO Application Programmers' Interface (API) is a machine-to-machine interface that lets programmers access SHERPA/RoMEO data from their applications. For instance, you could use the API to incorporate an automatic look-up of a journal or publisher into your repository or CRIS deposition process.

We encourage you to play with the API and explore the potential for including it in your own repository and CRIS software. Please send any suggestions and feedback either on the API itself or on the documentation to Peter Millington (romeo@sherpa.ac.uk).

Versions and Documentation

The latest version of the SHERPA/RoMEO API is Version 2.9, which generates XML output that can be validated against its DTD. Earlier versions of the API are no longer supported.

The root URL for the API is:

http://www.sherpa.ac.uk/romeo/api29.php

Full technical details are available in the following documentation download:

We strongly recommend that regular and heavy API users register for a free API Key. This allows you to exceed our limit of 500 requests per day and has a number of other benefits.

Recent Changes

Recently implemented changes include:

A full list of changes is given in Appendix D of the documentation.

How to use the API

The basic principle is that an application makes an HTTP request to the API, which returns an XML stream with the search results. The query specification is given in the URL's parameters. The main searches that are available are for journal title, ISSN and publisher's name, although there are also some special searches, such as for RoMEO colours. View the following links in your browser to see examples.

Searching for Journals by Title using the API

Although it would be nice to be able to automate fully the look-up of journal publishers using the API, this may often not be possible, because a query may return zero or many results. Even if a single journal is found, it is advisable to confirm that it is indeed the correct one. We therefore recommend the following general approach to handling journal queries:

  1. Search by journal title, and display the title(s) found
  2. Get the end-user to confirm/select the correct title - even when only a single title is found.
  3. Retrieve and display the publisher's details (if any)

Wish List

Wishes and ideas for the future enhancement of the API have been collated from a survey of SHERPA/RoMEO Application Programmers' Interface (API) users, notes from breakout sessions at the RoMEO API Workshop, Edinburgh, 1st September 2010, and subsequent feedback received from users. We have started updating the wish list, so you are invited to send us further ideas and feedback. View the API Wish List >>

Updated: 25-Nov-2013

© 2006-2014, University of Nottingham Contact us