Venue

OpenAlex documentation

Search…

Welcome!

API

📚

Venue

Venues are where works are hosted.
OpenAlex indexes about 124,000 venues. There are several types, including journals, conferences, preprint repositories, and institutional repositories. The Canonical External ID for venues is ISSN-L, which is a special "main" ISSN assigned to every venue (venues tend to have multiple ISSNs). About 90% of venues in OpenAlex have an ISSN-L or ISSN.
Our information about venues comes from Crossref, the ISSN Network, and MAG. These datasets are joined automatically where possible, but there’s also a lot of manual curation involved.
Several venues may host the same work. OpenAlex reports both the primary host venue (generally wherever the version of record lives), and alternate host venues (like preprint repositories).
Venues are linked to works via the works.host_venue and works.alternate_host_venues properties.
The Venue object
id
String: The OpenAlex ID for this venue.
1
id: "https://openalex.org/V1983995261"
Copied!
issn_l
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.
1
issn_l: "2167-8359"
Copied!
issn
List: The ISSNs used by this venue. Many publications have multiple ISSNs (see above), so ISSN-L should be used when possible.
1
issn:["2167-8359"]
Copied!
display_name
String: The name of the venue.
1
display_name: "PeerJ"
Copied!
publisher
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.
1
publisher: "Peerj"
Copied!
works_count
Integer: The number of Works this this venue hosts.
1
works_count: 20184 
Copied!
cited_by_count
Integer: The total number of Works that cite a Work hosted in this venue.
1
cited_by_count: 133702 
Copied!
is_oa
Boolean: todo 
1
is_oa: true 
Copied!
is_in_doaj
Boolean: todo 
1
is_in_doaj: true 
Copied!
homepage_url
String: todo 
1
homepage_url: "http://www.peerj.com/" 
Copied!
ids
Object: All the external identifiers that we know about for this venue. IDs are expressed as URIs whenever possible. Possible ID types:
openalex (String: this venue's OpenAlex ID. Same as Venue.id)
issn_l (String: this venue's ISSN-L. Same as Venue.issn_l)
mag  (Integer: this venue's Microsoft Academic Graph ID)
issn (List: a list of this venue's ISSNs. Same as Venue.issn)
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.
1
ids: {
2
    openalex: "https://openalex.org/V1983995261",
3
    issn_l: "2167-8359",
4
    issn: [
5
        "2167-8359"
6
    ],
7
    mag: 1983995261
8
}
Copied!
x_concepts
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.
1
x_concepts: [
2
    {
3
        id: "https://openalex.org/C86803240",
4
        wikidata: null,
5
        display_name: "Biology",
6
        level: 0,
7
        score: 86.7
8
    },
9
    {
10
        id: "https://openalex.org/C185592680",
11
        wikidata: null,
12
        display_name: "Chemistry",
13
        level: 0,
14
        score: 51.4
15
    },
16
    
17
    // and so forth
18
]
Copied!
counts_by_year
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.
1
counts_by_year: [
2
    {
3
        year: 2021,
4
        works_count: 4338,
5
        cited_by_count: 127268
6
    },
7
    {
8
        year: 2020,
9
        works_count: 4363,
10
        cited_by_count: 119531
11
    },
12
    
13
    // and so forth
14
]
Copied!
​
works_api_url
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.
1
works_api_url: "https://api.openalex.org/works?filter=host_venue.id:V1983995261",
Copied!
​
updated_date
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.
1
updated_date: "2022-01-02T00:00:00"
Copied!
created_date
String: The date this Venue object was created in the OpenAlex dataset, expressed as an ISO 8601 date string. 
1
created_date: "2017-08-08"
Copied!
The DehydratedVenue object
The DehydratedVenue is stripped-down Venue object, with most of its properties removed to save weight. Its only remaining properties are:
​id​
​issn_l​
​issn​
​display_name​
​publisher​