Skip to contents

In your oa_fetch calls, you can specify additional arguments to filter your search result. Available arguments/filters for each entity and associated example values are in the tables below.

Note: x_concepts.id are being deprecated and will be removed soon!

See the OpenAlex documentation for the latest list of valid filters.

Available arguments by entity

Works

Filter Example value
publication_year 2018
publication_date "2018-02-13"
primary_location.source.issn "2167-8359"
primary_location.license "cc-by"
primary_location.source.host_organization "https://openalex.org/P4310320104"
primary_location.source.type "journal"
type "journal-article"
is_paratext TRUE
open_access.oa_status "gold"
open_access.is_oa TRUE
authorships.author.id "A1969205032"
authorships.author.orcid "0000-0003-1613-5981"
authorships.institutions.id "I4200000001"
authorships.institutions.ror "02nr0ka47"
authorships.institutions.country_code "US"
authorships.institutions.type "nonprofit"
cited_by_count 382
is_retracted FALSE
concepts.id "C2778793908"
concepts.wikidata "https://www.wikidata.org/wiki/Q5122404"
doi "10.7717/peerj.4375"
ids.mag 2741809807
ids.pmid "https://pubmed.ncbi.nlm.nih.gov/23638343/"
ids.pmcid "https://www.ncbi.nlm.nih.gov/pmc/articles/PMC3628373/"**
alternate_host_venues.license "cc-by"
alternate_host_venues.version "submittedVersion"
alternate_host_venues.venue_id "V1983995261"
display_name.search "wombat"
abstract.search "artificial intelligence"
fulltext.search "climate change"
raw_affiliation_string.search "department of political science university of Amsterdam"
has_abstract TRUE
has_doi FALSE
has_ngrams TRUE
has_references TRUE
cites "W2741809807"
cited_by "W2766808518"
related_to "W2486144666"
from_publication_date "2022-08-01"
to_publication_date "2022-08-11"
has_oa_accepted_or_published_version TRUE
has_oa_submitted_version TRUE

Authors

Filter Example value
works_count ">99"
cited_by_count ">1000"
last_known_institutions.id "I4200000001"
last_known_institutions.ror "02nr0ka47"
last_known_institutions.country_code "CA"
last_known_institutions.type "nonprofit"
openalex "A2208157607"
orcid "0000-0001-6187-6610"
mag "2208157607"
twitter "jasonpriem"
wikipedia "https://en.wikipedia.org/wiki/Jennifer_Doudna"
scopus "http://www.scopus.com/inward/authorDetails.url?authorID=36455008000&partnerID=MN8TOARS"
x_concepts.id "C41008148"
display_name.search "tupolev"
search "Phillip Kuo"
has_orcid TRUE

Sources

Filter Example value
issn "2167-8359"
publisher "Peerj"
works_count 20184
cited_by_count 133702
x_concepts.id "C185592680"
is_oa TRUE
is_in_doaj TRUE
openalex "V1983995261"
issn_l "2167-8359"
issn "2167-8359"
mag 1983995261
display_name.search "Neurology"
has_issn FALSE

Institutions

Filter Example value
country_code "CN"
type "education"
works_count "<999"
cited_by_count ">20000"
x_concepts.id "C41008148"
display_name.search "technology"
has_ror FALSE
openalex "C41008148"
ror "0130frc33"
mag "114027177"
grid "grid.10698.36"
wikipedia "https://en.wikipedia.org/wiki/University%20of%20North%20Carolina%20at%20Chapel%20Hill"
wikidata "https://www.wikidata.org/wiki/Q192334"

Concepts

Filter Example value
level 3
works_count "<999"
cited_by_count ">10000"
ancestors.id "C161191863"
openalex "C2522767166"
wikidata_id "Q14565201"
mag "2778407487114027177"
wikipedia "https://en.wikipedia.org/wiki/Altmetrics"
umls_aui
umls_cui
display_name.search "electrodynamics"
has_wikidata FALSE

Examples

library(openalexR)
#> openalexR v2.0.0 introduces breaking changes.
#> See NEWS.md for details.
#> 
#> To suppress this message, add `openalexR.message = suppressed` to your .Renviron file.

# Unlike the other filters, search does NOT require an exact match. 
# This is particularly useful to search for authors. Some authors have their middle names in a variety of forms, which may not exist, or co-exist in OpenAlex (e.g. Phillip H. Kuo, Phillip Hsin Kuo).  
# The display_name search returns an exact match, and will NOT find all these variations. For example, author "Phillip H. Kuo" and "Phillip Hsin Kuo" is the same person.
# His middle name are recorded differently in openAlex. Therefore, all the varitions can only be found either using search ="Phillip Kuo" or display_name =c("Phillip H. Kuo" , "Phillip Hsin Kuo").

authors_from_names <- oa_fetch(
  entity = "authors", 
  search = "Phillip Kuo"
 )
#> Warning: Note: `oa_fetch` and `oa2df` now return new names for some columns in openalexR v2.0.0.
#>     See NEWS.md for the list of changes.
#>     Call `get_coverage()` to view the all updated columns and their original names in OpenAlex.
#> This warning is displayed once every 8 hours.
#> Error in get(paste0(generic, ".", class), envir = get_method_env()) : 
#>   object 'type_sum.accel' not found

