HeyReach API icon

HeyReach API

Interact with HeyReach API

Overview

The "Get Overall" operation under the "Stat" resource in this node retrieves aggregated statistical data from the HeyReach API. It allows users to filter overall statistics by specific LinkedIn sender account IDs and campaign IDs, as well as by date ranges. This operation is useful for analyzing performance metrics across multiple campaigns or accounts, helping marketers and sales teams understand engagement trends and optimize their outreach strategies.

Practical examples include:

  • Fetching overall stats for selected LinkedIn accounts to evaluate their outreach effectiveness.
  • Comparing campaign performances over a specified time period.
  • Generating reports that summarize key metrics for all campaigns within a date range.

Properties

Name Meaning
Account IDs Array of LinkedIn sender account IDs to filter the statistics by. If empty, includes all senders.
Campaign IDs Array of campaign IDs to filter the statistics by. If empty, includes all campaigns.
Start Date (Optional) ISO 8601 UTC start date to filter statistics from this date onwards.
End Date (Optional) ISO 8601 UTC end date to filter statistics up to this date.

Output

The output JSON contains the aggregated overall statistics data retrieved from the HeyReach API based on the provided filters. The exact structure depends on the API response but typically includes metrics such as total messages sent, responses received, connection rates, and other engagement indicators.

If the node supports binary data output, it would represent any associated files or media related to the statistics, but this operation primarily returns JSON data summarizing stats.

Dependencies

  • Requires an active API key credential for authenticating with the HeyReach API.
  • The node makes HTTP requests to https://api.heyreach.io/api/n8n.
  • Proper configuration of the API credential in n8n is necessary for successful execution.

Troubleshooting

  • Empty Results: If no data is returned, verify that the provided Account IDs and Campaign IDs exist and have associated data. Also, check the date filters to ensure they cover periods with activity.
  • Authentication Errors: Ensure the API key credential is correctly set up and has sufficient permissions.
  • Invalid Date Format: Dates must be in ISO 8601 UTC format; otherwise, the API may reject the request.
  • API Rate Limits: Excessive requests might lead to rate limiting; consider adding delays or reducing request frequency.

Links and References

Discussion