Old OpenAlex API documentation
  • Overview
  • Quickstart tutorial
  • API Entities
    • Entities overview
    • πŸ“„Works
      • Work object
        • Authorship object
        • Location object
      • Get a single work
      • Get lists of works
      • Filter works
      • Search works
      • Group works
      • Get N-grams
    • πŸ‘©Authors
      • Author object
      • Get a single author
      • Get lists of authors
      • Filter authors
      • Search authors
      • Group authors
      • Limitations
      • Author disambiguation
    • πŸ“šSources
      • Source object
      • Get a single source
      • Get lists of sources
      • Filter sources
      • Search sources
      • Group sources
    • 🏫Institutions
      • Institution object
      • Get a single institution
      • Get lists of institutions
      • Filter institutions
      • Search institutions
      • Group institutions
    • πŸ’‘Topics
      • Topic object
      • Get a single topic
      • Get lists of topics
      • Filter topics
      • Search topics
      • Group topics
    • πŸ—οΈKeywords
    • 🏒Publishers
      • Publisher object
      • Get a single publisher
      • Get lists of publishers
      • Filter publishers
      • Search publishers
      • Group publishers
    • πŸ’°Funders
      • Funder object
      • Get a single funder
      • Get lists of funders
      • Filter funders
      • Search funders
      • Group funders
    • 🌎Geo
      • Continents
      • Regions
    • πŸ’‘Concepts
      • Concept object
      • Get a single concept
      • Get lists of concepts
      • Filter concepts
      • Search concepts
      • Group concepts
    • Aboutness endpoint (/text)
  • How to use the API
    • API Overview
    • Get single entities
      • Random result
      • Select fields
    • Get lists of entities
      • Paging
      • Filter entity lists
      • Search entities
      • Sort entity lists
      • Select fields
      • Sample entity lists
      • Autocomplete entities
    • Get groups of entities
    • Rate limits and authentication
  • Download all data
    • OpenAlex snapshot
    • Snapshot data format
    • Download to your machine
    • Upload to your database
      • Load to a data warehouse
      • Load to a relational database
        • Postgres schema diagram
  • Additional Help
    • Tutorials
    • Report bugs
    • FAQ
Powered by GitBook
On this page
  • External IDs
  • Select fields
  1. API Entities
  2. Works

Get a single work

PreviousLocation objectNextGet lists of works

Last updated 2 years ago

It's easy to get a work from from the API with: /works/<entity_id> Here's an example:

  • Get the work with the W2741809807:

That will return a object, describing everything OpenAlex knows about the work with that ID.

{
    "id": "https://openalex.org/W2741809807",
    "doi": "https://doi.org/10.7717/peerj.4375",
    "title": "The state of OA: a large-scale analysis of the prevalence and impact of Open Access articles",
    "display_name": "The state of OA: a large-scale analysis of the prevalence and impact of Open Access articles",
    "publication_year": 2018,
    "publication_date": "2018-02-13",
    // other fields removed for brevity
}

You can make up to 50 of these queries at once by requesting a list of entities and filtering on IDs ().

External IDs

You can look up works using external IDs such as a DOI:

  • Get the work with this DOI: https://doi.org/10.7717/peerj.4375:

You can use the full ID or a shorter Uniform Resource Name (URN) format like so:

  • Get the work with PubMed ID: https://pubmed.ncbi.nlm.nih.gov/14907713:

Available external IDs for works are:

External ID
URN

DOI

doi

Microsoft Academic Graph (MAG)

mag

PubMed ID (PMID)

pmid

PubMed Central ID (PMCID)

pmcid

You must make sure that the ID(s) you supply are valid and correct. If an ID you request is incorrect, you will get no result. If you request an illegal IDβ€”such as one containing a , or &, the query will fail and you will get a 403 error.

Select fields

You can use select to limit the fields that are returned in a work object. More details are .

Display only the id and display_name for a work object

πŸ“„
here
https://api.openalex.org/works/W2741809807?select=id,display_name
https://api.openalex.org/works/W2741809807
Work
tutorial
https://api.openalex.org/works/https://doi.org/10.7717/peerj.4375
https://api.openalex.org/works/pmid:14907713
OpenAlex ID
using OR syntax