filter-sources.md

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

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

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

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

/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``

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

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