Latest blog posts
Lucy Ofiesh
2023 May 30

Our annual call for board nominations

The Crossref Nominating Committee invites expressions of interest to join the Board of Directors of Crossref for the term starting in March 2024. The committee will gather responses from those interested and create the slate of candidates that our members will vote on in an election in September. Expressions of interest will be due Monday, June 26th, 2023. About the board elections The board is elected through the “one member, one vote” policy wherein every member organization of Crossref has a single vote to elect representatives to the Crossref board.

...Find out more
Kornelia Korzec
2023 May 12

Metadata connects the global community – summary of our Community update 2023

We were delighted to engage with over 200 community members in our latest Community update calls. We aimed to present a diverse selection of highlights on our progress and discuss your questions about participating in the Research Nexus. For those who didn’t get a chance to join us, I’ll briefly summarise the content of the sessions here and I invite you to join the conversations on the Community Forum. You can take a look at the slides here and the recordings of the calls are available here.

...Find out more
Patrick Polischuk
2023 May 02

2023 public data file now available with new and improved retrieval options

We have some exciting news for fans of big batches of metadata: this year’s public data file is now available. Like in years past, we’ve wrapped up all of our metadata records into a single download for those who want to get started using all Crossref metadata records. We’ve once again made this year’s public data file available via Academic Torrents, and in response to some feedback we’ve received from public data file users, we’ve taken a few additional steps to make accessing this 185 gb file a little easier.

...Find out more
Fabienne Michaud
2023 May 01

Similarity Check: look out for a refreshed interface and improvements for iThenticate v2 account administrators

In 2022, we flagged up some changes to Similarity Check, which were taking place in v2 of Turnitin’s iThenticate tool used by members participating in the service. We noted that further enhancements were planned, and want to highlight some changes that are coming very soon. These changes will affect functionality that is used by account administrators, and doesn’t affect the Similarity Reports themselves. From Wednesday 3 May 2023, administrators of iThenticate v2 accounts will notice some changes to the interface and improvements to the Users, Groups, Integrations, Statistics and Paper Lookup sections.

...Find out more
  • Menu
search

Documentation

Using HTTPS to query

Most queries sent to our XML API will use HTTPS. HTTPS querying requires either a member account or that you supply your email address in the query. Use a DOI-to-metadata query when you know the DOI and want to find its associated metadata.

HTTPS query examples

DOI-to-metadata query example

https://0-doi-crossref-org.lib.rivier.edu/servlet/query?pid={email@address.com}&id=10.1577/H02-043

DOI-to-metadata query requesting UNIXSD results

https://0-doi-crossref-org.lib.rivier.edu/servlet/query?pid={email@address.com}&format=unixsd**&id=10.1577/H02-043

DOI-to-metadata queries may also be supplied using this format

https://0-doi-crossref-org.lib.rivier.edu/search/doi?pid={email@address.com}&doi=10.1577/H02-043

XML query

https://0-doi-crossref-org.lib.rivier.edu/servlet/query?usr={email@address.com}&format=unixref&qdata=<?xml version="1.0"?><query_batch version="2.0"...

where:

  • usr is your email address
  • format is the desired results format
  • qdata is the query data (XML is the recommended format)
  • id is a Crossref DOI

XML querying

An XML query must contain complete and valid query XML. Multiple queries may be included in a single XML file, but the <query> element is repeatable. For best results, do not exceed 5 queries per HTTPS XML query request.

Multiple queries in a single request

https://0-doi-crossref-org.lib.rivier.edu/servlet/query?usr=username&pwd=password&qdata=<?xml version = "1.0" encoding="UTF-8"?>  
<query_batch xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.0" xmlns="http://0-www-crossref-org.lib.rivier.edu/qschema/2.0"  xsi:schemaLocation="http://0-www-crossref-org.lib.rivier.edu/qschema/2.0 http://0-www-crossref-org.lib.rivier.edu/qschema/crossref_query_input2.0.xsd"><head><email_address>support@crossref.org</email_address><doi_batch_id>ABC_123_fff</doi_batch_id> </head> <body> <query key="query1" enable-multiple-hits="true" forward-match="false"><issn match="optional">15360075</issn><journal_title match="exact">American Journal of Bioethics</journal_title><author match="fuzzy" search-all-authors="false">Agich</author><volume match="fuzzy">1</volume><issue>1</issue><first_page>50</first_page><year>2001</year><article_title>The Salience of Narrative for Bioethics</article_title></query><query key="query2" enable-multiple-hits="true"><unstructured_citation>Hungate, B. A., &amp; Hampton, H. M. (2012). Ecosystem services: Valuing ecosystems for climate. Nature Climate Change, 2(3), 151-152.</unstructured_citation></query></body></query_batch>

