ft_search: Search for full text

In fulltext: Full Text of 'Scholarly' Articles Across Many Data Sources

Description

ft_search is a one stop shop for searching for articles across many publishers and repositories. We currently support search for PLOS via the rplos package, Crossref via the rcrossref package, Entrez via the rentrez package, arXiv via the aRxiv package, and BMC, Biorxiv, EueroPMC, and Scopus via internal helper functions in this package.

Many publishers content is searchable via Crossref and Entrez - of course this doesn't mean that we can get full text for those articles. In the output objects of this function, we attempt to help by indicating what license is used for articles.

Usage

ft_search(query, from = "plos", limit = 10, start = 0,
  plosopts = list(), bmcopts = list(), crossrefopts = list(),
  entrezopts = list(), arxivopts = list(), biorxivopts = list(),
  euroopts = list(), scopusopts = list(), maopts = list(), ...)

ft_search_ls()

Arguments

query	(character) Query terms
from	(character) Source to query, one of more of plos, bmc, crossref, entrez, arxiv, biorxiv, europmc, scopus, or ma
limit	(integer) Number of records to return. default: 10
start	(integer) Record number to start at. Only used for 'scopus' right now. default: 0
plosopts	(list) PLOS options. See rplos::searchplos()
bmcopts	(list) BMC options. See bmc_search()
crossrefopts	(list) Crossref options. See rcrossref::cr_works()
entrezopts	(list) Entrez options. See rentrez::entrez_search()
arxivopts	(list) arxiv options. See aRxiv::arxiv_search()
biorxivopts	(list) biorxiv options. See biorxiv_search()
euroopts	(list) Euro PMC options. See eupmc_search()
scopusopts	(list) Scopus options. See scopus_search()
maopts	(list) Microsoft Academic options. See microsoft_search()
...	ignored right now

Details

Each of plosopts, scopusopts, etc. expect a named list.

See Rate Limits and Authentication in fulltext-package for rate limiting and authentication information, respectively

Value

An object of class ft, and objects of class ft_ind within each source. You can access each data source with $

Examples

# List publishers included
ft_search_ls()

## Not run: 
# Plos
(res1 <- ft_search(query='ecology', from='plos'))
res1$plos
ft_search(query='climate change', from='plos', limit=500, 
  plosopts=list(
   fl=c('id','author','eissn','journal','counter_total_all',
   'alm_twitterCount')))

# Crossref
(res2 <- ft_search(query='ecology', from='crossref'))
res2$crossref

# BioRxiv
(res <- ft_search(query='owls', from='biorxiv'))
res$biorxiv

# Entrez
(res <- ft_search(query='ecology', from='entrez'))
res$entrez

# arXiv
(res <- ft_search(query='ecology', from='arxiv'))
res$arxiv

# BMC - can be very slow
(res <- ft_search(query='ecology', from='bmc'))
res$bmc

# Europe PMC
(res <- ft_search(query='ecology', from='europmc'))
res$europmc

# Scopus
(res <- ft_search(query = 'ecology', from = 'scopus', limit = 100,
   scopusopts = list(key = Sys.getenv('ELSEVIER_SCOPUS_KEY'))))
res$scopus
## pagination
(res <- ft_search(query = 'ecology', from = 'scopus', 
   scopusopts = list(key = Sys.getenv('ELSEVIER_SCOPUS_KEY')), limit = 5))
(res <- ft_search(query = 'ecology', from = 'scopus', 
   scopusopts = list(key = Sys.getenv('ELSEVIER_SCOPUS_KEY')), 
   limit = 5, start = 5))
## lots of results
(res <- ft_search(query = "ecology community elk cow", from = 'scopus', 
   limit = 100,
   scopusopts = list(key = Sys.getenv('ELSEVIER_SCOPUS_KEY'))))
res$scopus

# PLOS, Crossref, and arxiv
(res <- ft_search(query='ecology', from=c('plos','crossref','arxiv')))
res$plos
res$arxiv
res$crossref

# Microsoft academic search
key <- Sys.getenv("MICROSOFT_ACADEMIC_KEY")
(res <- ft_search("Y='19'...", from = "microsoft", maopts = list(key = key)))
res$ma
res$ma$data$DOI

## End(Not run)

fulltext documentation built on Feb. 9, 2018, 6:08 a.m.