find_app_items

toloka.async_client.client.AsyncTolokaClient.find_app_items | Source code

Finds task items that match certain criteria in an App project.

The number of returned items is limited. To find remaining items call find_app_items with updated search criteria.

To iterate over all matching items you may use the get_app_items method.

Parameters description

Parameters	Type	Description
`app_project_id`	str	The ID of the App project.
`after_id`	Optional[str]	The ID of the item used for cursor pagination.
`batch_id`	Optional[str]	The ID of the batch to look in.
`status`	Optional[AppItem.Status]	App task item status. Refer to the AppItem.Status page for more information on the available `status` values.
`id_gt`	Optional[str]	Items with IDs greater than the specified value.
`id_gte`	Optional[str]	Items with IDs greater than or equal to the specified value.
`id_lt`	Optional[str]	Items with IDs less than the specified value.
`id_lte`	Optional[str]	Items with IDs less than or equal to the specified value.
`created_gt`	Optional[datetime]	Items created after the specified date.
`created_gte`	Optional[datetime]	Items created after or on the specified date.
`created_lt`	Optional[datetime]	Items created before the specified date.
`created_lte`	Optional[datetime]	Items created before or on the specified date.
`finished_gt`	Optional[datetime]	Items labeled after the specified date.
`finished_gte`	Optional[datetime]	Items labeled after or on the specified date.
`finished_lt`	Optional[datetime]	Items labeled before the specified date.
`finished_lte`	Optional[datetime]	Items labeled before or on the specified date.
`sort`	Union[List[str], AppItemSortItems, None]	Sorting options. Default: `None`.
`limit`	Optional[int]	Returned items limit. The maximum allowed value: 1000.

Returns:

Found task items and a flag showing whether there are more matching items exceeding the limit.
Return type:

AppItemSearchResult

Examples:

Finding items in an App project that were created starting some date.

search = toloka_client.find_app_items(
    app_project_id='Q2d15QBjpwWuDz8Z321g',
    created_gte='2022-06-16',
    sort='created')
for app_item in search.content:
    print(app_item.id, app_item.created_at)
if search.has_more:
    print('...')

Last updated: August 28, 2023

Toloka-Kit

Overview Getting API key Quick start

Recipes

Reference

toloka.client

toloka.async_client

toloka.autoquality [autoquality]

toloka.metrics

toloka.streaming