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
  • How do I cite OpenAlex?
  • Are OpenAlex IDs stable?
  • Can you index my journal?
  • Do you disambiguate authors?
  • Do you gather author affiliations?
  • Where does your data come from?
  • How often is the data updated?
  • Is your data quality better than ____?
  • How is OpenAlex licensed?
  • How much does OpenAlex cost?
  • I've noticed incorrect data in an OpenAlex author profile. How can I correct it?
  • What's your sustainability plan?
  • I have a question about the openalexR library. Could you help me?
  • How can I count self-citations between works?
  • Do you provide access to full-text papers?
  1. Additional Help

FAQ

PreviousReport bugs

Last updated 9 months ago

How do I cite OpenAlex?

See our

Are OpenAlex IDs stable?

Yes!* The work associated with ID W1234 will keep the ID W1234.

When we find duplicated works, authors, etc that already have assigned IDs, we merge them. Merged entities will redirect to the proper entity in the API. In the data snapshot, there is a directory which lists the IDs that have been merged.

*In July 2023, OpenAlex switched to a , replaced all OpenAlex Author IDs with new ones. This is a very rare case in which we violate the rule of having stable IDs, which is needed to make the improvements. Old IDs and their connections to works remain available in the historical OpenAlex data.

Can you index my journal?

We automatically index new journals and articles so there is nothing you need to do. We primarily retrieve new records from . So if you are not seeing your journal or article in OpenAlex, it is best to check if it is in Crossref with a query like https://api.crossref.org/works/<doi> (). We do not curate journals or limit which journals will be included in OpenAlex. So any discoverable journals will be added to the data set.

If your example DOI is in Crossref but not in OpenAlex, please send us a so we can look into it further!

Do you disambiguate authors?

Yes. Using coauthors, references, and other features of the data, we can tell that the same Jane Smith wrote both "Frog behavior" and "Frogs: A retrospective," but it's a different Jane Smith who wrote "Oats before boats: The breakfast customs of 17th-Century Dutch bargemen." For more details on this, see the page on Author disambiguation.

Do you gather author affiliations?

Yes. We automatically gather and normalize author affiliations from both structured and unstructured sources.

Where does your data come from?

  • Web crawls

How often is the data updated?

Is your data quality better than ____?

Our dataset is still very young, so there's not a lot of systematic research comparing OpenAlex to peer databases like MAG, Scopus, Dimensions, etc. We're currently working on publishing some research like that ourselves. Our initial finding are very encouraging...we believe OpenAlex is already comparable in coverage and accuracy to the more established players--but OpenAlex is 100% open data, built on 100% open-source code. We think that's a really important feature. We will also continue improving the data quality in the days, weeks, months, and years ahead!

How is OpenAlex licensed?

How much does OpenAlex cost?

I've noticed incorrect data in an OpenAlex author profile. How can I correct it?

What's your sustainability plan?

I have a question about the openalexR library. Could you help me?

How can I count self-citations between works?

Do you provide access to full-text papers?

OpenAlex is not doing this alone! Rather, we're aggregating and standardizing data from a whole bunch of other great projects, like a river fed by many tributaries. Our two most important data sources are and Other key sources include:

Subject-area and institutional repositories from to and everywhere in between

Learn more at our general help center article:

For now, the database snapshot is updated about once per month. We also offer a much faster update cadence—as often as once every few hours—through

OpenAlex data is licensed as so it is free to use and distribute.

It's free! The , the , and the are all available at no charge. As a nonprofit, making this data free and open is part of our mission.

For those who would like a higher level of service and to provide direct financial support for our mission, we offer

Please see the help section on .

Our nonprofit (OurResearch) has a ten-year track record of building sustainable scholarly infrastructure, and a formal commitment to sustainability as part of

We're currently still exploring our options for OpenAlex's sustainability plan. Thanks to a generous grant from , we've got lots of runway, and we don't need to roll anything out in a rush.

Our Unpaywall project (a free index of the world's open-access research literature) has been self-sustaining via a freemium revenue model for nearly five years, and we have recently introduced a similar model in Access to the data will always be free for everyone, but OpenAlex Premium offers several benefits in service above the services we offer for free.

The package is a great way to work with the OpenAlex API using the R programming language, but it is third-party software that we do not maintain ourselves. Please direct any questions you have to them instead.

If you want to count self-citations—or, inversely independent citations where citing and the cited work do not have any authors in common—you can check each citation for whether they share any Author IDs in common in their field. See for more information.

We provide links to the full-text PDFs for open-access works whenever possible. In addition, we have access to raw full-text for many works either through PDF parsing we have done, or using the Internet Archive's general index, which we use to power our . You can learn more about this . We do not currently offer direct access to raw full-text through the API or data snapshot.

MAG
Crossref.
ORCID
ROR
DOAJ
Unpaywall
Pubmed
Pubmed Central
The ISSN International Centre
Internet Archive
arXiv
Zenodo
About the data
OpenAlex Premium.
CC0
website
API
database snapshot
OpenAlex Premium. Click here to learn more.
Author profile curation
our adoption of the POSI principles.
Arcadia
OpenAlex Premium.
openalexR
new, more accurate, author identification system
Crossref
example
support request
authorships
search
here
here
citation section here.