N8N Tools - Pinterest EnhancedInstall

Overview

This node provides integration with the Pinterest API v5 through a comprehensive set of operations grouped by resource categories such as Pins, Boards, Users, Shopping & Catalogs, Advertising & Campaigns, Advanced Analytics, Engagement Features, Business Tools, and Search & Discovery.

Specifically for the Advanced Analytics resource and the Get Report Status operation, the node allows users to check the status of an asynchronously generated analytics report associated with an advertising account. This is useful in scenarios where reports take time to generate, and you want to programmatically poll or verify the readiness of a report before downloading or further processing it.

Practical example:
A marketing analyst automates their workflow to generate detailed campaign performance reports on Pinterest. After triggering report generation, they use this node operation to periodically check if the report is ready, enabling automated retrieval and analysis once available.

Properties

Note: Although the bundled code shows that the operation also requires an Ad Account ID, it is not listed in the provided properties JSON. However, the code uses it internally to identify the advertising account context for the report.

Output

The output of the Get Report Status operation is a JSON object representing the current status of the requested asynchronous report. This typically includes fields such as:

• Report state (e.g., pending, completed, failed)
• Progress or completion percentage
• Any error messages if the report generation failed
• Metadata about the report like creation time or parameters used

The exact structure depends on the Pinterest API response but generally provides all necessary information to determine if the report is ready for download or if there was an issue.

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 or middleware for Pinterest API calls.
• Requires Pinterest OAuth2 credentials configured in n8n for authentication with Pinterest's API.
• The node internally uses multiple helper classes corresponding to different Pinterest API areas; for this operation, it uses the Advanced Analytics API helper.
• The node sends a validation request to the N8N Tools API before executing any operation to verify subscription and API key validity.

Troubleshooting

• Invalid subscription or API key error:
  If the node throws an error indicating invalid subscription or API key, verify that your API key credential for the N8N Tools API is correct and active.

• Missing or incorrect Report ID:
  Ensure the Report ID parameter is correctly provided and corresponds to a report previously generated.

• Missing Ad Account ID:
  Although not explicitly shown in the input properties, the operation requires an Ad Account ID. Make sure to provide this parameter when configuring the node, as omitting it may cause errors.

• API rate limits or network issues:
  Network failures or hitting API rate limits can cause errors. Implement retry logic or handle failures gracefully using the node’s "Continue On Fail" option.

• Report not ready yet:
  The report status might indicate that the report is still being generated. In this case, implement polling with delays between requests.

Links and References

• Pinterest API v5 Documentation - Analytics
• Pinterest Asynchronous Reporting Guide
• N8N Documentation - Creating Custom Nodes

If you need details on other operations or resources, feel free to ask!