get-lists-of-institutions.md

Get lists of institutions

You can get lists of institutions:

• Get all institutions in OpenAlex
  https://api.openalex.org/institutions

Which returns a response like this:

{
    "meta": {
        "count": 108618,
        "db_response_time_ms": 32,
        "page": 1,
        "per_page": 25
    },
    "results": [
        {
            "id": "https://openalex.org/I27837315",
            "ror": "https://ror.org/00jmfr291",
            "display_name": "University of Michigan–Ann Arbor",
            // more fields (removed to save space)
        },
        {
            "id": "https://openalex.org/I201448701",
            "ror": "https://ror.org/00cvxb145",
            "display_name": "University of Washington",
            // more fields (removed to save space)
        },
        // more results (removed to save space)
    ],
    "group_by": []
}

Page and sort institutions

By default we return 25 results per page. You can change this default and page through institutions with the per-page and page parameters:

• Get the second page of institutions results, with 50 results returned per page
  https://api.openalex.org/institutions?per-page=50&page=2

You also can sort results with the sort parameter:

• Sort institutions by cited by count, descending
  https://api.openalex.org/institutions?sort=cited_by_count:desc

Continue on to learn how you can filter and search lists of institutions.

Sample institutions

You can use sample to get a random batch of institutions. Read more about sampling and how to add a seed value here.

• Get 50 random institutions
  https://api.openalex.org/institutions?sample=50&per-page=50

Select fields

You can use select to limit the fields that are returned in a list of institutions. More details are here.

• Display only the id, ror, and display_name within institutions results
  https://api.openalex.org/institutions?select=id,display_name,ror