Download Qualtrics Survey Data Directly into R

Qualtrics < https://www.qualtrics.com/about/> allows users to collect online data through surveys. This package contains convenience functions to pull survey results straight into R using the Qualtrics API. See < https://api.qualtrics.com/> for more information about the Qualtrics API.


This project contains an R package to interact with the Qualtrics API. It is currently under development. I will add more functionality later.

Note that your institution must support API access and that it must be enabled for your account. Whoever manages your Qualtrics account can help you with this. Please refer to the Qualtrics documentation on how to find your API token.

To install this package, execute the following in R:

install.packages("qualtRics")

Or, if you want to install the latest development version, run:

install.packages("devtools")
devtools::install_github("JasperHG90/qualtRics")

This package depends on httr, stringr, jsonlite and XML. All dependencies will be installed when you install qualtRics.

Periodically check this repository for updates and execute devtools::install_github("JasperHG90/qualtRics") to update.

Currently, the package contains three functions. It supports fetching a list of courses and their IDs from qualtrics, as well as downloading and reading a survey export.

Note that, while requests will work without a root url for the getSurveys function, it is desirable that you supply it. Supplying the correct url will reduce the number of errors you'll experience. The getSurvey function requires you to pass this root url. Please refer to the official documentation to find out your institution-specific root url.

Note that you can only export surveys that you own, or to which you have been given explicit administration rights.

Load the package:

library(qualtRics)

Register your Qualtrics API key. You need to do this only once per R session:

registerApiKey(API.TOKEN = "<yourapitoken>")

Get a data frame of surveys:

surveys <- getSurveys(root_url="https://leidenuniv.eu.qualtrics.com") # URL is for my own institution

Export a survey and load it into R:

mysurvey <- getSurvey(surveyID = surveys$id[6], root_url = "https://leidenuniv.eu.qualtrics.com", verbose = TRUE)

You can request a CSV, JSON or XML file:

mysurvey <- getSurvey(surveyID = surveys$id[6], format="csv", root_url = "https://leidenuniv.eu.qualtrics.com", verbose = TRUE) # CSV
mysurvey <- getSurvey(surveyID = surveys$id[6], format="json", root_url = "https://leidenuniv.eu.qualtrics.com", verbose = TRUE) # JSON
mysurvey <- getSurvey(surveyID = surveys$id[6], format="xml", root_url = "https://leidenuniv.eu.qualtrics.com", verbose = TRUE) # XML

You may also store the results in a filepath of your choosing:

mysurvey <- getSurvey(surveyID = surveys$id[6], format="csv", save_dir = "/users/jasper/desktop/", root_url = "https://leidenuniv.eu.qualtrics.com", verbose = TRUE)

For specific information about the Qualtrics API, you can refer to the official documentation.

Should you encounter any bugs or issues, please report them here

If you have a request (like adding a new argument), please leave it here

[v0.03]

  • User can choose to save results directly in a folder through 'save_dir' parameter in getSurvey()
  • Results can now be requested in .csv, .json or .xml format. The packages jsonlite and XML are added to 'Suggests' in DESCRIPTION.
  • constructHeader() is now deprecated and should no longer be used. Instead, users need to call registerApiKey().
  • Added a new function registerApiKey() which saves the user's API key and header information in the tempdir() environment.

[v0.02]

  • Renamed 'base url' to 'root url' such that it corresponds to Qualtrics documentation.
  • The root url no longer requires API-specific endpoints. So e.g. 'https://leidenuniv.eu.qualtrics.com' now works for all functions. The API-specific endpoints are added in the functions itself.
  • Institution-specific root url is now required by getSurvey()

[v0.01]

  • Added first three functions (constructHeader, getSurvey, getSurveyIDs)
  • base_url parameter is now uniform across functions. Parameter is called 'root url' to bring it in line with Qualtrics documentation.

News

Reference manual

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

install.packages("qualtRics")

2.0 by Jasper Ginn, a month ago


https://github.com/JasperHG90/qualtRics


Report a bug at https://github.com/JasperHG90/qualtRics/issues


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


Authors: Jasper Ginn


Documentation:   PDF Manual  


GPL-3 | file LICENSE license


Imports httr, stringr, jsonlite, assertthat, sjlabelled, lubridate, yaml

Suggests knitr, rmarkdown, testthat


See at CRAN