Learn R Programming

⚠️There's a newer version (0.8.0) of this package.Take me there.

R Client for the MTurk Requester API

MTurkR provides programmatic access to the crowdsourcing functionality of the Amazon Mechanical Turk (MTurk) Requester API.

Possible applications of the package include:

  • Survey or experimental research using MTurk workers as human subjects
  • Large-scale human coding or categorization of text, images, video, audio, or other files
  • Collection of unstructured data from the web
  • Audio and video transcription
  • Preprocessing of "messy" data prior to statistical procedures

Installation

To install the latest development version of MTurkR from GitHub:

if(!require("devtools")){
    install.packages("devtools")
    library("devtools")
}
install_github("leeper/MTurkR")

The GitHub master branch should be considered stable, while the develop branch reflects current code that is a work in progress. Major releases are periodically pushed to CRAN. To install the latest version from CRAN, simply use:

install.packages("MTurkR")

Using MTurkR

The MTurkR documentation files contain minimal examples for all functions. Further examples of how to use MTurkR are provided in the MTurkR GitHub wiki. Users can contribute their own examples or further documentation there, or via pull requests to the GitHub repository.

If you experience problems using MTurkR, you can:

Copy Link

Version

Monthly Downloads

147

Version

0.5

License

GPL-2

Issues

Pull Requests

Stars

Forks

Maintainer

Thomas J. Leeper

Last Published

May 23rd, 2019

Functions in MTurkR (0.5)

CreateHIT

Create HIT
CreateQualificationType

Create QualificationType
AccountBalance

Retrieve MTurk account balance
DisposeHIT

Dispose HIT
GenerateExternalQuestion

Generate ExternalQuestion
GenerateNotification

Generate Notification
GenerateQualificationRequirement

Generate QualificationRequirement
GenerateHITLayoutParameter

Generate a HITLayout Parameter
ApproveAssignment

Approve Assignment(s)
GenerateReviewPolicy

Generate HIT and/or Assignment ReviewPolicies
GetAssignment

Get Assignment(s)
GrantQualification

Grant Qualification Request
MTurkR-package

Access to the Amazon Mechanical Turk (MTurk) API via R.
GetBonuses

Get Bonus Payments
RejectQualification

Reject a Worker's Qualification Request
GetFileUpload

Get Files Uploaded by Workers
DisposeQualificationType

Dispose QualificationType
ExpireHIT

Expire HIT
GrantBonus

Pay Bonus to Worker
GetStatistic

MTurk Worker and Requester Statistics
SearchHITs

Search your HITs
RevokeQualification

Revoke a Qualification from a Worker
SearchQualificationTypes

Search QualificationTypes
GetQualificationRequests

Get Qualification Requests
authenticate

Authenticate an MTurk Request
GetQualificationScore

Get a Worker's Qualification Score
MTurkR.Wizard

Interactive MTurkR Mode
mturkhelp

Get some help
credentials

Specify MTurk/AWS Credentials
UpdateQualificationType

Update a Worker QualificationType
Miscellaneous

Convenience Functions and RUI Interaction
XML

Parse MTurk XML to Dataframe
readlogfile

Read the MTurkR Logfile
AssignQualification

Assign Qualification
Blocking Workers

Block/Unblock Worker(s)
ExtendHIT

Extend HIT
GenerateAnswerKey

Generate AnswerKey Data Structure
ChangeHITType

Change HITType Properties of a HIT
ContactWorker

Contact Worker(s)
GenerateHITsFromTemplate

Generate HITs from a Template
GenerateHTMLQuestion

Generate HTMLQuestion
GetQualificationType

Get QualificationType
GetReviewResultsForHIT

Get ReviewPolicy Results for a HIT
GetQualifications

Get Qualifications
GetHIT

Get HIT
GetReviewableHITs

Get Reviewable HITs
GetHITsForQualificationType

Get HITs by Qualification
request

Execute an MTurk API Request
seconds

Convert arbitrary times to seconds
SetHITTypeNotification

Configure a HITType Notification
UpdateQualificationScore

Update a worker's score for a QualificationType
RejectAssignment

Reject Assignment
RegisterHITType

Register a HITType
SendTestEventNotification

Test a Notification
SetHITAsReviewing

Set HIT as “Reviewing”
DisableHIT

Disable HIT