filter
parameter, formatted like this: filter=attribute:value,attribute2:value2
. Examples:https://api.openalex.org/authors?filter=display_name.search:einstein
<
) and greater-than (>
) symbols to filter by inequalities. Example:https://api.openalex.org/venues?filter=works_count:>1000
from_publication_date
filter on works
. See the endpoint-specific documentation below for more information. Example: https://api.openalex.org/works?filter=from_publication_date:2022-01-01,to_publication_date:2022-01-26
!
) to the filter value. Example:https://api.openalex.org/institutions?filter=country_code:!us
https://api.openalex.org/works?filter=cited_by_count:>1,is_oa:true
https://api.openalex.org/works?filter=institutions.country_code:fr,institutions.country_code:gb
https://api.openalex.org/works?filter=concepts.id:C71924100,concepts.id:C154945302
|
) to input lists of values such that any of the values can be satisfied--in other words, when you separate filter values with a pipe, they'll be combined as an OR
query. Example:https://api.openalex.org/works?filter=institutions.country_code:fr|gb
10.1371/journal.pone.0266781
or with DOI 10.1371/journal.pone.0267149
(note the pipe separator between the two DOIs):
https://api.openalex.org/works?filter=doi:https://doi.org/10.1371/journal.pone.0266781|https://doi.org/10.1371/journal.pone.0267149https://api.openalex.org/works?filter=institutions.country_code:fr|host_venue.issn:0957-1558
/works
filters/works
attribute filters Work
entity object (click each one to view their documentation on the Work
entity page):/works
convenience filtersWork
entity object, but they're handy for solving some common use cases:display_name.search
(alias: title.search
)display_name
(title) includes the given string; see the search filter for details. https://api.openalex.org/works?filter=title.search:wombat
search
parameter instead of this filter, because it uses a better search algorithm and searches over abstracts as well as titles.abstract.search
https://api.openalex.org/works?filter=abstract.search:artificial%20intelligence
raw_affiliation_string.search
raw_affiliation_string
which includes the given string. See the search filter for details on the search algorithm used. raw_affiliation_string
: https://api.openalex.org/works?filter=raw_affiliation_string.search:department%20of%20political%20science%20university%20of%amsterdam
has_doi
true
or false
)cites
https://api.openalex.org/works?filter=cites:W2741809807
cited_by
referenced_works
section. You can think of this as outgoing citations. related_to
https://api.openalex.org/works?filter=related_to:W2486144666
from_publication_date
yyyy-mm-dd
https://api.openalex.org/works?filter=from_publication_date:2001-03-14
to_publication_date
yyyy-mm-dd
https://api.openalex.org/works?filter=to_publication_date:2001-03-14
has_oa_accepted_or_published_version
true
or false
)host_venue
or alternate_host_venue
where is_oa
= true and version
is acceptedVersion or publishedVersion. For Works that undergo peer review, like journal articles, this means there is a peer-reviewed OA copy somewhere. For some items, like books, a published version doesn't imply peer review, so they aren't quite synonymous.https://api.openalex.org/works?filter=has_oa_accepted_or_published_version:true
true
or false
)host_venue
or alternate_host_venue
where is_oa
= true and version
is submittedVersion. This is useful for finding works with preprints deposited somewhere.https://api.openalex.org/works?filter=has_oa_submitted_version:true
/authors
filters/authors
attribute filtersAuthor
entity object (click each one to view their documentation on the Author
entity page):/authors
convenience filtersAuthor
entity object, but they're included to address some common use cases:display_name.search
search
parameter instead of this filter because it uses a better search algorithm.has_orcid
true
or false
)/venues
filters/venues
attribute filtersVenue
entity object (click each one to view their documentation on the Venue
entity page):/venues
convenience filtersVenue
entity object, but they're included to address some common use cases:display_name.search
https://api.openalex.org/venues?filter=display_name.search:Neurology
search
parameter instead of this filter because it uses a better search algorithm.has_issn
true
or false
)/institutions
filters/institutions
attribute filtersInstitution
entity object (click each one to view their documentation on the Institution
entity page):/institutions
convenience filtersInstitution
entity object, but they're included to address some common use cases:display_name.search
https://api.openalex.org/institutions?filter=display_name.search:technology
has_ror
true
or false
)/concepts
filters/concepts
attribute filtersConcept
entity object ((click each one to view their documentation on the Concept
entity page):/concepts
convenience filtersConcept
entity object, but they're included to address some common use cases:display_name.search
https://api.openalex.org/concepts?filter=display_name.search:electrodynamics
has_wikidata
true
or false
)