DataCite Help and Documentation Portal

DataCite Content Resolver

Access the DataCite Content Resolver here: https://data.datacite.org

What is the DataCite Content Resolver?

The DataCite Content Resolver allows you to retrieve a particular representation of DOI in different formats. A content negotiated request to a DOI resolver is very similar to a standard HTTP request, but based on the list of acceptable content types.

It can be used by an HTTP client by configuring its HTTP Accept headers, or directly through a browser, constructing a URL.

Citation Formatter

The DataCite Citation Formatter is a particular implementation of the DataCite Content Resolver. If you want more information, please visit DataCite Citation Formatter Documentation.

Who can use the DataCite Content Resolver?

The Content Resolver is open to the whole community. It is particularly designed to provide direct access to all our DOIs, simplify integrations and avoid format conversions.

How does the DataCite Content Resolver work?

The DOI resolver at doi.org will normally redirect a user to the resource location of a DOI. For example, the DOI "10.5284/1015681" redirects to a landing page describing the dataset, "Excavation of a Romano-British Cemetery...". Content negotiated requests to doi.org that ask for a content type which isn't "text/html" will be redirected to the metadata service hosted by DataCite.

       GET "Accept: text/html"
https://doi.org/10.5284/1015681

                   |
                   |
                   |
                   V

       Repository landing page
archaeologydataservice.ac.uk/archives/view/greylit/details.cfm?id=13979

Normal browser requests or explicit requests for text/html redirect to the content's landing page.

    GET "Accept: application/rdf+xml"
     https://doi.org/10.5284/1015681
                 |
                 |
                 |
                 V
       DataCite metadata service
http://data.datacite.org/10.5284/1015681

Requests for a data type redirect to a registration agency's metadata service.

Content Negotiation

Making a content negotiated request requires the use of a HTTP header, Accept. Content types that are acceptable to the client (those that it knows how to parse), each with an optional "quality" value indicating its relative suitability. For example, a client that wishes to receive citeproc JSON if it is available, but which can also handle RDF XML if citeproc JSON is unavailable, would make a request with an Accept header listing both "application/citeproc+json" and "application/rdf+xml":

$ curl -LH "Accept: application/rdf+xml;q=0.5, application/vnd.citationstyles.csl+json;q=1.0" https://doi.org/10.5284/1015681

This request favours citeproc JSON but will accept RDF XML if citeproc is unavailable. The q values are optional. The request could have been written without them. The order of content types then becomes important; more suitable content types should be placed at the front of the Accept header.

$ curl -LH "Accept: application/vnd.citationstyles.csl+json, application/rdf+xml" https://doi.org/10.5284/1015681

DataCite supports different response codes, listed below. If multiple content types specified by the client are supported by a DOI then the content type with the highest "q" value (or, if no "q" values are specified, the one that appears first in the "accept" header) will be returned.

Code
Meaning

200

The request was OK.

204

The request was OK but there was no metadata available.

404

The DOI requested doesn't exist.

Link-based Content Type Requests

DataCite supports link-based content type requests. This method can be used with a regular web browser. In order to get a specific format please construct a URL following this pattern: https://data.datacite.org/MIME_TYPE/DOI

This method allows DataCite data centres to link additional metadata and data itself using custom URLs, still using the primary URL for the DOI to point to the landing page of a data set.

For example, https://doi.org/10.5284/1015681 is a report in PDF format. It can be downloaded from its landing page, or automatically requesting:

$ curl https://data.datacite.org/application/pdf/10.5284/1015681

Supported Content Types

DataCite supports a number of metadata content types:

Format
Content Type

application/rdf+xml

text/turtle

application/vnd.citationstyles.csl+json

application/vnd.schemaorg.ld+json

application/vnd.codemeta.ld+json

text/x-bibliography

application/x-research-info-systems

application/x-bibtex

application/vnd.datacite.datacite+xml

application/vnd.datacite.datacite+json

Would you like to know more?

This document has been adapted from the Crosscite documentation, maintained by Crossref, DataCite, mEDRA and ISTIC.

If you have any questions, requests or ideas please contact us!

DataCite Content Resolver