Location object
Last updated
Last updated
The Location
object describes the location of a given work. It's only found as part of the Work
object.
Locations are meant to capture the way that a work exists in different versions. So, for example, a work may have a version that has been peer-reviewed and published in a journal (the version of record). This would be one of the work's locations. It may have another version available on a preprint server like bioRxiv—this version having been posted before it was accepted for publication. This would be another one of the work's locations.
Below is an example of a work in OpenAlex (https://openalex.org/W2807749226) that has multiple locations with different properties. The version of record, published in a peer-reviewed journal, is listed first, and is not open-access. The second location is a university repository, where one can find an open-access copy of the published version of the work. Other locations are listed below.
Locations are meant to cover anywhere that a given work can be found. This can include journals, proceedings, institutional repositories, and subject-area repositories like arXiv and bioRxiv. If you are only interested in a certain one of these (like journal), you can use a filter to specify the locations.source.type
. (Learn more about types here.)
There are three places in the Work
object where you can find locations:
primary_location
: The best (closest to the version of record) copy of this work.
best_oa_location
: The best available open access location of this work.
locations
: A list of all of the locations where this work lives. This will include the two locations above if availabe, and can also include other locations.
is_accepted
Boolean: true
if this location's version
is either acceptedVersion
or publishedVersion
; otherwise false
.
is_oa
Boolean: True
if an Open Access (OA) version of this work is available at this location.
There are many ways to define OA. OpenAlex uses a broad definition: having a URL where you can read the fulltext of this work without needing to pay money or log in.
is_published
Boolean: true
if this location's version
is publishedVersion
; otherwise false
.
String: The landing page URL for this location.
String: The location's publishing license. This can be a Creative Commons license such as cc0 or cc-by, a publisher-specific license, or null which means we are not able to determine a license for this location.
Object: Information about the source of this location, as a DehydratedSource
object.
The concept of a source is meant to capture a certain social relationship between the host organization and a version of a work. When an organization puts the work on the internet, there is an understanding that they have, at some level, endorsed the work. This level varies, and can be very different depending on the source!
String: A URL where you can find this location as a PDF.
String: The version of the work, based on the DRIVER Guidelines versioning scheme. Possible values are:.
publishedVersion
: The document’s version of record. This is the most authoritative version.
acceptedVersion
: The document after having completed peer review and being officially accepted for publication. It will lack publisher formatting, but the content should be interchangeable with the that of the publishedVersion
.
submittedVersion
: the document as submitted to the publisher by the authors, but before peer-review. Its content may differ significantly from that of the accepted article.