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
  • /concepts attribute filters
  • /concepts convenience filters
Export as PDF
  1. API Entities
  2. Concepts

Filter concepts

PreviousGet lists of conceptsNextSearch concepts

Last updated 10 months ago

These are the original OpenAlex Concepts, which are being deprecated in favor of . We will continue to provide these Concepts for Works, but we will not be actively maintaining, updating, or providing support for these concepts. Unless you have a good reason to be relying on them, we encourage you to look into instead.

You can filter concepts with the filter parameter:

  • Get concepts that are at level 0 (top level)

It's best to before trying these out. It will show you how to combine filters and build an AND, OR, or negation query

/concepts attribute filters

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

  • (alias: openalex)

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

/concepts convenience filters

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

default.search

Value: a search string

display_name.search

Value: a search string

has_wikidata

Value: a Boolean (true or false)

This works the same as using the for Concepts.

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

Get concepts with display_name containing "electrodynamics":

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

Returns: concepts that have or lack a , depending on the given value. For now, all concepts in OpenAlex do have Wikidata IDs.

Get concepts without Wikidata IDs:

https://api.openalex.org/concepts?filter=display_name.search:electrodynamics
https://api.openalex.org/concepts?filter=has_wikidata:false
Topics
Topics
https://api.openalex.org/concepts?filter=level:0
read about filters
Concept
Concept
ancestors.id
cited_by_count
ids.openalex
level
summary_stats.2yr_mean_citedness
summary_stats.h_index
summary_stats.i10_index
works_count
Wikidata ID
display_name
search parameter
search page
search parameter