Need help with qualtRics?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

ropensci
164 Stars 54 Forks Other 766 Commits 23 Opened issues

Description

Download ⬇️ Qualtrics survey data directly into R!

Services available

!
?

Need anything else?

Contributors list

qualtRics

Authors: Julia Silge, Jasper Ginn
License: MIT

R-CMD-check CRAN_Status_Badge CODECOV rOpenSci DOI DOI Downloads Total Downloads Project Status: Active – The project has reached a stable, usable state and is being actively developed. <!-- badges: end -->

Qualtrics is an online survey and data collection software platform. Qualtrics is used across many domains in both academia and industry for online surveys and research. While users can manually download survey responses from Qualtrics through a browser, importing this data into R is then cumbersome. The qualtRics R package implements the retrieval of survey data using the Qualtrics API and aims to reduce the pre-processing steps needed in analyzing such surveys. Currently, this package is the only package on CRAN that offers such functionality, and is included in the official Qualtrics API documentation.

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 to find your API token.

The authors of this package are not affiliated with Qualtrics, and Qualtrics does not offer support for this package. For specific information about the Qualtrics API, you can refer to the official documentation.

Installation

This package can be installed from CRAN:

install.packages("qualtRics")

Alternatively, you can install the development version with the remotes package (or alternatively, devtools):

install.packages("remotes")
remotes::install_github("ropensci/qualtRics")

Access your Qualtrics data

Currently, the package contains three core functions:

  1. all_surveys()
    fetches a list of all surveys that you own or have access to from Qualtrics.
  2. fetch_survey()
    downloads a survey from Qualtrics and loads it into R.
  3. read_survey()
    allows you to read CSV files you download manually from Qualtrics.

It also contains helper functions:

  1. qualtrics_api_credentials()
    stores your API key and base url in environment variables.
  2. survey_questions()
    retrieves a data frame containing questions and question IDs for a survey;
    extract_colmap()
    retrieves a similar data frame with more detailed mapping from columns to labels.
  3. metadata()
    retrieves metadata about your survey, such as questions, survey flow, number of responses etc.

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

Register your Qualtrics credentials

There are two important credentials you need to authenticate with the Qualtrics API. These are your API key and institution-specific base URL. The base URL you pass to the qualtRics package should either look like

yourdatacenterid.qualtrics.com
or like
yourorganizationid.yourdatacenterid.qualtrics.com
, without a scheme such as
https://
. The Qualtrics API documentation explains how you can find your base URL.

You can store your API credentials

QUALTRICS_API_KEY
and
QUALTRICS_BASE_URL
in your
.Renviron
file for repeated use across sessions. The qualtRics package has a function to help with this.
library(qualtRics)

qualtrics_api_credentials(api_key = "", base_url = "", install = TRUE)

After you use this function, reload your environment (

readRenviron("~/.Renviron")
) so you can use the credentials without restarting R.

A simple Qualtrics workflow

Once your Qualtrics API credentials are stored, you can see what surveys are available to you.

surveys 

You can then download the data from any of these individual surveys (for example, perhaps the sixth one) directly into R.

mysurvey 

See the qualtRics vignette for more details on variable metadata, automatic conversion of variables, retrieving responses between specific dates or for specific survey items, and more.

Related work

  • Jason Bryer wrote an R package to work with the previous version of the Qualtrics API
  • QualtricsTools creates automatic reports in shiny.
  • qsurvey by James Dunham focuses on testing and review of surveys before fielding, and analysis of responses afterward.

Community Guidelines

This project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. Feedback, bug reports (and fixes!), and feature requests are welcome; file issues or seek support here.

ropensci_footer

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.