filter-publishers.md

Filter publishers

You can filter publishers with the filter parameter:

• Get publishers that are hierarchy level 0
  https://api.openalex.org/publishers?filter=hierarchy\_level:0

{% 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 %}

/publishers attribute filters

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

• cited_by_count
• country_codes
• hierarchy_level
• ids.openalex (alias: openalex)
• ids.ror (alias: ror)
• ids.wikidata (alias: wikidata)
• lineage — Use this with a publisher ID to find that publisher and all of its children
• parent_publisher
• 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

/publishers convenience filters

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

continent

Value: a String with a valid continent filter

Returns: publishers that are located in the chosen continent.

• Get publishers that are located in South America
  https://api.openalex.org/publishers?filter=continent:south_america

default.search

Value: a search string

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

display_name.search

Value: a search string

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

• Get publishers with names containing "elsevier":
  https://api.openalex.org/publishers?filter=display_name.search:elsevier``

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