find_user_skills

toloka.client.TolokaClient.find_user_skills | Source code

Finds Toloker's skills that match certain criteria.

The number of returned Toloker's skills is limited. To find remaining skills call find_user_skills with updated search criteria.

To iterate over all matching skills you may use the get_user_skills method.

Parameters description

ParametersTypeDescription
user_idOptional[str]

The ID of a Toloker.

skill_idOptional[str]

The ID of a skill.

id_ltOptional[str]

Skills with IDs less than the specified value.

id_lteOptional[str]

Skills with IDs less than or equal to the specified value.

id_gtOptional[str]

Skills with IDs greater than the specified value.

id_gteOptional[str]

Skills with IDs greater than or equal to the specified value.

created_ltOptional[datetime]

Skills created before the specified date.

created_lteOptional[datetime]

Skills created before or on the specified date.

created_gtOptional[datetime]

Skills created after the specified date.

created_gteOptional[datetime]

Skills created on or after the specified date.

modified_ltOptional[datetime]

Skills that changed before the specified date.

modified_lteOptional[datetime]

Skills that changed before the specified date.

modified_gtOptional[datetime]

Skills changed after the specified date.

modified_gteOptional[datetime]

Skills created on or after the specified date.

sortUnion[List[str], UserSkillSortItems, None]

Sorting options. Default: None.

limitOptional[int]

Returned skills limit. The maximum allowed value: 1000.

  • Returns:

    Found Toloker's skills and a flag showing whether there are more matching skills exceeding the limit.

  • Return type:

    UserSkillSearchResult

Examples:

Getting a list of skills that a Toloker has.

find_result = toloka_client.find_user_skills(user_id='fac97860c7929add8048ed2ef63b66fd')
skills = find_result.items

Getting a list of Tolokers who have a certain skill.

find_result = toloka_client.find_user_skills(skill_id='11294')
skills = find_result.items

If there are skills exceeding the limit, then find_result.has_more is set to True.

Last updated: August 28, 2023

Toloka-Kit
OverviewGetting API keyQuick start
Recipes
Reference
toloka.client
toloka.async_client
toloka.autoquality [autoquality]
toloka.metrics
toloka.streaming