Toloka documentation

Filter by profile data

To select Tolokers based on profile data, define a filter object in the pool parameters.

Sample filter in JSON

This example selects Tolokers who set their country as Russia and the city as Moscow in the profile.

{
  "filter" : {
    "and" : [ {
      "or" : [ {
        "category" : "profile",
        "key" : "country",
        "operator" : "EQ",
        "value" : "RU"
      } ]
    }, {
      "or" : [ {
        "category" : "profile",
        "key" : "city",
        "value" : 213,
        "operator" : "IN"
      } ]
    } ]
  }
}

Key and value parameters

Key parameter

Value description

gender

string

The Toloker's gender:

  • "MALE" — Male.
  • "FEMALE" — Female.

Value of "operator":

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

country

string

The Toloker's country of residence (the two-letter code from the ISO 3166-1 alpha-2 standard).

Value of "operator":

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

citizenship

string

The Toloker's country of citizenship (the two-letter code from the ISO 3166-1 alpha-2 standard).

Value of "operator":

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

education

string

The Toloker's level of education:

  • "BASIC" — Secondary education (high school).
  • "MIDDLE" — Specialized secondary education (vocational school).
  • "HIGH" — Post-secondary education (university).

Value of "operator":

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

adult_allowed

boolean

The Toloker agrees to perform tasks that contain adult content.

Value of "operator":

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

date_of_birth

integer

The Toloker's date of birth (UNIX time in seconds).

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.

city

integer

The Toloker's city (the region ID in the search database).

Value of "operator":

  • IN — Contained in the list of regions or languages in the profile.
  • NOT_IN — Not contained in the list of regions or languages in the profile.

languages

string

The languages the Toloker entered in the profile (uppercase two-letter ISO code conforming to ISO 639-1).

Value of "operator":

  • IN — Contained in the list of regions or languages in the profile.
  • NOT_IN — Not contained in the list of regions or languages in the profile.
In this article: