Filter by profile data

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

Sample filter in JSON

This example selects users 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" keys

Value of "key"

Value of "value"

Data type in "value"

Value of "operator"

gender

The user's gender:

  • “MALE”

  • “FEMALE”

String

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

country

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

String

citizenship

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

String

education

The user's level of education:

  • “BASIC” — Secondary school (high school).

  • “MIDDLE” — Specialized secondary (vocational).

  • “HIGH” — Post-secondary (university).

String

adult_allowed

The user agrees to perform tasks that contain adult content.

Boolean

date_of_birth

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

Number

  • 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

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

Number

  • 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

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

Number