Overview

This node interacts with the Apify platform to retrieve a list of user runs for an actor. It is useful for scenarios where you want to monitor or analyze the execution history of actors, such as checking the status of recent runs, filtering runs by status, or paginating through run records. For example, you could use this node to fetch the last 50 successful runs of a specific actor to analyze their performance or troubleshoot issues.

Use Case Examples

1. Fetch the last 50 successful runs of an actor sorted by start time in descending order.
2. Retrieve runs with a specific status like FAILED or TIMED-OUT to identify problematic executions.
3. Paginate through runs by setting the offset and limit to process large sets of run data incrementally.

Properties

Output

JSON

• runs - Array of run objects matching the query parameters, each containing details about an individual actor run.

Dependencies

• Requires authentication via Apify API key or OAuth2 token to access the Apify platform.

Troubleshooting

• Ensure valid authentication credentials are provided; otherwise, API requests will fail with authorization errors.
• Check that the 'limit' parameter is within allowed bounds to avoid request errors.
• If no runs are returned, verify the status filter and offset values to ensure they match existing runs.

Links

• Apify Actor Run Statuses - Documentation on the lifecycle and statuses of actor runs on Apify.