Overview

You can choose which Tolokers will have access to pool tasks. For example, you can select Tolokers by region, skill, or browser type (desktop or mobile).

To set up Toloker filtering for a pool, add the filter JSON object to the assignments_issuing_config attribute when creating or editing a pool.

A sample filter in JSON with a parameter description is shown below.

Note

The JSON filter description must not exceed 10,000 characters.

Sample filter in JSON

This example selects Tolokers from US or United Kingdom for completing tasks (it uses the region detected from the Toloker's IP address and the country specified in the profile). Users must have a minimum skill level of 60 for the control page results.

{
"filter": {
"and": [
{
"or": [
{
"category": "computed",
"key": "region_by_ip",
"operator": "IN",
"value": 84
},
{
"category": "computed",
"key": "region_by_ip",
"operator": "IN",
"value": 102
}
]
},
{
"category": "skill",
"key": "2",
"operator": "GTE",
"value": "60"
}
]
}
}

Parameters

Note

The and and or parameters must be lowercase.

ParameterOverview
category

string | required

Group of data for filtering:

  • skill — The skill.
  • profile — Profile data.
  • computed — Computed data, such as the Toloker's region according to the IP address.
keystring | required

Attribute to use for filtering Tolokers. For example, the country (country), or a skill (specify the skill ID).
operator

string | required

Comparison operator in the condition. For example, the condition "Toloker must be 18 or older" uses the date of birth and the GTE ("Greater than or equal to") operator. Possible values for the operator key depend on the type of data in the value field. To choose the correct value, see the descriptions of filters in the sections Filter by profile data, Filter by calculated data, Filter by skills.

Note

The operator value must be lowercase.

valueboolean, string, list of strings, integer | required

The value of the attribute from the key field. For example, the ID of the region specified in the profile, or the minimum skill value. To choose the correct value, see the descriptions of filters in the Filter by profile data, Filter by calculated data, Filter by skills sections.

See also

Contact support

Last updated: July 4, 2023

Toloka API
OverviewAccessing the APIRate limiting
Quick start
Configuration for Template BuilderToloker selection
Quality control rules
Filters
Task actions
Subscriptions to events
3d-party platform integration
Reference
Project
Pool
Training
Webhook-subscription
Skill
User-restriction
Task
Task-suite
Operation
Assignment
Attachment
Aggregated-solution
User-bonus
Message-thread
User-metadata
Requester
All classes and methods