Survey on third-party platform

In this tutorial, you will learn how to use Toloka to run a survey created on a third-party platform.

You may need a third-party platform, when:

  • Your survey form is too long and complicated to be created in Toloka.

  • You are already conducting the survey using other channels to reach out to respondents, and would like to aggregate all the results in one place.

In Toloka, you can place a link to your survey in the task interface. To enable a Toloker to confirm survey completion, show a code to each respondent who takes the survey on the third-party platform. The respondent will need to copy the code and paste it to the task in Toloka. You will see this code in the results file and will be able to check if it is correct.


There are also other survey presets in Toloka. Choose the right one with the help of our comparison in the Overview section.


Before you begin:

  • Make sure you are registered in Toloka as a requester.

  • Top up your Toloka account. If you are unsure about the budget, you can do that later in this tutorial. Toloka will display the budget estimate for your project.

  • See the What tasks can't be placed in Toloka? section. Remember that both Tolokers and requesters are anonymous.

    • You should not collect personal data: a full name, contacts, or any other information that can be used to identify a Toloker. To determine whether a Toloker belongs to your target audience, you can ask for their city, date of birth, and age category.

    • To communicate with Tolokers, use private messages in Toloka only.

Create a project

We recommend starting with a project preset for easier configuration and better results.

  1. Follow this link, or create a project manually:

    1. Click Create a project.

      Choose a preset. Step 1
    2. Click Do it myself.

    3. Select the Survey on third-party platform preset.

  2. Click Choose this preset in the pop-up tab.

  3. In the General information section, add the project name and description:

    • Name to show Tolokers: In 2–5 words, state the general idea of the project.

    • Description for Tolokers: In a couple of sentences, explain what you expect Tolokers to do. This is just an overview. You will write instructions later.

    Create a project. Step 1
  4. In the Task interface section, set up what your tasks will look like. This preset has a task template with validation and task layout pre-configured.


    This tutorial uses Template Builder, but you can use the HTML/JS/CSS editor for the same purpose.

    1. In the Config section, you can edit the pre-configured code. For example, to change the description, replace the sample text with your value in the label property.

      Create a project. Config question description

      To learn about other properties of the Config section, their possible values and the impact on the task interface, see the Template Builder Help.

    2. In the Input data example section, you can see a sample link.

      Create a project. Input example external

      It is only an example used to display the task interface preview on the right. You will add a link to your survey later while uploading a task file.

    3. Click Data specification → Show specifications. In the following sections, you will see the parameters which match the task interface you set up in Template Builder:

      • Input data: A parameter for a link to your survey.

      • Output data: Parameters for completion codes entered by Tolokers and for their comments if they have problems with getting a code.


      You can also display a survey form in an iframe if a third-party platform allows it. To learn more about the view.iframe component, see the Template Builder Help.

  5. In the Instructions for Tolokers editor, enter the instructions Tolokers will see when they start doing your tasks. You can add text, tables, and images to your instructions.

    Check the sample text of the instructions, and update it to fit your project.


    Do not add a link to your external survey form to the instructions. Specify the link only in the file with tasks. See the section below to learn how you can do that.

  6. In the upper-right corner, click Save.

    Learn more about working with the project in the Project section.

Create a pool

A pool is a set of tasks sent out to Tolokers at the same time. One project can have many pools. When creating a pool, you set up pricing, audience filters for Tolokers, and quality control.

You can create a pool using one of the ways:

  • From a preset — a new pool with settings for survey:

    • Load one static link to the survey. To learn more, see the Upload data section.

    • Don't add correct completion codes to the file with tasks.

    • Indicate an overlap equal to the required number of Tolokers.

    • Use manual review.


    In this case, you need to adjust the overlap, the price of the survey, and the audience settings (including the skill by which the platform will exclude the Tolokers who have already completed the survey once). To learn more about pool settings, see the section below about creating a pool from scratch.

  • From scratch — a new pool with default settings.

Create a pool from the preset
Create a pool from scratch
  1. If there are no pools in the project, click Create pool from preset for Survey on third-party platform on the Pools tab. Otherwise, click Add a pool → From Survey on third-party platform preset at the right side of the project page.

  2. Set the Pool name (visible only to you) field. Only you will see this pool name on the project page.

  3. Specify the pool description which will be displayed instead of the project description in the task list for Tolokers. By default, Tolokers see the description from the project settings. To use a different description, uncheck the Use project description box and set Public description. If necessary, click + Private comment to add a private project description that only you will see.

  4. At the Select the audience for your task step, set up filters to select Tolokers for your pool.

  5. Clear My tasks may contain shocking or pornographic content if your project has none of those.

  6. At the Setup quality control step, check the quality control rules and correct them if necessary.

  7. At the Add optional pool settings step, specify the Time per task suite, sec.

  8. At the Set the task price and overlap step, set up how much a single task will cost for you.

    1. In Price per task suite, set the amount of money to pay for survey completion by one Toloker.

      In survey projects, a task suite must contain only one task. Otherwise, a Toloker will see several identical surveys on one page. You will set the number of tasks per suite later in this tutorial.

    2. In the Overlap field, define how many respondents for each task you need.

      • If you are going to use one static link to your survey, the overlap should be equal to the number of respondents you need for the survey as a whole. You can also increase overlap when labeling is in progress or when it’s completed.

      • If you are going to provide many survey links and each of them will be given to one Toloker only, the overlap should be set to 1.

      You will prepare the file with one or several survey links in the next step.

  9. Upload your task data.

  10. At the Double-check your project and try out tasks step, check how the task will look from the Toloker's point of view.


    This step will be enabled after you complete the previous steps. You can skip this step by clicking Do it later.

