DOI General Paper

XML API - doi.crossref.org/servlet/query?id={doi}

Q

How to use XML API URL, doi.crossref.org/servlet/query?id={doi}, for DOI-to-metadata query?

✍: FYIcenter.com

A

XML API URL doi.crossref.org/servlet/query?id={doi} allows you to query for metadata of a given DOI and receive output in XML format.

This XML API supports the following parameters: 

pid={email} - Required. The email address to identify yourself.
format={format} - Optional. The format for the returning XML: xsd_xml, unixsd or unixref.
id={doi} - Required if "data" is not provided. The DOI of the research paper.
qdata={query_xml} - Required if "id" is not provided. The XML string of the query.

Here is an example of how to use the XML API with the default format, which is a simple text format, not XML: 

fyicenter$ curl 'https://doi.crossref.org/servlet/query?pid=email@address.com&id=10.1577/H02-043'
 
0899-7659,1548-8667|Journal of Aquatic Animal Health|Hawke|15|3|189|2003|full_text||10.1577/H02-043

Here is the same query with response in 'unixref' format: 

fyicenter$ curl 'https://doi.crossref.org/servlet/query?pid=email@address.com&id=10.1577/H02-043&format=unixref'
 
<?xml version="1.0" encoding="UTF-8"?>
<doi_records>
  <doi_record owner="10.1002" timestamp="2020-04-02 06:37:10">
    <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>
...

Here is the same query with response in 'unixsd' format: 

fyicenter$ curl 'https://doi.crossref.org/servlet/query?pid=email@address.com&id=10.1577/H02-043&format=unixsd'

<?xml version="1.0" encoding="UTF-8"?>
<crossref_result xmlns="http://www.crossref.org/qrschema/3.0" version="3.0" 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xsi:schemaLocation="http://www.crossref.org/qrschema/3.0 http://www.crossref.org/schemas/crossref_query_output3.0.xsd">
  <query_result>
    <head>
      <doi_batch_id>none</doi_batch_id>
    </head>
    <body>
      <query status="resolved">
        <doi type="journal_article">10.1577/H02-043</doi>
        <crm-item name="publisher-name" type="string">Wiley</crm-item>
        <crm-item name="prefix-name" type="string">Wiley (John Wiley & Sons)</crm-item>
        <crm-item name="member-id" type="number">311</crm-item>
        <crm-item name="citation-id" type="number">11719606</crm-item>
        <crm-item name="journal-id" type="number">28145</crm-item>
        <crm-item name="deposit-timestamp" type="number">2011120809095000643</crm-item>
        <crm-item name="owner-prefix" type="string">10.1002</crm-item>
        <crm-item name="last-update" type="date">2020-04-02T10:37:10Z</crm-item>
        <crm-item name="created" type="date">2004-06-07T20:39:40Z</crm-item>
        <crm-item name="citedby-count" type="number">20</crm-item>
        <doi_record>
          <crossref xmlns="http://www.crossref.org/xschema/1.1" xsi:schemaLocation="http://www.crossref.org/xschema/1.1 http://doi.crossref.org/schemas/unixref1.1.xsd">
            <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>
...

See next tutorial on how to use the "qdata={query_xml}" parameter.

 

⇒ XML API - doi.crossref.org/servlet/query?qdata={xml}

⇐ DOI API for Python - Crossref Commons

⇑ Crossref.org DOI Database

⇑⇑ DOI - Frequently Asked Questions

2022-10-08, 526👍, 0💬

DOI General Paper