crossref.org API - /works for Research Papers

Q

How to use crossref.org API resource, /works, for research papers?

✍: FYIcenter.com

A

crossref.org API resource /works allows you to to list, search or retrieve DOI entries for research papers. It supports the following variations and parameters:

1. Get the first 20 DOI entries:

fyicenter$ curl https://api.crossref.org/works

2. Search for DOI entries with keywords:

fyicenter$ curl https://api.crossref.org/works?query={keywords}

3. Search for DOI entries with keywords in a given field:

fyicenter$ curl https://api.crossref.org/works?query.title={keywords}
fyicenter$ curl https://api.crossref.org/works?query.author={keywords}
...

4. Sort search result

fyicenter$ curl https://api.crossref.org/works?sort=published&order=asc|desc

5. Filter search result:

fyicenter$ curl https://api.crossref.org/works?filter=type:journal-article
fyicenter$ curl https://api.crossref.org/works?filter=from-pub-date:2022-03-03
fyicenter$ curl https://api.crossref.org/works?filter=until-update-date:2022-06-06
...

6. Select specific returning fields:

fyicenter$ curl https://api.crossref.org/works?select=DOI,title,author,published

7. Loop over large number of DOI entries:

fyicenter$ curl https://api.crossref.org/works?offset=0&rows=20
fyicenter$ curl https://api.crossref.org/works?offset=20&rows=20
...

8. Get metadata of a given DOI:

fyicenter$ curl https://api.crossref.org/works/{doi}
fyicenter$ curl https://api.crossref.org/works/10.1037/0003-066x.59.1.29

{
  "status": "ok",
  "message-type": "work",
  "message-version": "1.0.0",
  "message": {
    "reference-count": 105,
    "publisher": "American Psychological Association (APA)",
    "issue": "1",
    "short-container-title": [
      "American Psychologist"
    ],
    "DOI": "10.1037\/0003-066x.59.1.29",
    "type": "journal-article",
    "created": {
      "date-parts": [
        [
          2004,
          1,
          21
        ]
      ],
      "timestamp": 1074695479000
    },
    "page": "29-40",
    "source": "Crossref",
    "is-referenced-by-count": 95,
    "title": [
      "How the Mind Hurts and Heals the Body."
    ],
    "prefix": "10.1037",
    "volume": "59",
    "author": [
      {
        "given": "Oakley",
        "family": "Ray",
        "sequence": "first",
        "affiliation": []
      }
    ],
    "member": "15",
    "published-online": {
      "date-parts": [
        [
          2004
        ]
      ]
    },
    "container-title": [
      "American Psychologist"
    ],
    "language": "en",
    "link": [
      {
        "URL": "http:\/\/psycnet.apa.org\/journals\/amp\/59\/1\/29.pdf",
        "intended-application": "similarity-checking"
      }
    ],
    "URL": "http:\/\/dx.doi.org\/10.1037\/0003-066x.59.1.29",
    "ISSN": [
      "1935-990X",
      "0003-066X"
    ]
  }
  ...

Not that crossref.org only provides DOI metadata for DOIs registered by crossref.org. If search for a DOI registered by another DOI Registration Agency, you will get an error:

fyicenter$ curl https://api.crossref.org/works/10.5438/0012

Resource not found.

 

crossref.org API - /journals for Journals

crossref.org API - /prefixes for DOI Prefixes

Crossref.org DOI Database

⇑⇑ DOI - Frequently Asked Questions

2022-12-21, 1079👍, 3💬