Search awards

The best way to search for awards is to use the search query parameter, which searches across the display_name and description fields.

• Get awards that mention "machine learning": https://api.openalex.org/awards?search=machine%20learning

You can read more about search here. It will show you how relevance score is calculated and how words are stemmed to improve search results.

Search a specific field

You can also use search as a filter, allowing you to fine-tune the fields you're searching over. To do this, append .search to the end of the property you're filtering for:

• Get awards where the display name includes "climate": https://api.openalex.org/awards?filter=display_name.search:climate

The following fields can be searched as a filter within awards:

Search filter	Field that is searched
display_name.search	display_name
description.search	description

You can also use the filter default.search, which works the same as using the search parameter.