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 ). This would be one of the work's locations. It may have another version available on a preprint server like —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 () 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.
There are three places in the Work
object where you can find locations:
is_accepted
is_oa
Boolean: True
if an Open Access (OA) version of this work is available at this location.
is_published
String: The landing page URL for this location.
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.
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.
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 and . If you are only interested in a certain one of these (like journal), you can use a to specify the locations.source.type
. ()
: The best (closest to the ) copy of this work.
: The best available open access location of this work.
: 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.
Boolean: true
if this location's is either acceptedVersion
or publishedVersion
; otherwise false
.
There are . 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.
Boolean: true
if this location's is publishedVersion
; otherwise false
.
String: The location's publishing license. This can be a 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 object.
String: The version of the work, based on the Possible values are:.