Actions42
- Ads Actions
- Campaigns Actions
- Creatives Actions
- Audiences Actions
- Pixels Actions
- Webhooks Actions
- Reports Actions
Overview
The "Download Report" operation of the Reports resource in this node allows users to download a specific report from Snapchat Ads API by providing the Ad Account ID and the Report ID. This is useful for retrieving detailed advertising performance data or analytics reports generated within Snapchat's advertising platform.
Common scenarios include:
- Automating the retrieval of campaign performance reports for further analysis.
- Integrating Snapchat ad reporting into broader marketing dashboards or workflows.
- Archiving historical ad performance data for compliance or auditing purposes.
For example, a user might schedule this node to run daily to download the latest report on ad spend and conversions, then feed that data into a BI tool.
Properties
| Name | Meaning |
|---|---|
| Ad Account ID | The unique identifier of the Snapchat Ad Account from which the report will be downloaded. This is required to specify the scope of the request. |
| Report ID | The unique identifier of the specific Snapchat report to download. |
Output
The output JSON contains the data returned by the Snapchat API for the requested report download. This typically includes the report content such as metrics, dimensions, and other relevant data fields defined by the report.
If the report includes binary data (e.g., file contents), it would be represented accordingly, but based on the code, the output is returned as JSON.
Each item in the output array corresponds to one input item processed, paired by index.
Dependencies
- Requires an active subscription and valid API key credential for the external "N8N Tools API" service, which acts as a proxy or validation layer before calling Snapchat APIs.
- Requires OAuth2 credentials configured for Snapchat API access.
- The node uses the base URL
https://adsapi.snapchat.comfor Snapchat API requests. - Proper permissions on the Snapchat Ad Account to access reports.
Troubleshooting
- Invalid subscription or API key error: If you receive an error about invalid subscription or API key, verify that your API key credential for the external validation service is correct and active.
- Missing or incorrect Ad Account ID or Report ID: Ensure these IDs are correctly provided; otherwise, the Snapchat API will reject the request.
- Permission errors from Snapchat API: Confirm that the OAuth2 credentials have sufficient permissions to access the specified report.
- Unknown operation error: This node only supports predefined operations; ensure "downloadReport" is selected under the Reports resource.
- Network or timeout issues: Check network connectivity and Snapchat API status if requests fail unexpectedly.