Institution

OpenAlex documentation
Search…
Welcome!
API
🏫
Institution
Institutions are organizations to which authors claim affiliations.
OpenAlex indexes about 109,000 institutions. The Canonical External ID for institutions is the ROR ID. About 94% of institutions in OpenAlex have ROR IDs.
Our information about institutions comes from metadata found in Crossref, PubMed, ROR, MAG, and publisher websites. In order to link institutions to works, we parse every affiliation listed by every author. These affiliation strings can be quite messy, so we’ve trained an algorithm to interpret them and extract the actual institutions with reasonably high reliability.
For a simple example: we will treat both “MIT, Boston, USA” and “Massachusetts Institute of Technology” as the same institution (https://ror.org/042nb2s44).
Institutions are linked to works via the works.authorships property.
The Institution object
id
String: The OpenAlex ID for this institution.
1
id: "https://openalex.org/I114027177"
Copied!
ror
String: The ROR ID for this institution. This is the Canonical External ID for institutions.
The ROR (Research Organization Registry) identifier is a globally unique ID for research organization. ROR is the successor to GRiD, which is no longer being updated. 
1
ror: "https://ror.org/0130frc33"
Copied!
display_name
String: The primary name of the institution.
1
display_name: "University of North Carolina at Chapel Hill"
Copied!
country_code
String: The country where this institution is located, represented as an ISO two-letter country code.
1
country_code: "US"
Copied!
type
String: The institution's primary type, using the ROR "type" controlled vocabulary. 
Possible values are: Education, Healthcare, Company, Archive, Nonprofit, Government, Facility, and Other.
1
type: "education"
Copied!
homepage_url
String: The URL for institution's primary homepage.
1
homepage_url: "http://www.unc.edu/"
Copied!
image_url
String: URL where you can get an image representing this institution. Usually this is hosted on Wikipedia, and usually it's a seal or logo.
1
image_url: "https://upload.wikimedia.org/wikipedia/en/5/5c/University_of_North_Carolina_at_Chapel_Hill_seal.svg"
Copied!
image_thumbnail_url
String: Same as image_url, but it's a smaller image.
1
image_thumbnail_url: "https://upload.wikimedia.org/wikipedia/en/thumb/5/5c/University_of_North_Carolina_at_Chapel_Hill_seal.svg/100px-University_of_North_Carolina_at_Chapel_Hill_seal.svg.png"
Copied!
display_name_acronyms
List: Acronyms or initialisms that people sometimes use instead of the full display_name.
1
display_name_acronyms:["UNC"]
Copied!
display_name_alternatives
List: Other names people may use for this institution.  
1
display_name_alternatives: [
2
    "UNC-Chapel Hill"
3
]
Copied!
works_count
Integer: The number of Works created by authors affiliated with this institution. Or less formally: the number of works coming out of this institution.
1
works_count: 202704 
Copied!
cited_by_count
Integer: The total number Works that cite a work created by an author affiliated with this institution. Or less formally: the number of citations this institution has collected.
1
cited_by_count: 21199844 
Copied!
ids
Object: All the external identifiers that we know about for this institution. IDs are expressed as URIs whenever possible. Possible ID types:
openalex (String: this institution's OpenAlex ID. Same as Institution.id)
ror (String: this institution's ROR ID. Same as Institution.ror)
mag  (Integer: this institution's Microsoft Academic Graph ID)
grid (String: this institution's GRID ID)
wikipedia (String: this institution's Wikipedia page URL)
wikidata (String: this institution's Wikidata ID)
Many institution 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/I114027177",
3
    ror: "https://ror.org/0130frc33",
4
    grid: "grid.10698.36",
5
    wikipedia: "https://en.wikipedia.org/wiki/University%20of%20North%20Carolina%20at%20Chapel%20Hill",
6
    wikidata: "https://www.wikidata.org/wiki/Q192334",
7
    mag: 114027177
8
}     
Copied!
geo
Object: A bunch of stuff we know about the location of this institution:
city (String): The city where this institution lives.
geonames_city_id (String): The city where this institution lives, as a GeoNames database ID.
region (String): The sub-national region (state, province) where this institution lives.
country_code (String): The country where this institution lives, represented as an ISO two-letter country code.
country (String): The country where this institution lives.
latitude (Float): Does what it says.
longitude (Float): Does what it says.
1
geo: {
2
    city: "Chapel Hill",
3
    geonames_city_id: "4460162",
4
    region: "North Carolina",
5
    country_code: "US",
6
    country: "United States",
7
    latitude: 35.9083,
8
    longitude: -79.0492
9
}
Copied!
international
Object: todo
1
international: {
2
    display_name: {
3
        "ar": "جامعة نورث كارولينا في تشابل هيل",
4
        "en": "University of North Carolina at Chapel Hill",
5
        "es": "Universidad de Carolina del Norte en Chapel Hill",
6
        "zh-cn": "北卡罗来纳大学教堂山分校",
7
        ...
8
    }
9
}
Copied!
associated_institutions
List:  Institutions related to this one. Each associated institution is represented as a dehydrated Institution object, with one extpa property:
relationship (String): The type of relationship between this institution and the listed institution. Possible values: parent, child, and related.
1
associated_institutions: [
2
    {
3
        id: "https://openalex.org/I2802101240",
4
        ror: "https://ror.org/0483mr804",
5
        display_name: "Carolinas Medical Center",
6
        country_code: "US",
7
        type: "healthcare",
8
        relationship: "related"
9
    },
10
    {
11
        id: "https://openalex.org/I69048370",
12
        ror: "https://ror.org/01s91ey96",
13
        display_name: "Renaissance Computing Institute",
14
        country_code: "US",
15
        type: "education",
16
        relationship: "related"
17
    },
18
    
19
    // and so forth
20
]
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.
1
counts_by_year: [
2
    {
3
        year: 2022,
4
        works_count: 133,
5
        cited_by_count: 32731
6
    },
7
    {
8
        year: 2021,
9
        works_count: 12565,
10
        cited_by_count: 2180827
11
    },
12
    
13
    // and so forth
14
]
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 affiliated with this institution. Each is represented as a dehydrated Concept object, with one additional attribute:
score (Float): The strength of association between this institution 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!
​
works_api_url
String: A URL that will get you a list of all the Works affiliated with this institution.
We express this as an API URL (instead of just listing the Works themselves) because most institutions have way too many works to reasonably fit into a single return object.
1
works_api_url: "https://api.openalex.org/works?filter=institutions.id:I114027177"
Copied!
updated_date
String: The last time anything in this Institution 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:27:23.088909"
Copied!
created_date
String: The date this Institution object was created in the OpenAlex dataset, expressed as an ISO 8601 date string. 
1
created_date: "2017-08-08"
Copied!
The DehydratedInstitution object
The DehydratedInstitution is stripped-down Institution object, with most of its properties removed to save weight. Its only remaining properties are:
​id​
​display_name​
​ror​
​country_code​
​type​
​
Venue
Concept
Last modified 1mo ago
The `Institution` object

`id`

`ror`

`display_name`

`country_code`

`type`

`homepage_url`

`image_url`

`image_thumbnail_url`

`display_name_acronyms`

`display_name_alternatives`

`works_count`

`cited_by_count`

`ids`

`geo`

`international`

`associated_institutions`

`counts_by_year`

`x_concepts`

`works_api_url`

`updated_date`

`created_date`

The `DehydratedInstitution` object
