REST API

Give and get metadata that’s open and useful

Our REST API exposes the metadata that publishers provide Crossref when they register their content with us. And it’s not just the bibliographic metadata either. Funding data, license information, full-text links, ORCID iDs, abstracts, and Crossmark updates, are all available, if included in the publishers’ metadata.

Numerous tools and services rely on our metadata, be they for search, annotation, sharing, or analysis. Some common tasks for using our REST API include:

Many familiar brands use our metadata through this modern machine-interface. Check out the case studies from people like Authorea and SHARE.

Overview

Search, facet, filter or sample metadata from thousands of publisher members via our REST API. The information is continually updated as members update and add to their metadata with us. The REST API helps unlock the value behind the information publishers are depositing, by making it available to query easily and to integrate into other tools and services.

No sign-up is required to use the REST API, and the data can be treated as facts from publisher members. Therefore it is not subject to copyright and available to use for whatever purpose you may have.

Text and data mining

A pragmatic solution to interrogate content, text and data mining simplifies access for researchers who want to mine and analyze content on scholarly publisher sites. Because more science and research is being done programmatically, researchers increasingly need to access full-text content for data mining and analysis. Researchers need a way to avoid the hassle of negotiating individual bilateral agreements with publishers, and publishers needn’t negotiate bilateral agreements with thousands of researchers.

Members can include the Uniform Resource Identifiers (URIs) for their full text and access indicators (usage license or license waiver) along with the other publication metadata they deposit with Crossref. Including this information in the metadata makes it easy for researchers to access available content.

What are the benefits?

The transaction costs of text and data mining become less of a hurdle for both researchers and publishers, who spend less time making individual access arrangements and more time researching and publishing. Crossref does not charge a fee for negotiating access for text and data mining.

How does it work?

Here’s how text and data mining with Crossref works:

  • Step 1: The publisher deposits the URI for their full text and license/waivers along with other publication metadata at Crossref.
  • Step 2: The researcher finds content of interest registered with Crossref (e.g., journal articles) using their preferred discovery service.
  • Step 3: The researcher retrieves metadata for each piece of registered content, including license information.
  • Step 4: The researcher makes a full-text request from the publisher.
  • Step 5: If the publisher requires it, the researcher must read and click to accept the publisher’s Terms & Conditions of use via Crossref’s click-through negotiation service.
  • Step 6: The Publisher grants the researcher subscription rights and returns the full text.

Researchers and text miners can access content URIs and license information via the Crossref REST API.

If you are a publisher and would like to begin depositing URIs and access indicators, please email us at tdm@crossref.org

Last Updated: 2017 October 24 by Kirsty Meddings

}