Understanding Requesters and Workers - Amazon Mechanical Turk

Understanding Requesters and Workers

Working With Amazon Mechanical Turk Accounts

Requesters and Workers are Amazon Mechanical Turk users and have Amazon.com accounts. Account information is managed by Amazon.com, so anyone with an Amazon.com account can use that account's email address and password to sign in to Amazon Mechanical Turk.

Your Amazon.com account holds the money you will pay to Workers as rewards for completing HITs, as well as the money to pay for Amazon Mechanical Turk listing fees. A Worker's Amazon.com account holds the money the Worker receives from Requesters for completing HITs. You can transfer money to and from your Amazon.com account at any time using the Requester Console. Workers transfer money using the Amazon Mechanical Turk website.

To retrieve your Prepaid HITs balance

  • Use GetAccountBalance in a request similar to the following.

    https://mechanicalturk.amazonaws.com/?Service=AWSMechanicalTurkRequester &AWSAccessKeyId=[the Requester's Access Key ID] &Version=2008-04-01 &Operation=GetAccountBalance &Signature=[signature for this request] &Timestamp=[your system's local time]

    This request retrieves the Requester's account balance.

Using Statistics and System Qualifications

Amazon Mechanical Turk keeps statistics about every user's activity in the system. Workers can view their own statistics using the Amazon Mechanical Turk website. You can view your own statistics using the Requester Console.

HITs can use some Worker statistics as the basis for Qualification requirements. These are known as system Qualifications.

To get requester statistics

  • Use GetRequesterStatistic in a request similar to the following.

    https://mechanicalturk.amazonaws.com/?Service=AWSMechanicalTurkRequester &AWSAccessKeyId=[the Requester's Access Key ID] &Version=2008-08-02 &Operation=GetRequesterStatistic &Signature=[signature for this request] &Timestamp=[your system's local time] &Statistic=TotalRewardPayout &TimePeriod=ThirtyDays &Count=1

    This request retrieves the total reward payout for the thirty days leading up to the current date.

Contacting Workers

NotifyWorkers lets you send email to Workers who have interacted with you in the past. Using the Worker ID included with the data the Worker submits to you, you can send a Worker a message without having to know his or her name or email address.

If you have work in the system, Workers can contact you using the Amazon Mechanical Turk website. Amazon Mechanical Turk relays the message to you by email.

To email Workers you've worked with

  • Use NotifyWorkers in a request similar to the following.

    https://mechanicalturk.amazonaws.com/?Service=AWSMechanicalTurkRequester &AWSAccessKeyId=[the Requester's Access Key ID] &Version=2008-04-01 &Operation=NotifyWorkers &Signature=[signature for this request] &Timestamp=[your system's local time] &Subject=Thank%20you &MessageText=Hello!%20Just%20wanted%20to%20say%20thank%20you... &WorkerId.1=AZ3123EXAMPLE &WorkerId.2=AZ3456EXAMPLE &WorkerId.3=AZ3789EXAMPLE

    This request sends an email message to three Workers.