Venue object

These are the fields in a venue object. When you use the API to get a single venue or lists of venues, this is what's returned.


String: An abbreviated title obtained from the ISSN Centre.
abbreviated_title: "J. addict. med. ther. sci."


Array: Alternate titles for this Venue, as obtained from the ISSN Centre and individual work records, like Crossref DOIs, that carry the Venue name as a string. These are commonly abbreviations or translations of the Venue's canonical name.
alternate_titles: [


Integer: The Venue's article processing charge in US Dollars, if available from DOAJ.
apc_usd: 5200


Integer: The total number of Works that cite a Work hosted in this venue.
cited_by_count: 133702


String: The country that this venue is associated with, represented as an ISO two-letter country code.
country_code: "GB"


List: works_count and cited_by_count for each of the last ten years, binned by year. To put it another way: each year, you can see how many new works this venue started hosting, and how many times any work in this venue got cited.
If the venue was founded less than ten years ago, there will naturally be fewer than ten years in this list. Years with zero citations and zero works have been removed so you will need to add those in if you need them.
counts_by_year: [
year: 2021,
works_count: 4338,
cited_by_count: 127268
year: 2020,
works_count: 4363,
cited_by_count: 119531
// and so forth


String: The date this Venue object was created in the OpenAlex dataset, expressed as an ISO 8601 date string.
created_date: "2017-08-08"


String: The name of the venue.
display_name: "PeerJ"


String: The starting page for navigating the contents of this venue; the homepage for this venue's website.
homepage_url: ""


String: The OpenAlex ID for this venue.
id: ""


Object: All the external identifiers that we know about for this venue. IDs are expressed as URIs whenever possible. Possible ID types:
Many venues are missing one or more ID types (either because we don't know the ID, or because it was never assigned). Keys for null IDs are not displayed.
ids: {
openalex: "",
issn_l: "2167-8359",
issn: [
mag: 1983995261,
fatcat: "",
wikidata: ""


Boolean: Whether this is a journal listed in the Directory of Open Access Journals (DOAJ).
is_in_doaj: true


Boolean: Whether this is currently fully-open-access venue. This could be true for a preprint repository where everything uploaded is free to read, or for a Gold or Diamond open access journal, where all newly published Works are available for free under an open license.
We say "currently" because the status of a Venue can change over time. It's common for journals to "flip" to Gold OA, after which they may make only future articles open or also open their back catalogs. It's entirely possible for a Venue to say is_oa: true, but for an article from last year to require a subscription.
is_oa: true


List: The ISSNs used by this venue. Many publications have multiple ISSNs (see above), so ISSN-L should be used when possible.


String: The ISSN-L identifying this venue. This is the Canonical External ID for venues.
ISSN is a global and unique ID for serial publications. However, different media versions of a given publication (e.g., print and electronic) often have different ISSNs. This is why we can't have nice things. The ISSN-L or Linking ISSN solves the problem by designating a single canonical ISSN for all media versions of the title. It's usually the same as the print ISSN.
issn_l: "2167-8359"


String: The name of this venue's publisher. Publisher is a tricky category, as journals often change publishers, publishers merge, publishers have subsidiaries ("imprints"), and of course no one is consistent in their naming. In the future, we plan to roll out support for a more structured publisher field, but for now it's just a string.
publisher: "Peerj"


Array: Societies on whose behalf the Venue is published and maintained, obtained from our crowdsourced list. Thanks!
societies: [
"url": "",
"organization": "American Counseling Association on behalf of the American College Counseling Association"


String: The type of venue, which will be one of the following from the Type column:
Wikidata ID
How it's assigned
The Venue is an academic journal with an ISSN.
The Venue is a disciplinary or institutional repository.
The Venue publishes Works with type "Proceedings", "Proceedings Series" or "Proceedings Article".
ebook platform
The Venue publishes Works with type containing "book", e.g. "Book Chapter".
type: "journal"


String: The last time anything in this Venue object changed, expressed as an ISO 8601 date string. This date is updated for any change at all, including increases in various counts.
updated_date: "2022-01-02T00:00:00"


String: A URL that will get you a list of all this venue's Works.
We express this as an API URL (instead of just listing the works themselves) because sometimes a venue's publication list is too long to reasonably fit into a single Venue object.
works_api_url: "",


Integer: The number of Works this this venue hosts.
works_count: 20184


The "x" in x_concepts is because it's experimental and subject to removal with very little warning. We plan to replace it with a custom link to the Concepts API endpoint.
List: The Concepts most frequently applied to works hosted by this venue. Each is represented as a dehydrated Concept object, with one additional attribute:
score (Float): The strength of association between this venue and the listed concept, from 0-100.
x_concepts: [
id: "",
wikidata: null,
display_name: "Biology",
level: 0,
score: 86.7
id: "",
wikidata: null,
display_name: "Chemistry",
level: 0,
score: 51.4
// and so forth

The DehydratedVenue object

The DehydratedVenue is stripped-down Venue object, with most of its properties removed to save weight. Its only remaining properties are: