find_app_items

toloka.client.TolokaClient.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

ParametersTypeDescription
app_project_idstr

The ID of the App project.

after_idOptional[str]

The ID of the item used for cursor pagination.

batch_idOptional[str]

The ID of the batch to look in.

statusOptional[AppItem.Status]

App task item status. Refer to the AppItem.Status page for more information on the available status values.

id_gtOptional[str]

Items with IDs greater than the specified value.

id_gteOptional[str]

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

id_ltOptional[str]

Items with IDs less than the specified value.

id_lteOptional[str]

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

created_gtOptional[datetime]

Items created after the specified date.

created_gteOptional[datetime]

Items created after or on the specified date.

created_ltOptional[datetime]

Items created before the specified date.

created_lteOptional[datetime]

Items created before or on the specified date.

finished_gtOptional[datetime]

Items labeled after the specified date.

finished_gteOptional[datetime]

Items labeled after or on the specified date.

finished_ltOptional[datetime]

Items labeled before the specified date.

finished_lteOptional[datetime]

Items labeled before or on the specified date.

sortUnion[List[str], AppItemSortItems, None]

Sorting options. Default: None.

limitOptional[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
OverviewGetting API keyQuick start
Recipes
Reference
toloka.client
toloka.async_client
toloka.autoquality [autoquality]
toloka.metrics
toloka.streaming