Filter by profile data

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

Sample filter in JSON

This example selects Tolokers who set their country as US in their profile and agreed to complete tasks which contain adult content.

{
"filter": {
"and": [
{
"or": [
{
"category": "profile",
"key": "country",
"operator": "EQ",
"value": "US"
}
]
},
{
"or": [
{
"category": "profile",
"key": "adult_allowed",
"value": true,
"operator": "EQ"
}
]
}
]
}
}

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.
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 specified as a UNIX timestamp.

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

Last updated: August 24, 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