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 US and the city as Washington, D.C. in the profile.

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

Key and value parameters

Key parameterValue 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.

See also

Contact support
Toloka API
OverviewAccessing the APIRate limiting
Quick start
Reference
Project
Pools
Training
Subscriptions to events
Toloker selection
Ways to upload tasks
Tasks
Task suites
Tracking operations
Getting responses
Checking completed tasks
Rewards
Messages for Tolokers
Various parameters
Libraries