Actions87
- Users Actions
- Shopping & Catalogs Actions
- Advertising & Campaigns Actions
- Advanced Analytics Actions
- Engagement Features Actions
- Business Tools Actions
- Search & Discovery Actions
- Pins Actions
- Boards Actions
Overview
This node provides enhanced integration with the Pinterest API v5 through the "N8N Tools - Pinterest Enhanced" package. Specifically, for the Advanced Analytics resource and the Get Campaigns Analytics operation, it retrieves detailed analytics data about advertising campaigns on Pinterest.
Use cases include:
- Monitoring performance metrics of Pinterest ad campaigns over a specified date range.
- Analyzing campaign effectiveness to optimize marketing strategies.
- Automating reporting workflows that require campaign analytics data from Pinterest.
For example, a marketer can use this node to fetch daily campaign analytics for a specific advertising account to track impressions, clicks, and other engagement metrics automatically within an n8n workflow.
Properties
| Name | Meaning |
|---|---|
| Campaign ID | The unique identifier of the Pinterest advertising campaign to retrieve analytics for. |
| Ad Account ID | The advertising account ID associated with the campaign (required for this operation). |
| Start Date | The start date (ISO 8601 format) for the analytics data range to retrieve. |
| End Date | The end date (ISO 8601 format) for the analytics data range to retrieve. |
Note: Although only "Campaign ID" was provided in the user input properties, the code shows that adAccountId, startDate, and endDate parameters are also required or used for this operation.
Output
The node outputs JSON data containing the campaign analytics retrieved from Pinterest via the advanced analytics API. The structure typically includes metrics aggregated by day (granularity: "DAY") such as impressions, clicks, saves, and other relevant campaign performance indicators.
The output is an array of objects where each object corresponds to the analytics data for the requested campaign within the specified date range.
No binary data output is involved in this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external "N8N Tools API" service, which acts as a proxy/enhancement layer for Pinterest API v5.
- Requires OAuth2 credentials for Pinterest API access.
- The node internally uses several API wrapper classes, including
AdvancedAnalyticsApifor analytics operations. - Proper configuration of these credentials in n8n is necessary before using the node.
Troubleshooting
- Invalid subscription or API key error: If the node throws an error indicating invalid subscription or API key, verify that the API key credential for the N8N Tools API is correctly configured and active.
- Missing or incorrect parameters: Ensure that the required parameters (
campaignId,adAccountId,startDate,endDate) are provided and correctly formatted. - API rate limits or permission errors: These may occur if the Pinterest API credentials lack sufficient permissions or if usage exceeds allowed quotas.
- Network or connectivity issues: Confirm that n8n has internet access and can reach the external APIs.
Links and References
- Pinterest API v5 Documentation
- N8N Official Documentation
- N8N Tools API Service (generic reference) (for subscription and API key management)
This summary focuses on the "Advanced Analytics" resource and the "Get Campaigns Analytics" operation as requested, based on static analysis of the provided source code and property definitions.