OpenAlex technical 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
Export as PDF
  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
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
ROR ID
continent filter
display_name
Global South
search parameter
search page