Package: scopusflow 0.4.0

scopusflow: A Reproducible Workflow Layer for 'Scopus' Bibliographic Searches

A coherent, quota-aware workflow layer over the Elsevier 'Scopus' Search 'API' <https://dev.elsevier.com/sc_apis.html>. It builds reproducible search plans, retrieves records with rate-limit handling, retry with back-off and optional resumable caching, normalises results to a stable tidy schema, extracts and tracks changes in Digital Object Identifiers (DOIs), sizes sets of concepts and their intersections, compares publication trends across topics, writes the search up as a reproducible record for a methods section following the 'PRISMA-S' reporting standard (Rethlefsen and others, 2021) <doi:10.1186/s13643-020-01542-z> and exports to formats compatible with downstream bibliometric tools. Network and 'API' errors are surfaced as typed conditions so that callers can respond to them programmatically. 'Scopus' is a trademark of Elsevier. This package is an independent client and is not affiliated with or endorsed by Elsevier.

Authors:Pablo Bernabeu [aut, cre]

scopusflow_0.4.0.tar.gz
scopusflow_0.4.0.zip(r-4.7-any)scopusflow_0.4.0.zip(r-4.6-any)scopusflow_0.4.0.zip(r-4.5-any)
scopusflow_0.4.0.tgz(r-4.6-any)scopusflow_0.4.0.tgz(r-4.5-any)
scopusflow_0.4.0.tar.gz(r-4.7-any)scopusflow_0.4.0.tar.gz(r-4.6-any)
scopusflow_0.4.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
scopusflow/json (API)

