Documentation

REST API

Our publicly available REST API exposes the scholarly metadata that members and trusted sources deposit with Crossref. This bibliographic metadata and much more—you will find funding data, license information, post-publication updates, ORCID and ROR IDs, and abstracts. You can search, facet, filter, or sample metadata from dozens of thousands of members from all around the world, and the results are returned in JSON format.

The metadata is deposited directly by our members, who publish the content represented by each metadata record. This is complemented by trusted sources, such as Retraction Watch. You will also find other identifiers, such as ORCID for individuals, RORs for funders and affiliations, and more. In some cases we add these identifiers where they are missing in the original deposit. There is an overview of the available content at Crossref stats.

No sign-up is required to use the REST API, and almost none of the metadata is subject to copyright, and you may use it for any purpose. Some abstracts contained in the metadata may be subject to copyright by publishers or authors.

Quick start

Use https://api-crossref-org.turing.library.northwestern.edu/ as your base URL. Add one of the available endpoints to query works, journals, members, funders, licences, prefixes, or types. Here are some examples to get you started:

I would like to…Example request
Use the polite poolhttps://api-crossref-org.turing.library.northwestern.edu/works?rows=0&mailto=yourmail@company.org
Retrieve metadata for a Crossref DOIhttps://api-crossref-org.turing.library.northwestern.edu/works/doi/10.1128/mbio.01735-25
Retrieve records for 10 content itemshttps://api-crossref-org.turing.library.northwestern.edu/works?rows=10
Find works in the journal Psychoneuroendocrinology, ISSN 03064530https://api-crossref-org.turing.library.northwestern.edu/journals/03064530/works

Endpoints

The Crossref REST API provides a number of endpoints for querying different types of records. Each endpoint has request parameters and filters to enable you to retrieve the metadata you are looking for. For further details about each endpoint, its parameters, and to try them out, see the Swagger documentation at https://api-crossref-org.turing.library.northwestern.edu/

EndpointMetadata returned
/worksA list of content items registered with Crossref. This endpoint has a large number of parameters and filters available.
/works/{doi}A single metadata record for a Crossref DOI.
/works/{doi}/agencyThe registration agency for the specified DOI (e.g., Crossref or DataCite).
/journalsA list of journals whose content with registered content items.
/journals/{issn}Details of the journal with the given ISSN.
/journals/{issn}/worksA list of works in the journal with the given ISSN.
membersA list of all organisations that have registered metadata with Crossref.
/members/{id}Details about the Crossref member with the specified member ID.
/members/{id}/works/A list of works associated with the specified member.
/prefixes/{prefix}The name and Crossref member ID of the steward of the specified prefix.
/prefixes/{prefix}/worksA list of works associated with the specified prefix.
/fundersA list of funders in the Open Funder Registry.
/funders/{id}Metadata for the member with the given ID.
/funders/{id}/worksA list of works associated with the specified funder ID.
/typesA list of all work types used in Crossref metadata.
/types/{id}Information about the specified work type, e.g. journal-article, monograph, grant.
/types/{id}/worksA list of works with the specified work type.
/licensesA list of licenses used by registered content items.

Content negotiation

The REST API can return single metadata records in a variety of formats through a process known as content negotiation. See the content negotiation page for more details.

Report an issue

Have you detected something that you would like to report? It could be incorrect, confusing, or partial metadata. Please report it on our community forum or check our backlog of bugs and feature requests to see if it has already been reported.

Page maintainer: Martyn Rittman
Last updated: 2020-April-08