Apify icon

Apify

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

Actor Run → Get run

AI-generated

Overview

This node interacts with the Apify platform to retrieve details of a specific Actor Run. It is useful for users who want to fetch the status, output, or metadata of a particular run of an Apify actor, which is a task or job executed on the Apify platform. For example, a user can get the results of a web scraping job or automation task by specifying the run ID.

Use Case Examples

  1. Fetching the output of a web scraping actor run by providing the run ID.
  2. Checking the status and logs of a specific actor run to monitor its progress or troubleshoot issues.

Properties

Name Meaning
Run ID The unique identifier of the Actor Run to retrieve. It supports multiple input modes: selecting from a list of runs, providing the run URL, or directly entering the run ID.
Authentication Choose the authentication method to access the Apify API, either via an API key or OAuth2.

Output

JSON

  • runId - The unique identifier of the retrieved actor run.
  • status - The current status of the actor run (e.g., running, succeeded, failed).
  • startedAt - Timestamp when the actor run started.
  • finishedAt - Timestamp when the actor run finished, if applicable.
  • output - The output data produced by the actor run, if available.
  • metadata - Additional metadata related to the actor run, such as input parameters and execution details.

Dependencies

  • Apify API key or OAuth2 credentials for authentication

Troubleshooting

  • Ensure the provided Run ID is valid and exists on the Apify platform; invalid IDs will cause errors.
  • Check that the authentication credentials (API key or OAuth2 token) are correctly configured and have sufficient permissions.
  • If using the URL mode for Run ID, ensure the URL matches the expected pattern; otherwise, extraction will fail.
  • Network issues or Apify API downtime can cause request failures; retry or check service status.

Links

  • Apify Actor Runs API - Official documentation for the Apify Actor Runs API, detailing endpoints and data structures.

Discussion