A simulated environment to test your HITs.
About the Sandbox
The Mechanical Turk Developer Sandbox is a simulated environment that lets you test your applications and Human Intelligence Tasks (HITs) prior to publication in the marketplace.
- Free to use for registered Mechanical Turk requesters. Fees will not be withdrawn and payments are not made to Worker accounts.
- Has functional parity with the production website.
- Requires only a URL change to configure your application to work against the developer sandbox or the production website.
How do I use the Developer Sandbox?
How do I configure my application to use the Developer Sandbox?
To use the Developer Sandbox during development and testing, set the URL service endpoint in your code to point to the sandbox endpoint: https://mturk-requester-sandbox.us-east-1.amazonaws.com
To use the Developer Sandbox for testing HITs using external questions, set the destination URL for the form action to be:
To switch your application to the production Mechanical Turk system, set the URL service endpoint to: https://mturk-requester.us-east-1.amazonaws.com
To switch your HITs using external questions to the production Mechanical Turk system, set the destination URL for the form action to be:
Example using Python:
region_name = 'us-east-1'
aws_access_key_id = 'YOUR_ACCESS_ID'
aws_secret_access_key = 'YOUR_SECRET_KEY'
endpoint_url = 'https://mturk-requester-sandbox.us-east-1.amazonaws.com'
# Uncomment this line to use in production
# endpoint_url = 'https://mturk-requester.us-east-1.amazonaws.com'
client = boto3.client('mturk',
endpoint_url = endpoint_url,
region_name = region_name,
aws_access_key_id = aws_access_key_id,
aws_secret_access_key = aws_secret_access_key,
# This will return $10,000.00 in the MTurk Developer Sandbox
Example for HITs using external questions:
Set the form action URL to your desired environment:
<!-- This POST method is posting to the sandbox worker site-->
<form method="POST" action="https://workersandbox.mturk.com/mturk/externalSubmit">
<!-- This POST method is posting to the production worker site-->
<!--<form method="POST" action="https://www.mturk.com/mturk/externalSubmit">-->
<input type="hidden" id="assignmentId" name="assignmentId" value="">
What features of Mechanical Turk are not supported in the Developer Sandbox?
What are the guidelines and policies for the Developer Sandbox?
Have a question about the Application Program Interface (API) or Command Line Tools (CLTs)? Post your questions and comments in the developer forum.
Visit the Developer Forum »