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 a comprehensive integration with the Pinterest API v5, enabling advanced interactions with Pinterest's platform through various resources such as Pins, Boards, Users, Shopping Catalogs, Advertising Campaigns, Advanced Analytics, Engagement Features, Business Tools, and Search & Discovery.
Specifically for the Advanced Analytics resource with the Download Report operation, the node allows users to download asynchronous analytics reports generated on Pinterest advertising accounts. This is useful for marketers and analysts who want to programmatically retrieve detailed performance data of their campaigns or other analytics reports without manual intervention.
Practical examples include:
- Automatically downloading campaign performance reports for further processing or visualization.
- Integrating Pinterest analytics data into custom dashboards or BI tools.
- Scheduling regular downloads of reports to monitor marketing effectiveness over time.
Properties
| Name | Meaning |
|---|---|
| Report ID | The unique identifier of the report to be downloaded. Required for the Download Report operation. |
Output
The node outputs an array of JSON objects, each representing the response from the Pinterest API for the requested operation.
For the Download Report operation under the Advanced Analytics resource, the output JSON contains the status and data of the asynchronous report download request. It typically includes metadata about the report and the actual report content or a link to it, depending on the API response.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for the "N8N Tools API" service to validate subscription and access.
- Uses Pinterest API v5 endpoints via helper classes bundled in the node implementation.
- Requires proper authentication credentials configured in n8n for Pinterest API access.
- The node sends a validation request to the external N8N Tools API before executing operations.
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 is correctly set up and active.
- Report not found or invalid Report ID: Ensure the provided Report ID exists and is correct; otherwise, the API will fail to return the report.
- Permission errors: Some analytics data or reports may require elevated access permissions; ensure the authenticated Pinterest account has the necessary rights.
- Network or API downtime: Temporary failures contacting the Pinterest API or the N8N Tools API can cause errors; retry after some time or check network connectivity.