Filter by computed data

  1. Sample filter in JSON
  2. Key and value parameters

You can use data received from or computed by Toloka to select users:

  • Technical details of devices.

  • The user's rating (calculated from the total amount earned in Toloka).

Define the filter object in the pool parameters.

Sample filter in JSON

This example selects users with the Windows OS and Yandex Browser.

{
  "filter" : {
    "and" : [ {
      "operator" : "EQ",
      "category" : "computed",
      "key" : "os_family",
      "value" : "WINDOWS"
    }, {
      "operator" : "EQ",
      "category" : "computed",
      "key" : "user_agent_family",
      "value" : "YANDEX_BROWSER"
    } ]
  }
}
Copied to clipboard

Key and value parameters

Key parameter

Value description

region_by_phone

integer

The user'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 user'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 — 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

  • ANDROID

  • IOS

  • OS_X

  • MAC_OS

  • LINUX

  • BSD

  • BLACKBERRY

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.

os_version

float

Full operating system version: <Major version>.<Minor version>. For example, 14.4.

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.

os_version_major

integer

The OS major version. For example, 14.

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.

os_version_minor

integer

The OS minor version. For example, 4.

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.

os_version_bugfix

integer

The OS build number (bugfix version). For example, 1.

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.

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:

  • IE

  • IE_MOBILE

  • YANDEX_BROWSER

  • FIREFOX

  • MOBILE_FIREFOX

  • CHROME

  • CHROME_MOBILE

  • CHROMIUM

  • SAFARI

  • MOBILE_SAFARI

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.

user_agent_version_major

integer

Major version of the browser.

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.

user_agent_version_minor

integer

Minor version of the browser.

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.

user_agent_version_bugfix

integer

The browser's build number (bugfix 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.

rating

float

The user's rating. Calculated from earnings in all projects available to the users.

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.

Key parameter

Value description

region_by_phone

integer

The user'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 user'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 — 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

  • ANDROID

  • IOS

  • OS_X

  • MAC_OS

  • LINUX

  • BSD

  • BLACKBERRY

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.

os_version

float

Full operating system version: <Major version>.<Minor version>. For example, 14.4.

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.

os_version_major

integer

The OS major version. For example, 14.

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.

os_version_minor

integer

The OS minor version. For example, 4.

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.

os_version_bugfix

integer

The OS build number (bugfix version). For example, 1.

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.

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:

  • IE

  • IE_MOBILE

  • YANDEX_BROWSER

  • FIREFOX

  • MOBILE_FIREFOX

  • CHROME

  • CHROME_MOBILE

  • CHROMIUM

  • SAFARI

  • MOBILE_SAFARI

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.

user_agent_version_major

integer

Major version of the browser.

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.

user_agent_version_minor

integer

Minor version of the browser.

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.

user_agent_version_bugfix

integer

The browser's build number (bugfix 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.

rating

float

The user's rating. Calculated from earnings in all projects available to the users.

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.