OpenAlex API documentation
Search
⌃K
Comment on page

Filter authors

You can filter authors with the filter parameter:
It's best to read about filters before trying these out. It will show you how to combine filters and build an AND, OR, or negation query.

/authors attribute filters

You can filter using these attributes of the Author entity object (click each one to view their documentation on the Author object page):
Want to filter by last_known_institution.display_name? This is a two-step process:
  1. 1.
    Find the institution.id by searching institutions by display_name.
  2. 2.
    Filter works by last_known_institution.id.
To learn more about why we do it this way, see here.​

/authors convenience filters

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

default.search

Value: a search string
This works the same as using the search parameter for Authors.

display_name.search

Value: a search string
Returns: Authors whose display_name contains the given string; see the search filter for details.

has_orcid

Value: a Boolean (true or false)
Returns: authors that have or lack an orcid, depending on the given value.

last_known_institution.continent

Value: a String with a valid continent filter​
Returns: authors where where the last known institution is in the chosen continent.

last_known_institution.is_global_south

Value: a Boolean (true or false)
Returns: works where at least one of the author's institutions is in the Global South.
Previous
Get lists of authors
Next
Search authors
Last modified 2mo ago