# Install 'scopusflow' in R:
install.packages('scopusflow', repos = c('https://pablobernabeu.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/pablobernabeu/scopusflow/issues

Pkgdown/docs site:https://pablobernabeu.github.io

Datasets:
  • example_records - A worked example harvest, in the shape 'Scopus' records take

On CRAN:

Conda:

bibliometricsliterature-reviewreproducible-researchscopus

6.44 score 42 scripts 398 downloads 33 exports 18 dependencies

Last updated from:d001234fa3. Checks:2 ERROR, 7 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develERROR146
source / vignettesOK276
linux-releaseERROR157
macos-releaseOK122
macos-oldrelOK142
windows-develOK136
windows-releaseOK91
windows-oldrelOK137
wasm-releaseOK98

Exports:as_bibliometrixas_bibtexas_risis_scopus_planis_scopus_recordsplot_scopus_comparisonplot_scopus_intersectionsplot_scopus_topplot_scopus_trendread_scopus_recordsrun_appscopus_abstractscopus_cache_clearscopus_cache_dirscopus_combinescopus_compare_topicsscopus_corpusscopus_countscopus_diff_doisscopus_extract_doisscopus_fetchscopus_fetch_planscopus_field_tagsscopus_has_keyscopus_intersectionsscopus_planscopus_queryscopus_quotascopus_recordsscopus_search_reportscopus_topscopus_trendwrite_scopus_records

Dependencies:askpassclicurlgluehttr2jsonlitelifecyclemagrittropensslpillarpkgconfigR6rlangsystibbleutf8vctrswithr

About
Citing scopusflow | The developer | Licence | Versioning and archival | Contributing and support
Rendered fromabout.Rmdusingknitr::rmarkdown

Last update: 2026-10-10
Started: 2026-07-03

Search plans and quota-aware retrieval
A query, built safely | Describing the search as a plan | Why page size is a quota decision | Sizing before spending | Fetching, with caching and resume | Watching progress | Combining separate retrievals | Writing the search up | When the ceiling bites | Handling interruptions
Rendered fromplans-and-quota.Rmdusingknitr::rmarkdown

Last update: 2026-10-08
Started: 2026-06-14

Building and exporting a reference set
Take stock first | A clean, deduplicated DOI list | Into a reference manager | Handing off to science mapping | Saving the working set
Rendered frombuilding-a-reference-set.Rmdusingknitr::rmarkdown

Last update: 2026-10-03
Started: 2026-06-14

Author keywords and references
Author keywords from a search | References via Abstract Retrieval | A minimal, cross-tool corpus
Rendered fromkeywords-and-references.Rmdusingknitr::rmarkdown

Last update: 2026-10-03
Started: 2026-07-03

Designing precise queries across disciplines
Field tags decide where to look | One term, many disciplines | Combining terms with boolean operators | Phrases | Brackets in a query written by hand | From a query to a plan | Searching by affiliation | When a term is empty | Checks before any request | Checking recall against known records
Rendered fromdesigning-queries.Rmdusingknitr::rmarkdown

Last update: 2026-10-03
Started: 2026-06-14

Analysing and visualising a literature
What is in a record set | How a literature grows | Where a niche sits | Reading the fuller record | Beyond five thousand records
Rendered fromanalysing-a-literature.Rmdusingknitr::rmarkdown

Last update: 2026-10-03
Started: 2026-06-20

Using the code-free app
Launching the app | Demo mode | Describing and sizing a search | Fetching, with a live terminal | The reproducible code panel | Reading the results | Comparing topics | Exporting | Beyond the app
Rendered fromusing-the-app.Rmdusingknitr::rmarkdown

Last update: 2026-10-03
Started: 2026-06-22

Comparing topics over time
What the comparison measures | The shape of the result | A first plot | When lines converge at the right end | Drawing the eye to one topic | Adjusting the labels | Reading the result as a table
Rendered fromcomparing-topics.Rmdusingknitr::rmarkdown

Last update: 2026-08-20
Started: 2026-06-14

Get started
Describing a search as a plan | Sizing and fetching | The record schema | Most frequent sources and authors | DOIs and change tracking | Comparing topic trends | Author keywords and references | Export and interoperability | Writing the search up | Handling failures
Rendered fromscopusflow.Rmdusingknitr::rmarkdown

Last update: 2026-08-20
Started: 2026-06-13

Tracking how a literature changes between retrievals
The baseline | A later retrieval | What changed | Merging without duplicates | Keeping a record of each pull
Rendered fromtracking-literature-change.Rmdusingknitr::rmarkdown

Last update: 2026-08-20
Started: 2026-06-14

Readme and manuals

Help Manual

Help pageTopics
Convert records to a bibliometrix-compatible data frameas_bibliometrix
Export records to BibTeX or RISas_bibtex as_ris
Normalise raw 'Scopus' entries to a stable tidy schemaas.data.frame.scopus_records as_tibble.scopus_records autoplot.scopus_records is_scopus_records scopus_records
A worked example harvest, in the shape 'Scopus' records takeexample_records
Plot a topic comparisonautoplot.scopus_comparison plot_scopus_comparison
Plot concept and intersection sizesautoplot.scopus_intersections plot_scopus_intersections
Plot the most frequent values in a record setautoplot.scopus_top plot_scopus_top
Plot a publication trendautoplot.scopus_trend plot_scopus_trend
Launch the scopusflow apprun_app
Retrieve abstracts and richer metadatascopus_abstract
Clear the scopusflow managed cachescopus_cache_clear
Managed cache directory for scopusflowscopus_cache_dir
Combine record sets into onec.scopus_records scopus_combine
Compare publication trends across topicsscopus_compare_topics
Assemble a minimal, cross-tool corpus with keywords and referencesscopus_corpus
Count 'Scopus' results for a queryscopus_count
Compare two DOI retrievalsscopus_diff_dois
Extract, clean and optionally export DOIsscopus_extract_dois
Fetch 'Scopus' records for a queryscopus_fetch
Execute a 'Scopus' search plan, with optional caching and resumescopus_fetch_plan
Recognised 'Scopus' field tagsscopus_field_tags
Locate the 'Scopus' API key and institutional tokenscopus_has_key
Count a set of concepts and their intersectionsscopus_intersections
Build a reproducible 'Scopus' search planis_scopus_plan scopus_plan
Build a field-tagged 'Scopus' queryscopus_query
Parse 'Scopus' quota and rate-limit headersscopus_quota
Assemble a reproducible record of a 'Scopus' searchformat.scopus_search_report print.scopus_search_report scopus_search_report
Most frequent values in a record setscopus_top
Annual publication counts for a queryscopus_trend
Summarise a set of 'Scopus' recordssummary.scopus_records
Read and write 'Scopus' record setsread_scopus_records write_scopus_records