AppStore Analytics icon

AppStore Analytics

Download Apple App Store analytics reports
Join our community

Actions2

Overview

This node allows users to download Apple App Store analytics reports via the App Store Connect API. It supports fetching detailed app usage data such as installations and deletions, filtered by report name, category, date, granularity (daily or monthly), and access type (one-time snapshot or ongoing). The node can either download the raw CSV report file or parse it into structured JSON for easier consumption in workflows.

Common scenarios include:

  • Automating retrieval of app performance metrics for reporting or analysis.
  • Integrating App Store analytics data into dashboards or databases.
  • Triggering workflows based on app usage trends or anomalies.

For example, a user might configure this node to download the "App Store Installation and Deletion Standard" report for a specific app on a given date with monthly granularity, then parse the data to trigger alerts if installation numbers drop below a threshold.

Properties

Name Meaning
Granularity The time granularity of the report data. Options: Daily, Monthly.
Access Type The type of report access. Options: One Time Snapshot, Ongoing.
App ID The unique identifier of the app for which to fetch the report.
Report Name The exact name of the report to download (e.g., "App Store Installation and Deletion Standard").
Report Date The date of the report to retrieve, formatted as YYYY-MM-DD.
Report Category The category of the report, e.g., APP_USAGE.
Options Additional options:
   Put Result in Field The name of the output field where the parsed report data will be stored (default: report).

Output

The node outputs an array of items corresponding to each input item processed.

  • If the operation is Download (download_report):

    • The output contains a binary field named report holding the raw CSV report file downloaded from Apple.
    • The JSON part of the output is empty.

  • If the operation is Download & Parse (parse_report):

    • The output JSON contains a field (default name report, configurable) with an array of objects.
    • Each object represents one row of the CSV report, with keys derived from the CSV headers and values from the corresponding columns.
    • This structured JSON makes it easy to use the report data directly in subsequent workflow steps.

Dependencies

  • Requires an API key credential for Apple App Store Connect API authentication.
  • Uses JWT token generation to authenticate requests.
  • Makes HTTP GET requests to the App Store Connect API endpoints.
  • Uses Node.js built-in modules for URL handling and gzip decompression.
  • Requires n8n environment configured with the appropriate credentials.

Troubleshooting

  • No report found for this AppId: Indicates no analytics report requests exist for the specified app ID. Verify the app ID is correct and that reports are available.
  • Report Name ... for ... not found: The requested report name or date does not match any available reports. Check spelling, date format, and report availability.
  • Instance not found / Segment not found: The report instance or segment matching the filters was not found. Confirm granularity, access type, and other filter parameters.
  • Authentication errors: Ensure the API key credential is valid and has proper permissions.
  • Network or API errors: Check network connectivity and Apple API status.

To resolve errors, verify all input parameters carefully, ensure the API credentials are correctly set up, and confirm that the requested reports exist in App Store Connect.

Links and References

Discussion