Apify icon

Apify

Access Apify tools for web scraping, data extraction, and automation.

Actions11

Actor Run → Get runs

AI-generated

Overview

This node interacts with the Apify platform to retrieve runs of a specified Actor. It is useful for monitoring and managing the execution history of web scraping or automation tasks performed by Apify Actors. For example, users can fetch recent runs of an Actor to analyze their status, execution time, or results.

Use Case Examples

  1. Fetch the last 50 runs of a specific Actor to check their statuses and execution details.
  2. Retrieve runs filtered by status, such as only 'SUCCEEDED' runs, to analyze successful executions.

Properties

Name Meaning
Actor The ID or a tilde-separated username and Actor name to identify which Actor's runs to retrieve. It supports selection from a list, input by URL, or direct ID entry.
Offset Number of runs to skip from the start of the list, useful for pagination.
Limit Maximum number of runs to return, with a minimum of 1.
Desc Boolean flag to sort runs by their start time in descending order (newest first) or ascending order.
Status Filter runs by their status, such as ABORTED, RUNNING, SUCCEEDED, etc., to narrow down the results.
Authentication Choose the authentication method to use for accessing the Apify API, either API Key or OAuth2.

Output

JSON

  • id - Unique identifier of the Actor run.
  • status - Current status of the run (e.g., SUCCEEDED, FAILED).
  • startedAt - Timestamp when the run started.
  • finishedAt - Timestamp when the run finished.
  • metaData - Additional metadata related to the run.
  • stats - Statistics about the run, such as execution time and resource usage.

Dependencies

  • Apify API key or OAuth2 credentials for authentication

Troubleshooting

  • Ensure the Actor ID or URL is valid and accessible with the provided credentials.
  • Check that the authentication method selected matches the credentials configured.
  • If no runs are returned, verify the status filter and offset/limit parameters to ensure they match existing runs.

Links

Discussion