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

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