Filter sources

You can filter sources with the filter parameter:

• Get sources that have an ISSN https://api.openalex.org/sources?filter=has_issn: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

/sources attribute filters

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

• apc_prices.currency

• apc_prices.price

• apc_usd

• cited_by_count

• country_code

• host_organization (alias: host_organization.id)

• host_organization_lineage — Use this with a publisher ID to find works from that publisher and all of its children.

• ids.openalex (alias: openalex)

• is_in_doaj

• is_oa

• issn

• publisher — Requires exact match. Use the host_organization_lineage filter instead if you want to find works from a publisher and all of its children.

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

• type

• works_count

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

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

1. Find the host organization's ID by searching by display_name in Publishers or Institutions, depending on which type you are looking for.

2. Filter works by host_organization.id.

To learn more about why we do it this way, see here.

/sources convenience filters

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

continent

Value: a String with a valid continent filter

Returns: sources that are associated with the chosen continent.

• Get sources that are associated with Asia https://api.openalex.org/sources?filter=continent:asia

default.search

Value: a search string

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

display_name.search

Value: a search string

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

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

In most cases, you should use the search parameter instead of this filter because it uses a better search algorithm.

has_issn

Value: a Boolean (true or false)

Returns: sources that have or lack an ISSN, depending on the given value.

• Get sources without ISSNs: https://api.openalex.org/sources?filter=has_issn:false``

is_global_south

Value: a Boolean (true or false)

Returns: sources that are associated with the Global South.

• Get sources that are located in the Global South https://api.openalex.org/sources?filter=is\_global\_south:true