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
The node provides enhanced integration with the Pinterest API v5 through a comprehensive set of operations grouped by resource types such as Pins, Boards, Users, Shopping Catalogs, Advertising Campaigns, Analytics, Engagement Features, Business Tools, and Search & Discovery.
Specifically for the Pins resource and the Get Pin Reactions operation, this node retrieves the reactions (such as likes, loves, wow, haha, sad, angry) associated with a specified Pin on Pinterest. This is useful for social media managers or marketers who want to analyze user engagement on their pins by understanding how users are reacting to their content.
Practical example:
A marketing team can use this node in an automated workflow to fetch reactions on newly posted pins to monitor audience sentiment and engagement, enabling timely responses or adjustments to their content strategy.
Properties
| Name | Meaning |
|---|---|
| Include Private Metrics | Boolean flag to include private metrics in the response; requires elevated access. |
| Custom Fields | Comma-separated list of custom fields to include in the response for extended data. |
These properties apply generally to Pins, Boards, and Users resources and allow customization of the data returned by the API.
For the Get Pin Reactions operation specifically, the only required input property is:
| Name | Meaning |
|---|---|
| Pin ID | The unique identifier of the Pin whose reactions are to be retrieved. |
(Note: The Pin ID property is implied from the code usage but not explicitly listed in the provided properties snippet.)
Output
The output is an array of JSON objects where each object corresponds to the result of the executed operation per input item.
For the Get Pin Reactions operation, the json field contains the detailed reactions data fetched from Pinterest for the specified Pin. This typically includes reaction types and counts or lists of users who reacted.
No binary data output is indicated for this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external "N8N Tools API" service that acts as a proxy/validation layer for Pinterest API calls.
- Requires OAuth2 credentials for Pinterest API access.
- The node internally uses multiple API wrapper classes for different Pinterest API domains, including one for engagement features which handles pin reactions.
- No additional environment variables are explicitly required beyond standard n8n credential configuration.
Troubleshooting
Invalid Subscription or API Key:
If the node throws an error indicating invalid subscription or API key, verify that the API key credential is correctly configured and active in n8n.Permission Errors:
Including private metrics requires elevated access. If permission errors occur when settingInclude Private Metricsto true, ensure the connected Pinterest account has the necessary permissions.Missing or Incorrect Pin ID:
Ensure the Pin ID parameter is provided and correct; otherwise, the API call will fail.API Rate Limits or Network Issues:
As with any API integration, rate limits or network connectivity problems may cause failures. Implement retry logic or error handling in workflows as needed.
Links and References
- Pinterest API v5 Documentation
- N8N Official Documentation
- Pinterest Engagement Features API Reference
This summary focuses on the "Pins" resource and the "Get Pin Reactions" operation as requested, based solely on static analysis of the provided source code and property definitions.