R Interface to the Data Retriever

Provides an R interface to the Data Retriever < https://retriever.readthedocs.io/en/latest/> via the Data Retriever's command line interface. The Data Retriever automates the tasks of finding, downloading, and cleaning public datasets, and then stores them in a local database.

R interface to the Data Retriever.

The Data Retriever automates the tasks of finding, downloading, and cleaning up publicly available data, and then stores them in a local database or csv files. This lets data analysts spend less time cleaning up and managing data, and more time analyzing it.

This package lets you access the Retriever using R, so that the Retriever's data handling can easily be integrated into R workflows.


To use the R package rdataretriever you first need to install the Retriever. Installers are available for all major operating systems from the Install page or it can be installed from source.

Add Retriever to the path

The R package takes advantage of the Data Retriever's command line interface which must be enabled by adding it to the path on Mac platforms. On a Windows platform the Retriever should be added automatically to the path.

Install R package

To install the development version of the R package rdataretriever, use the devtools package:



# List the datasets available via the Retriever 
# Install the portal into csv files in your working directory 
# Download the raw portal dataset files without any processing to the 
# subdirectory named data 
# Install and load a dataset as a list 
portal = rdataretriever::fetch('portal')

To get citation information for the rdataretriever in R use citation(package = 'rdataretriever')


A big thanks to Ben Morris for helping to develop the Data Retriever. Thanks to the rOpenSci team with special thanks to Gavin Simpson, Scott Chamberlain, and Karthik Ram who gave helpful advice and fostered the development of this R package. Development of this software was funded by the National Science Foundation as part of a CAREER award to Ethan White.

ropensci footer


Reference manual

It appears you don't have a PDF plugin for this browser. You can click here to download the reference manual.


3.0.0 by Henry Senyondo, a month ago

https://docs.ropensci.org/rdataretriever/ (website), https://github.com/ropensci/rdataretriever/

Report a bug at https://github.com/ropensci/rdataretriever/issues

Browse source code at https://github.com/cran/rdataretriever

Authors: Daniel McGlinn [aut] , Pranita Sharma [aut] , David J Harris [aut] , Henry Senyondo [aut, cre] , Hao Ye [aut] , Shawn Taylor [aut] , Apoorva Pandey [aut] , Harshit Bansal [aut] , Max Pohlman [aut] , Ethan White [aut]

Documentation:   PDF Manual  

MIT + file LICENSE license

Imports reticulate, semver

Suggests testthat, DBI, devtools, RSQLite, RPostgreSQL

System requirements: Python (>= 3.0), retriever (>= 3.0.0) (version must be listed to patch to allow parsing)

See at CRAN