Latest blog posts
Martyn Rittman
2024 November 15

Research Integrity Roundtable 2024

For the third year in a row, Crossref hosted a roundtable on research integrity prior to the Frankfurt book fair. This year the event looked at Crossmark, our tool to display retractions and other post-publication updates to readers. Since the start of 2024, we have been carrying out a consultation on Crossmark, gathering feedback and input from a range of members. The roundtable discussion was a chance to check and refine some of the conclusions we’ve come to, and gather more suggestions on the way forward.

...Find out more
Dominika Tkaczyk
2024 November 06

How good is your matching?

In our previous blog post in this series, we explained why no metadata matching strategy can return perfect results. Thankfully, however, this does not mean that it’s impossible to know anything about the quality of matching. Indeed, we can (and should!) measure how close (or far) we are from achieving perfection with our matching. Read on to learn how this can be done! How about we start with a quiz? Imagine a database of scholarly metadata that needs to be enriched with identifiers, such as ORCIDs or ROR IDs.

...Find out more
Kornelia Korzec
2024 October 28

Update on the Resourcing Crossref for Future Sustainability research

We’re in year two of the Resourcing Crossref for Future Sustainability (RCFS) research. This report provides an update on progress to date, specifically on research we’ve conducted to better understand the impact of our fees and possible changes. Crossref is in a good financial position with our current fees, which haven’t increased in 20 years. This project is seeking to future-proof our fees by: Making fees more equitable Simplifying our complex fee schedule Rebalancing revenue sources In order to review all aspects of our fees, we’ve planned five projects to look into specific aspects of our current fees that may need to change to achieve the goals above.

...Find out more
Lucy Ofiesh
2024 September 24

Meet the candidates and vote in our 2024 Board elections

On behalf of the Nominating Committee, I’m pleased to share the slate of candidates for the 2024 board election. Each year we do an open call for board interest. This year, the Nominating Committee received 53 submissions from members worldwide to fill four open board seats. We maintain a balanced board of 8 large member seats and 8 small member seats. Size is determined based on the organization’s membership tier (small members fall in the $0-$1,650 tiers and large members in the $3,900 - $50,000 tiers).

...Find out more
  • Menu
search

Documentation

DOI-to-metadata query

Metadata may be retrieved in JSON format using our REST API, or in XML format as documented below.

Most DOI-to-metadata queries are done via HTTPS using synchronous HTTPS queries, but may also be submitted as asynchronous batch queries.

Example HTTPS query 

https://doi.crossref.org/servlet/query?pid={email@address.com}&format=unixref&id=DOI

OpenURL query

We support DOI queries formatted as OpenURL version 0.1 requests. For complete metadata (UNIXREF) include the format="unixref" parameter.

https://www.crossref.org/openurl/?pid={myemail@crossref.org}&format=unixref&id=doi:10.1577/H02-043&noredirect=true

Query results: xsd_xml format (default) 

<crossref_result version="2.0" xsi:schemaLocation="https://www.crossref.org/qrschema/2.0 https://www.crossref.org/schema/queryResultSchema/crossref_query_output2.0.xsd" xmlns="https://www.crossref.org/qrschema/2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <query_result>
<head>
<doi_batch_id>none</doi_batch_id>
</head>
<body>
<query status="resolved" fl_count="6">
<doi type="journal_article">10.1577/H02-043</doi>
<issn type="print">0899-7659</issn>
<issn type="electronic">1548-8667</issn>
<journal_title>Journal of Aquatic Animal Health</journal_title>
<contributors>
<contributor sequence="first" contributor_role="author">
<given_name>John P.</given_name>
<surname>Hawke</surname>
</contributor>
<contributor sequence="additional" contributor_role="author">
<given_name>Ronald L.</given_name>
<surname>Thune</surname>
</contributor>
<contributor sequence="additional" contributor_role="author">
<given_name>Richard K.</given_name>
<surname>Cooper</surname>
</contributor>
<contributor sequence="additional" contributor_role="author">
<given_name>Erika</given_name>
<surname>Judice</surname>
</contributor>
<contributor sequence="additional" contributor_role="author">
<given_name>Maria</given_name>
<surname>Kelly-Smith</surname>
</contributor>
</contributors>
<volume>15</volume>
<issue>3</issue>
<first_page>189</first_page>
<last_page>201</last_page>
<year media_type="print">2003</year>
<publication_type>full_text</publication_type>
<article_title>Molecular and Phenotypic Characterization of Strains ofPhotobacterium damselaesubsp.piscicidaIsolated from Hybrid Striped Bass Cultured in Louisiana, USA</article_title>
</query>
</body>
</query_result>
</crossref_result>

Query results: UNIXREF format 

<doi_records>
<doi_record owner="10.1080" timestamp="2011-12-08 13:28:43">
<crossref>
<journal>
<journal_metadata language="en">
<full_title>Journal of Aquatic Animal Health</full_title>
<abbrev_title>Journal of Aquatic Animal Health</abbrev_title>
<issn media_type="print">0899-7659</issn>
<issn media_type="electronic">1548-8667</issn>
</journal_metadata>
<journal_issue>
<publication_date media_type="print">
<month>09</month>
<year>2003</year>
</publication_date>
<journal_volume>
<volume>15</volume>
</journal_volume>
<issue>3</issue>
</journal_issue>
<journal_article publication_type="full_text">
<titles>
<title>Molecular and Phenotypic Characterization of Strains of <i>Photobacterium damselae</i>subsp. <i>piscicida</i> Isolated from Hybrid Striped Bass Cultured in Louisiana, USA</title>
</titles>
<contributors>
<person_name sequence="first" contributor_role="author">
<given_name>John P.</given_name>
<surname>Hawke</surname>
</person_name>
<person_name sequence="additional" contributor_role="author">
<given_name>Ronald L.</given_name>
<surname>Thune</surname>
</person_name>
<person_name sequence="additional" contributor_role="author">
<given_name>Richard K.</given_name>
<surname>Cooper</surname>
</person_name>
<person_name sequence="additional" contributor_role="author">
<given_name>Erika</given_name>
<surname>Judice</surname>
</person_name>
<person_name sequence="additional" contributor_role="author">
<given_name>Maria</given_name>
<surname>Kelly-Smith</surname>
</person_name>
</contributors>
<publication_date media_type="print">
<month>09</month>
<year>2003</year>
</publication_date>
<pages>
<first_page>189</first_page>
<last_page>201</last_page>
</pages>
<publisher_item>
<item_number item_number_type="sequence-number">1</item_number>
<identifier id_type="doi">10.1577/H02-043</identifier>
</publisher_item>
<doi_data>
<doi>10.1577/H02-043</doi>
<resource>http://www.tandfonline.com/doi/abs/10.1577/H02-043</resource>
</doi_data>
</journal_article>
</journal>
</crossref>
</doi_record>
</doi_records>

DOI-to-metadata XML batch query

DOI-to-metadata queries can also be performed using XML, allowing the use of control features available only with XML queries.

Example XML query 

<?xml version = "1.0" encoding="UTF-8"?>
<query_batch version="2.0" xmlns = "https://www.crossref.org/qschema/2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <head>
      <email_address>support@crossref.org</email_address>
      <doi_batch_id>Sample multi resolve</doi_batch_id>
  </head>
  <body>
       <query key="mykey" expanded-results="true">
           <doi>10.1006/jmbi.2000.4282</doi>
       </query>
   </body>
</query_batch>

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