OpenAlex technical documentation
  • Overview
  • Quickstart tutorial
  • API Entities
    • Entities overview
    • 📄Works
      • Work object
        • Authorship object
        • Location object
      • Get a single work
      • Get lists of works
      • Filter works
      • Search works
      • Group works
      • Get N-grams
    • 👩Authors
      • Author object
      • Get a single author
      • Get lists of authors
      • Filter authors
      • Search authors
      • Group authors
      • Limitations
      • Author disambiguation
    • 📚Sources
      • Source object
      • Get a single source
      • Get lists of sources
      • Filter sources
      • Search sources
      • Group sources
    • 🏫Institutions
      • Institution object
      • Get a single institution
      • Get lists of institutions
      • Filter institutions
      • Search institutions
      • Group institutions
    • 💡Topics
      • Topic object
      • Get a single topic
      • Get lists of topics
      • Filter topics
      • Search topics
      • Group topics
    • 🗝️Keywords
    • 🏢Publishers
      • Publisher object
      • Get a single publisher
      • Get lists of publishers
      • Filter publishers
      • Search publishers
      • Group publishers
    • 💰Funders
      • Funder object
      • Get a single funder
      • Get lists of funders
      • Filter funders
      • Search funders
      • Group funders
    • 🌎Geo
      • Continents
      • Regions
    • Concepts
      • Concept object
      • Get a single concept
      • Get lists of concepts
      • Filter concepts
      • Search concepts
      • Group concepts
    • Aboutness endpoint (/text)
  • How to use the API
    • API Overview
    • Get single entities
      • Random result
      • Select fields
    • Get lists of entities
      • Paging
      • Filter entity lists
      • Search entities
      • Sort entity lists
      • Select fields
      • Sample entity lists
      • Autocomplete entities
    • Get groups of entities
    • Rate limits and authentication
  • Download all data
    • OpenAlex snapshot
    • Snapshot data format
    • Download to your machine
    • Upload to your database
      • Load to a data warehouse
      • Load to a relational database
        • Postgres schema diagram
  • Additional Help
    • Tutorials
    • Report bugs
    • FAQ
Powered by GitBook
On this page
  • /sources attribute filters
  • /sources convenience filters
Export as PDF
  1. API Entities
  2. Sources

Filter sources

PreviousGet lists of sourcesNextSearch sources

Last updated 10 months ago

You can filter sources with the filter parameter:

  • Get sources that have an ISSN

It's best to 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 object page):

  • (alias: host_organization.id)

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

  • (alias: openalex)

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

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

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

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

  • (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.

/sources convenience filters

continent

Returns: sources that are associated with the chosen continent.

default.search

Value: a search string

display_name.search

Value: a search string

has_issn

Value: a Boolean (true or false)

is_global_south

Value: a Boolean (true or false)

To learn more about why we do it this way,

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

Value: a String with a valid

Get sources that are associated with Asia

This works the same as using the for Sources.

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

Get sources with names containing "Neurology": ``

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

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

Get sources without ISSNs: ``

Returns: sources that are associated with the .

Get sources that are located in the Global South

📚
Source
https://api.openalex.org/sources?filter=continent:asia
https://api.openalex.org/sources?filter=display_name.search:Neurology
https://api.openalex.org/sources?filter=has_issn:false
https://api.openalex.org/sources?filter=is\_global\_south:true
https://api.openalex.org/sources?filter=has_issn:true
read about filters
Source
search page
continent filter
Global South
search parameter
search
apc_prices.currency
apc_prices.price
apc_usd
cited_by_count
country_code
host_organization
host_organization_lineage
ids.openalex
is_core
is_in_doaj
is_oa
issn
publisher
host_organization_lineage
summary_stats.2yr_mean_citedness
summary_stats.h_index
summary_stats.i10_index
type
works_count
x_concepts.id
display_name
ISSN
see here.