N8N Tools Snapchat icon

N8N Tools Snapchat

Interact with Snapchat API

Actions42

Overview

The node "N8N Tools Snapchat" integrates with the Snapchat Ads API, enabling users to manage and retrieve data related to Snapchat advertising resources. Specifically, for the Ads resource and the Get Ad Stats operation, this node fetches statistical performance data for a specified Snapchat ad within an ad account.

This functionality is beneficial for marketers and advertisers who want to programmatically monitor the effectiveness of their Snapchat ads, analyze campaign performance, or automate reporting workflows. For example, a user can set up an automated workflow that retrieves daily ad stats to track impressions, clicks, conversions, and other key metrics without manual intervention.

Properties

Name Meaning
Ad Account ID The unique identifier of the Snapchat Ad Account from which to fetch data. This is required.
Ad ID The unique identifier of the specific Snapchat Ad for which to get statistics.

Output

The output is a JSON object containing the ad statistics retrieved from the Snapchat Ads API for the specified Ad ID under the given Ad Account ID. The exact structure depends on the Snapchat API response but typically includes metrics such as impressions, spend, clicks, conversions, and other performance indicators relevant to the ad.

No binary data output is produced by this operation.

Example output (simplified):

{
  "impressions": 12345,
  "clicks": 678,
  "spend": 150.75,
  "conversions": 34,
  "dateRange": {
    "start": "2024-01-01",
    "end": "2024-01-31"
  }
}

Dependencies

  • Requires valid credentials for:
    • An API key credential to authenticate with the intermediary N8N Tools API service.
    • OAuth2 credentials for Snapchat API access.
  • The node internally validates the subscription and API key via the N8N Tools API before making Snapchat API calls.
  • Network connectivity to https://adsapi.snapchat.com is necessary.

Troubleshooting

  • Invalid subscription or API key error: If you receive an error indicating invalid subscription or API key, verify that your API key credential is correct and active.
  • Missing or incorrect Ad Account ID or Ad ID: Ensure these IDs are correctly provided; otherwise, the API call will fail or return no data.
  • API rate limits or permission errors: Snapchat API may enforce rate limits or require specific permissions; check your Snapchat developer account settings.
  • JSON parsing errors: When providing JSON input properties (not applicable for Get Ad Stats), ensure the JSON is well-formed.

Links and References

Discussion