Filter by computed data

You can use data received from or computed by Toloka to select Tolokers. For example, a device technical characteristics or the type of client app.

Define the assignments_issuing_config.filter object in the pool parameters.

Sample filter in JSON

This example selects Tolokers with the Windows OS and Chrome browser.

{
"filter": {
"and": [
{
"operator": "EQ",
"category": "computed",
"key": "os_family",
"value": "WINDOWS"
},
{
"operator": "EQ",
"category": "computed",
"key": "user_agent_family",
"value": "CHROME"
}
]
}
}

Key and value parameters

Key parameterValue description
region_by_phone

integer

The Toloker's region detected from the mobile phone number (the region ID in the search database).

Value of operator:

  • IN — The region is equal to the one specified or is a part of it.
  • NOT_IN — The region is not equal to the one specified and is not a part of it.

Value of value if data couldn't be extracted — null.

region_by_ip

integer

The Toloker's region detected from the IP address (the region ID in the search database).

Value of operator:

  • IN — The region is equal to the one specified or is a part of it.
  • NOT_IN — The region is not equal to the one specified and is not a part of it.

Value of value if data couldn't be extracted — null.

device_category

string

Type of device:

  • PERSONAL_COMPUTER — A personal computer.

  • SMARTPHONE — A smartphone.

  • TABLET — A tablet.

    The complete list is available on the UADetector library page.

    Value of operator:

  • EQ — Equal to.

  • NE — Not equal to.

Value of value if data couldn't be extracted — UNKNOWN.

client_type

string

Type of client application:

  • BROWSER — A web browser.
  • TOLOKA_APP — Toloka mobile app.

Value of operator:

  • EQ — Equal to.
  • NE — Not equal to.

Value of value if data couldn't be extracted — UNKNOWN.

os_family

string

The OS family, for example:

  • WINDOWS: Microsoft Windows operating system developed and marketed by Microsoft for personal computers.
  • ANDROID: Android mobile operating system based on a modified version of the Linux kernel, designed primarily for touchscreen mobile devices.
  • IOS: iOS mobile operating system developed by Apple Inc. exclusively for its mobile devices.
  • OS_X: macOS operating system developed by Apple Inc. since 2001 for Mac computers.
  • LINUX: A family of open-source Unix-like operating systems based on the Linux kernel.

The complete list is available on the UADetector library page.

Value of operator:

  • EQ — Equal to.
  • NE — Not equal to.

Value of value if data couldn't be extracted — UNKNOWN.

user_agent_type

string

Browser type:

  • BROWSER — Desktop browser.
  • MOBILE_BROWSER — Mobile browser.
  • OTHER — Other.

The complete list is available on the UADetector library page.

Value of operator:

  • EQ — Equal to.
  • NE — Not equal to.

Value of value if data couldn't be extracted — UNKNOWN.

user_agent_family

string

The browser family, for example:

  • CHROME
  • CHROME_MOBILE
  • CHROMIUM
  • FIREFOX
  • IE
  • IE_MOBILE
  • MOBILE_FIREFOX
  • MOBILE_SAFARI
  • SAFARI
  • YANDEX_BROWSER

The complete list is available on the UADetector library page.

Value of operator:

  • EQ — Equal to.
  • NE — Not equal to.

Value of value if data couldn't be extracted — UNKNOWN.

user_agent_version

float

Full browser version: <Major version>.<Minor version>.

Value of operator:

  • EQ — Equal to.
  • NE — Not equal to.
  • GT — Greater than.
  • LT — Less than.
  • GTE — Greater than or equal to.
  • LTE — Less than or equal to.

Value of value if data couldn't be extracted — null.

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
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