Apify icon

Apify

Apify API

Overview

This node interacts with the Apify API to retrieve the last run information of a specified Actor. It is useful for monitoring the most recent execution status of an Actor, which can help in automation workflows where you need to check the outcome or status of the last run before proceeding with further actions. For example, it can be used to trigger notifications or subsequent processes based on whether the last run succeeded or failed.

Use Case Examples

  1. Retrieve the last successful run of a web scraping Actor to verify data extraction before processing the data further.
  2. Check the last run status of an automation Actor to decide if a retry or alert is necessary.

Properties

Name Meaning
Actor ID The identifier of the Actor whose last run information is to be retrieved. It can be provided as an Actor ID, a tilde-separated owner's username and Actor name, or a URL pointing to the Actor.
Status Filter the runs by their status, e.g., SUCCEEDED, to get the last run with that specific status.
Use Custom Body Option to specify whether to use a custom request body when making the API call.

Output

JSON

  • lastRun
    • id - The unique identifier of the last run of the Actor.
    • status - The status of the last run (e.g., SUCCEEDED, FAILED).
    • startedAt - Timestamp when the last run started.
    • finishedAt - Timestamp when the last run finished.
    • details - Additional details or metadata about the last run.

Dependencies

  • Apify API

Troubleshooting

  • Ensure the Actor ID or URL is correctly formatted and valid; invalid IDs or URLs will cause errors.
  • Check that the API credentials for Apify are correctly configured and have the necessary permissions to access Actor run data.
  • If filtering by status, ensure the status value is valid and supported by the Apify API.
  • Network issues or API rate limits may cause request failures; verify connectivity and API usage limits.

Links

Discussion