Home

Welcome to MTurkR - the open-source R Package that provides access to the Amazon Mechanical Turk (MTurk) Requester API.

This wiki is a source of documentation for developers and users who are working with (or contributing to) the MTurkR project.

Package installation

The latest stable release of MTurkR can be installed from your local CRAN mirror and loaded using:

install.packages("MTurkR")
library("MTurkR")

The latest development release can be installed from GitHub using devtools:

# install.packages("devtools")
library("devtools")
install_github("leeper/MTurkR")
library("MTurkR")

Quick navigation

• Basic Tutorials
  • Creating HITs
  • Qualifications
    • Using Qualifications as a Soft Worker Block
    • Using Javascript as a Soft Worker Block
    • Creating Qualifications and AnswerKeys
    • Pre-Screening Workers with Qualification Tests
  • Contacting Workers
  • [Automatic scoring with HIT and Assignment Review Policies](Review Policies)
  • [Checking the status of your HITs](HIT Status)
  • Requester statistics and worker statistics
• Addressing common issues
  • Reversing A Rejected Assignment
  • Paying Workers for Unsubmitted HITs
  • Connecting MTurk to off-site survey tools
• Interactive Wizard Documentation
  • Graphical Wizard
  • Simple Text Based Wizard
• Mimic batch features of Requester UI
• Check your TurkOpticon reviewer ratings from R

Other off-site code examples

• CRAN Documentation
• Examples in an introductory article: "Crowdsourcing with R and the MTurk API" in The Political Methodologist 20(1):2-7.
• Examples from a blog post by Solomon Messing: "Streamline Your Mechanical Turk Workflow with MTurkR

Places to get help with MTurk

• The Amazon Mechanical Turk Blog

• For help from workers or to advertise HITs/recruit workers, visit:

  • MTurk Forum
  • TurkerNation
  • The MTurk subreddit or Hits Worth Turking For
  • mturkgrind and its associated subreddit

• What are workers talking about? Check out mTurk Lingo, the urban dictionary for MTurk.

• For feedback on you and your HITs from workers, visit TurkOpticon or retrieve your reviews directly in R.

• Post your question on Stack Exchange or the AWS Developer Forum

Comments, feedback, bug reports, and suggestions on MTurkR are welcome via email and on GitHub