After all the steps, you'll see the Set up is finished and your pool is ready for labeling tip on the pool page.

Upload data

  1. Go to the Prepare and upload data step if you're creating a pool or click the Upload button on the pool page.

  2. Create the tasks for Tolokers:

    1. To download a template, click one of the buttons:

      • Template in XLSX
      • Template in TSV
      • Template in JSON
    2. Open the downloaded file. It must have one parameter which name equals INPUT:survey_link, and the values are links.

      1. Replace the sample links with your data. You can:

        • Specify one static link to your survey.

          In this case, the overlap you’ve set in step 6.2 of creating the pool should be equal to the number of respondents you need.

        • Provide many survey links to give each of them to one Toloker.

          In this case, the number of links in the file should be equal to the number of respondents you need. The overlap should be set to 1.

          You can use different survey links if it’s necessary to generate different codes for each Toloker. It’s also possible to specify the same link many times.

          • Different completion codes for each Toloker help minimize the risk of fraud.

          • If you provide many survey links, make sure that you’ve configured the Submitted responses rule and the Time per task suite, sec value is enough (see steps 4.5 and 5 of creating the pool).

          For example, the XLSX file should look as follows:

          One link (overlap > 1)
          Many links (overlap = 1)

      2. If you know the correct completion codes beforehand, add the GOLDEN:code parameter to the file and specify its values:

        One link (overlap > 1)
        Many links (overlap = 1)
        INPUT:url GOLDEN:code 123456

        In this case, you can automatically accept tasks from those who entered a completion code correctly. Use the Control tasks rule from step 4.6 of creating the pool.

    3. Click Drop file here or select, and upload the file you’ve just made.

    4. Click Continue.

    5. Tasks are shown to Tolokers in suites. A suite is a single page with multiple tasks.

      Go to the Set manually tab. Set one task per suite, that is a Toloker will see only one task with your survey on the page:

      Upload data. Tasks per suite
    6. Click Combine tasks into suites.

Start labeling

  1. Make sure you have topped up your account.

  2. Go to the pool page and click the Preview button to check your task.

    1. Follow the link to your survey to make sure that it works.

    2. Enter the code and submit the task.

    If the page reloaded successfully, your task works correctly.

  3. To send the tasks to Tolokers and begin the labeling process, click Start labeling.

    Start labeling
  4. In the pop-up panel, review the budget and click Launch.

See the results

Track the progress of responses collection on the pool page. You can start the review when the first results are received.

If you’ve set the Control tasks rule in step 4.6 of creating the pool, most of the tasks may be already accepted.

Review the rest of the tasks during the time period specified in the Review period in days field in step 4.1. After that period, all responses are automatically accepted, regardless of whether completion codes are correct or not.

  1. Go to the pool, and click Review assignments.

    See the results. Review assignments
  2. Choose an assignment.

  3. Check the completion code, and click Accept or Decline. For rejected responses, enter a comment to specify the reason.

    To learn about other ways of review, see the Reviewing Tolokers’ responses section.

    • Do not rush to reject responses that have not passed automatic completion via codes. Some codes will be incorrect indeed, but often Tolokers add extra spaces accidentally or leave comments in a text field which is intended for a code.

    • If there were technical problems (for example, a Toloker had filled an external survey form, but didn’t have time to submit a task in Toloka), you still can pay the Toloker. To do this, use the bonus system.

Helpful tips

  • You can use questions with known answers to check that Tolokers pay attention. In that case, even if a Toloker answers incorrectly, it’s better to still provide them a special completion code, different from the correct one. When you see that special code in the results, you can reject the assignment. The Toloker won’t be dissatisfied that you didn't allow them to finish the task.

  • You can conduct a survey in two stages. For example, it can be useful when the general filters of the Audience section are not enough to select Tolokers you need. Use skills:

    • In the first survey, assign the skill to the relevant Tolokers.

    • In the second survey, specify the skill in the Audience section to make the survey available to the relevant Tolokers from the first stage.

    You can notify Tolokers about the second survey using messages to those of them who have the necessary skill.

  • Sometimes a survey may follow different scenarios depending on answers given to the previous questions. In this case, make sure that all scenarios have a completion code in the end.

  • Check the Messages tab regularly to get Tolokers’ reports on problems with your survey.

See also

For developers

Datasets and reference

Contact support

Last updated: March 10, 2023

List of examples
Data enrichment
Field tasks
Help and support