filter-funders.md

Filter funders

You can filter funders with the filter parameter:

• Get funders that are located in Canada
  https://api.openalex.org/funders?filter=country_code:ca

{% hint style="info" %} 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 {% endhint %}

/funders attribute filters

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

• cited_by_count
• country_code
• grants_count
• ids.openalex (alias: openalex)
• ids.ror (alias: ror)
• ids.wikidata (alias: wikidata)
• 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

/funders convenience filters

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

continent

Value: a String with a valid continent filter

Returns: funders that are located in the chosen continent.

• Get funders that are located in South America
  https://api.openalex.org/funders?filter=continent:south\_america

default.search

Value: a search string

This works the same as using the search parameter for Funders.

description.search

Value: a search string

Returns: funders with a description containing the given string; see the search page for details.

• Get funders with description containing "health":
  https://api.openalex.org/funders?filter=description.search:health

display_name.search

Value: a search string

Returns: funders with a display_name containing the given string; see the search page for details.

• Get funders with names containing "health":
  https://api.openalex.org/funders?filter=display_name.search:health

{% hint style="info" %} In most cases, you should use the search parameter instead of this filter because it uses a better search algorithm. {% endhint %}

is_global_south

Value: a Boolean (true or false)

Returns: funders that are located in the Global South.

• Get funders that are located in the Global South
  https://api.openalex.org/funders?filter=is_global_south:true