Old OpenAlex API documentation
  • Overview
  • Quickstart tutorial
  • API Entities
    • Entities overview
    • 📄Works
      • Work object
        • Authorship object
        • Location object
      • Get a single work
      • Get lists of works
      • Filter works
      • Search works
      • Group works
      • Get N-grams
    • 👩Authors
      • Author object
      • Get a single author
      • Get lists of authors
      • Filter authors
      • Search authors
      • Group authors
      • Limitations
      • Author disambiguation
    • 📚Sources
      • Source object
      • Get a single source
      • Get lists of sources
      • Filter sources
      • Search sources
      • Group sources
    • 🏫Institutions
      • Institution object
      • Get a single institution
      • Get lists of institutions
      • Filter institutions
      • Search institutions
      • Group institutions
    • 💡Topics
      • Topic object
      • Get a single topic
      • Get lists of topics
      • Filter topics
      • Search topics
      • Group topics
    • 🗝️Keywords
    • 🏢Publishers
      • Publisher object
      • Get a single publisher
      • Get lists of publishers
      • Filter publishers
      • Search publishers
      • Group publishers
    • 💰Funders
      • Funder object
      • Get a single funder
      • Get lists of funders
      • Filter funders
      • Search funders
      • Group funders
    • 🌎Geo
      • Continents
      • Regions
    • 💡Concepts
      • Concept object
      • Get a single concept
      • Get lists of concepts
      • Filter concepts
      • Search concepts
      • Group concepts
    • Aboutness endpoint (/text)
  • How to use the API
    • API Overview
    • Get single entities
      • Random result
      • Select fields
    • Get lists of entities
      • Paging
      • Filter entity lists
      • Search entities
      • Sort entity lists
      • Select fields
      • Sample entity lists
      • Autocomplete entities
    • Get groups of entities
    • Rate limits and authentication
  • Download all data
    • OpenAlex snapshot
    • Snapshot data format
    • Download to your machine
    • Upload to your database
      • Load to a data warehouse
      • Load to a relational database
        • Postgres schema diagram
  • Additional Help
    • Tutorials
    • Report bugs
    • FAQ
Powered by GitBook
On this page
  • /institutions attribute filters
  • /institutions convenience filters
  1. API Entities
  2. Institutions

Filter institutions

PreviousGet lists of institutionsNextSearch institutions

Last updated 10 months ago

You can filter institutions with the filter parameter:

  • Get institutions that are located in Canada

It's best to before trying these out. It will show you how to combine filters and build an AND, OR, or negation query

/institutions attribute filters

You can filter using these attributes of the Institution entity object (click each one to view their documentation on the object page):

  • : OpenAlex ID for an

  • : the OpenAlex ID of the Institution

  • : OpenAlex ID for an

  • : OpenAlex ID for an

  • : the OpenAlex ID of a repository (a )

  • : the ROR ID of the Institution

  • (accepts float, null, !null, can use range queries such as < >)

  • (accepts integer, null, !null, can use range queries)

  • (accepts integer, null, !null, can use range queries)

  • (alias: concepts.id or concept.id) -- will be deprecated soon

/institutions convenience filters

continent

Returns: institutions that are located in the chosen continent.

default.search

Value: a search string

display_name.search

Value: a search string

has_ror

Value: a Boolean (true or false)

is_global_south

Value: a Boolean (true or false)

These filters aren't attributes of the object, but they're included to address some common use cases:

Value: a String with a valid

Get institutions that are located in South America

This works the same as using the for Institutions.

Returns: institutions with a containing the given string; see the for details.

Get institutions with names containing "technology":

In most cases, you should use the instead of this filter because it uses a better search algorithm.

Returns: institutions that have or lack a , depending on the given value.

Get institutions without ROR IDs:

Returns: institutions that are located in the .

Get institutions that are located in the Global South

🏫
Institution
https://api.openalex.org/institutions?filter=continent:south_america
https://api.openalex.org/institutions?filter=display_name.search:technology
search parameter
https://api.openalex.org/institutions?filter=has_ror:false
https://api.openalex.org/institutions?filter=is_global_south:true
https://api.openalex.org/institutions?filter=country_code:ca
read about filters
Institution
Institution
Institution
Institution
Source
Global South
continent filter
search parameter
search page
cited_by_count
country_code
is_super_system
lineage
openalex
repositories.host_organization
repositories.host_organization_lineage
repositories.id
ror
summary_stats.2yr_mean_citedness
summary_stats.h_index
summary_stats.i10_index
type
works_count
x_concepts.id
display_name
ROR ID