Skip to contents

Query the arXiv API (Atom feed) for preprints and return the results as an sm_corpus.

Uses start/max_results pagination to retrieve up to n_max results. The arXiv API is free and requires no authentication.

Usage

sm_fetch_arxiv(query, n_max = 200L, verbose = TRUE, call = rlang::caller_env())

Arguments

query

arXiv search query string using the arXiv query syntax. Supports all:, ti:, au:, abs:, cat:, etc.

n_max

Maximum number of results to return (default 200).

verbose

Print progress messages?

call

Caller environment for error reporting.

Value

An sm_corpus object.

Examples

# \donttest{
# Queries the arXiv web API.
if (requireNamespace("curl", quietly = TRUE) && curl::has_internet()) {
  corpus <- try(sm_fetch_arxiv(query = "all:bibliometrics", n_max = 5))
  print(corpus)
}
#> ℹ Fetching from arXiv: "all:bibliometrics"
#> ℹ Fetched 5 / 5 arXiv entries.
#> ✔ Parsed 5 arXiv entries into sm_corpus.
#> 
#> ── <sm_corpus> ─────────────────────────────────────────────────────────────────
#> Works: 5 | Authors: 22 | Institutions: 0
#> Years: 2009 - 2021
#> Sources (journals): 0
#> Embeddings: none
#> Provenance: arxiv (5)
#> Status: Unlocked (last refreshed: never)
# }