HTTPS XML query example

https://0-doi-crossref-org.lib.rivier.edu/servlet/query?usr=email@address.com&qdata=<?xml version = "1.0" encoding="UTF-8"?>  
<query_batch xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.0" xmlns="http://0-www-crossref-org.lib.rivier.edu/qschema/2.0"  xsi:schemaLocation="http://0-www-crossref-org.lib.rivier.edu/qschema/2.0 http://0-www-crossref-org.lib.rivier.edu/qschema/crossref_query_input2.0.xsd"><head><email_address>support@crossref.org</email_address><doi_batch_id>ABC_123_fff</doi_batch_id> </head> <body> <query key="1178517" enable-multiple-hits="false" forward-match="false"><issn match="optional">15360075</issn><journal_title match="exact">American Journal of Bioethics</journal_title><author match="fuzzy" search-all-authors="false">Agich</author><volume match="fuzzy">1</volume><issue>1</issue><first_page>50</first_page><year>2001</year><article_title>The Salience of Narrative for Bioethics</article_title></query></body></query_batch>

HTTPS XML query with an unstructured (formatted) citation

Learn more about querying with an unstructured (formatted) citation

https://0-doi-crossref-org.lib.rivier.edu/servlet/query?usr=email@address.com&format=unixref&qdata=<?xml version = "1.0" encoding="UTF-8"?><query_batch xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.0" xmlns="http://0-www-crossref-org.lib.rivier.edu/qschema/2.0" xsi:schemaLocation="http://0-www-crossref-org.lib.rivier.edu/qschema/2.0 http://0-www-crossref-org.lib.rivier.edu/qschema/crossref_query_input2.0.xsd"><head><email_address>your@email.org</email_address><doi_batch_id>01032012</doi_batch_id></head><body><query key="q1" enable-multiple-hits="true"><unstructured_citation>Hungate, B. A., &amp; Hampton, H. M. (2012). Ecosystem services: Valuing ecosystems for climate. Nature Climate Change, 2(3), 151-152.</unstructured_citation></query></body></query_batch>

HTTPS XML query with URL encoding

https://doi.crossref.org/servlet/query?usr=email@address.com&qdata=%3C?xml%20version=%221.0%22?%3E%3Cquery_batch%20version=%222.0%22%20xsi:schemaLocation=%22https://0-www-crossref-org.lib.rivier.edu/qschema/2.0%20https://0-www-crossref-org.lib.rivier.edu/qschema/crossref_query_input2.0.xsd%22%20xmlns=%22https://0-www-crossref-org.lib.rivier.edu/qschema/2.0%22%20xmlns:xsi=%22http://www.w3.org/2001/XMLSchema-instance%22%3E%3Chead%3E%3Cemail_address%3Esupport@crossref.org%3C/email_address%3E%3Cdoi_batch_id%3EABC_123_fff%3C/doi_batch_id%3E%20%3C/head%3E%20%3Cbody%3E%20%3Cquery%20key=%221178517%22%20enable-multiple-hits=%22false%22%20forward-match=%22false%22%3E%3Cissn%20match=%22optional%22%3E15360075%3Cissn%3Cjournal_title%20match=%22exact%22%3EAmerican%20Journal%20of%20Bioethics%3C/journal_title%3E%3Cauthor%20match=%22fuzzy%22%20search-all-authors=%22false%22%3EAgich%3C/author%3E%3Cvolume%20match=%22fuzzy%22%3E1%3C/volume%3E%3Cissue%3E1%3C/issue%3E%3Cfirst_page%3E50%3C/first_page%3E%3Cyear%3E2001%3C/year%3E%3Carticle_title%3EThe%20Salience%20of%20Narrative%20for%20Bioethics%3C/article_title%3E%3C/query%3E%3C/body%3E%3C/query_batch%

Note that some characters must be URL-encoded:

CharacterNameURL code
;Semi-colon%3B
/Slash, virgule, separatrix, or solidus%2F
?Question mark%3F
:Colon%3A
@At sign, arobase%40
=Equals sign%3D
&Ampersand%26
lfline feed%0A

Page owner: Patrick Polischuk   |   Last updated 2020-April-08