Overview

This node interacts with the Apify API to retrieve a list of actor tasks. It is useful for scenarios where you need to fetch and manage tasks related to Apify actors, such as monitoring task statuses, analyzing task execution history, or integrating task data into workflows. For example, you can use it to get a paginated list of tasks with options to control the number of tasks returned, skip a certain number of tasks, and sort tasks by creation date in ascending or descending order.

Use Case Examples

1. Fetching the first 100 actor tasks sorted by creation date descending.
2. Retrieving tasks starting from the 50th record with a limit of 200 tasks.
3. Getting tasks sorted in ascending order by creation date.

Properties

Name	Meaning
Offset	Number of records to skip at the start of the list, useful for pagination.
Limit	Maximum number of records to return, with a default and maximum of 1000, controlling the size of the result set.
Desc	Boolean flag to sort tasks by creation date in descending order if true; ascending order if false.
Use Custom Body	Flag to indicate whether to use a custom request body instead of default query parameters.

Output

JSON

• tasks - Array of actor task objects returned by the Apify API.
• total - Total number of tasks available matching the query.

Dependencies

• Requires Apify API access with an API key credential.

Troubleshooting

• Ensure the Apify API credential is correctly configured and has necessary permissions.
• Check that the 'limit' parameter does not exceed the maximum allowed value (1000).
• Verify that the 'offset' parameter is a non-negative integer.
• If using custom body, ensure the body format matches the API requirements to avoid request errors.

Links

• Apify Actor Tasks API Documentation - Official documentation for the Apify actor tasks endpoint, detailing available parameters and response structure.