lib_topics <- oa_fetch(
  entity = "topics", 
  works_count = "<999",
  cited_by_count = ">10000"
)
dplyr::glimpse(lib_topics)
#> Rows: 3
#> Columns: 16
#> $ id                    <chr> "https://openalex.org/T13311", "https://openalex…
#> $ display_name          <chr> "Social Ideology and Knowledge Production", "Edu…
#> $ description           <chr> "This cluster of papers explores the intersectio…
#> $ keywords              <list> <"Ideology", "Knowledge Production", "Leadershi…
#> $ ids                   <list> <"https://openalex.org/T13311", "https://en.wik…
#> $ subfield_id           <chr> "https://openalex.org/subfields/3312", "https://…
#> $ subfield_display_name <chr> "Sociology and Political Science", "Information …
#> $ field_id              <chr> "https://openalex.org/fields/33", "https://opena…
#> $ field_display_name    <chr> "Social Sciences", "Computer Science", "Social S…
#> $ domain_id             <chr> "https://openalex.org/domains/2", "https://opena…
#> $ domain_display_name   <chr> "Social Sciences", "Physical Sciences", "Social …
#> $ siblings              <list> [<data.frame[223 x 2]>], [<data.frame[77 x 2]>]…
#> $ works_count           <int> 968, 956, 913
#> $ cited_by_count        <int> 17621, 19207, 17286
#> $ updated_date          <chr> "2024-10-21T04:55:58.663873", "2024-12-16T05:24:…
#> $ created_date          <chr> "2024-01-23", "2024-01-23", "2024-01-23"

tech_insts <- oa_fetch(
  entity = "institutions", 
  country_code = "IL",
  display_name.search = "technology"
)
dplyr::glimpse(tech_insts)
#> Rows: 7
#> Columns: 23
#> $ id                         <chr> "https://openalex.org/I174306211", "https:/…
#> $ display_name               <chr> "Technion – Israel Institute of Technology"…
#> $ display_name_alternatives  <list> <"Technion", "جامعة تخنيون", "הטכניון – מכ…
#> $ display_name_acronyms      <list> NA, <"HIT", "CTEH", "HAIT">, NA, "JCT", NA
#> $ international_display_name <list> <"التخنيون - معهد إسرائيل للتكنولوجيا", "م…
#> $ ror                        <chr> "https://ror.org/03qryx823", "https://ror.o…
#> $ ids                        <list> <"https://openalex.org/I174306211", "https…
#> $ country_code               <chr> "IL", "IL", "IL", "IL", "IL", "IL", "IL"
#> $ geo                        <list> [<data.frame[1 x 7]>], [<data.frame[1 x 7]>…
#> $ type                       <chr> "education", "education", "facility", "edu…
#> $ homepage_url               <chr> "http://www.technion.ac.il/", "http://www.h…
#> $ image_url                  <chr> "https://commons.wikimedia.org/w/index.php?…
#> $ image_thumbnail_url        <chr> "https://commons.wikimedia.org/w/index.php?…
#> $ associated_institutions    <list> [<data.frame[2 x 6]>], NA, NA, NA, [<data.f…
#> $ relevance_score            <dbl> 18081.8480, 2488.1640, 2328.4624, 2007.310…
#> $ works_count                <int> 104521, 3701, 1467, 2640, 2286, 1250, 6
#> $ cited_by_count             <int> 3240823, 50166, 43906, 32580, 11464, 15728,…
#> $ counts_by_year             <list> [<data.frame[13 x 3]>], [<data.frame[13 x 3…
#> $ summary_stats              <list> <4.112614, 525.000000, 48175.000000>, <2.44…
#> $ works_api_url              <chr> "https://api.openalex.org/works?filter=ins…
#> $ topics                     <list> [<tbl_df[100 x 5]>], [<tbl_df[100 x 5]>], …
#> $ updated_date               <chr> "2024-12-17T16:44:18.238848", "2024-12-17T1…
#> $ created_date               <chr> "2016-06-24", "2016-06-24", "2022-02-02", …

peer_venues <- oa_fetch(
  entity = "sources", 
  display_name = "PeerJ",
  is_oa = TRUE,
  is_in_doaj = TRUE
)
dplyr::glimpse(peer_venues)
#> Rows: 1
#> Columns: 26
#> $ id                        <chr> "https://openalex.org/S1983995261"
#> $ issn_l                    <chr> "2167-8359"
#> $ issn                      <list> "2167-8359"
#> $ display_name              <chr> "PeerJ"
#> $ host_organization         <chr> "https://openalex.org/P4310320104"
#> $ host_organization_name    <chr> "PeerJ, Inc."
#> $ host_organization_lineage <list> "https://openalex.org/P4310320104"
#> $ works_count               <int> 15123
#> $ cited_by_count            <int> 317102
#> $ summary_stats             <list> <2.102189, 142.000000, 8437.000000>
#> $ is_oa                     <lgl> TRUE
#> $ is_in_doaj                <lgl> TRUE
#> $ ids                       <list> <"https://openalex.org/S1983995261", "2167-8…
#> $ homepage_url              <chr> "http://www.peerj.com/"
#> $ apc_prices                <list> [<data.frame[1 x 2]>]
#> $ apc_usd                   <int> 1395
#> $ country_code              <chr> "US"
#> $ societies                 <lgl> NA
#> $ alternate_titles          <list> <"Peer j", "Peerj">
#> $ abbreviated_title         <chr> "PeerJ"
#> $ type                      <chr> "journal"
#> $ counts_by_year            <list> [<data.frame[13 x 3]>]
#> $ works_api_url             <chr> "https://api.openalex.org/works?filter=prima…
#> $ updated_date              <chr> "2024-12-17T18:24:06.815811"
#> $ created_date              <chr> "2016-06-24"
#> $ topics                    <list> [<tbl_df[100 x 5]>]