Filter authors

You can filter authors with the filter parameter:

• Get authors that have an ORCID https://api.openalex.org/authors?filter=has_orcid:true

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):

• affiliations.institution.country_code

• affiliations.institution.id

• affiliations.institution.lineage

• affiliations.institution.ror

• affiliations.institution.type

• cited_by_count

• ids.openalex (alias: openalex)

• last_known_institution.country_code

• last_known_institution.id

• last_known_institution.lineage

• last_known_institution.ror

• last_known_institution.type

• orcid

• scopus (the author's scopus ID, as an integer)

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

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

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

• works_count

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

Want to filter by last_known_institution.display_name? This is a two-step process:

1. Find the institution.id by searching institutions by display_name.

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.

• Get authors named "tupolev": https://api.openalex.org/authors?filter=display_name.search:tupolev

has_orcid

Value: a Boolean (true or false)

Returns: authors that have or lack an orcid, depending on the given value.

• Get the authors that have an ORCID: ``https://api.openalex.org/authors?filter=has_orcid:true

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.

• Get authors where the last known institution is located in Africa https://api.openalex.org/authors?filter=last_known_institution.continent:africa

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.

• Get authors where the last known institution is located in the Global South https://api.openalex.org/authors?filter=last_known_institution.is_global_south:true