Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


The package is the main R package for working with datasets on
Using this packages users can:

  • Query and join datasets
  • Choose between SQL and SPARQL
  • Publish insights
  • Use's REST API (via included dwapi package)

Getting Started

To get started, load the library and checkout the quickstart vignette.

vignette("quickstart", package = "")

Here is a simple example:

intro_ds <- ""

sample_query <-
  "SELECT t.Name, t.Height, s.AssistsPerGame ",
  "FROM DataDotWorldBBallTeam as t ",
  "JOIN DataDotWorldBBallStats as s ON t.Name = s.Name ",
  "ORDER BY s.AssistsPerGame DESC")), dataset = intro_ds)

Notice that dataset is parameter required by most functions and can be provided in two formats:

  1. URL: ""
  2. Path: "jonloyens/an-intro-to-dataworld-dataset"

Publishing Insights

For your convenience, this package allows you to publish insights to data projects without leaving R Studio.

Using R Studio's "Addins" menu, look for DATA.WORLD > New insight.

Add-in Menu

The add-in will automatically capture the active plot in R Studio's plot view and give you the opportunity to quickly choose the project, and enter title and description for your insight.

Add-in Window


To install directly from GitHub:

devtools::install_github("datadotworld/", build_vignettes = TRUE)

Note: You will need to have the devtools package for R installed to run the previous command. If that is not already installed, you can install it from CRAN using the command:



First, users must obtain an API authentication token at:

IMPORTANT: For your security, do not include your API authentication token in code that is intended to be shared with others.

Configuration can be provided in 3 forms:

  • Via config file
  • Via environment variables
  • At runtime

Config files are the most convenient configuration method. Once saved configuration will be automatically restored when is loaded.

From the R console:

saved_cfg <-"YOUR API TOKEN")

For additional configuration options, see ?set_config


Check out the quickstart and query vignette and the package documentation (?

> vignette("quickstart", package = "")
> ?


We've removed the package from CRAN and recommend installing directly from Github.

You can’t perform that action at this time.