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 "Get Board Analytics" operation in this Pinterest integration node retrieves detailed analytics data for a specified Pinterest board over a defined date range. This operation is useful for marketers, social media managers, and analysts who want to measure the performance of their Pinterest boards by tracking various engagement metrics such as impressions, clicks, saves, and more.
Typical use cases include:
- Monitoring how a board performs over time.
- Comparing engagement across different app types (mobile, desktop, tablet).
- Analyzing specific metric types like clicks or saves to optimize content strategy.
- Splitting analytics by fields such as app type or pin format to gain granular insights.
For example, a user might fetch analytics for a board from the last month to understand which pins are driving the most engagement and on which platforms.
Properties
| Name | Meaning |
|---|---|
| Board ID | The unique identifier of the Pinterest board for which analytics are requested. |
| Start Date | The start date (ISO 8601 format) for the analytics data range. |
| End Date | The end date (ISO 8601 format) for the analytics data range. |
| Metric Types | Types of metrics to include in the analytics. Options: Impression, Clickthrough, Click, Save, Hide, Comment, Like, Reaction, Engagement. Default includes Impression, Click, and Save. |
| App Types | Types of apps to include in the analytics. Options: All, Mobile, Desktop, Tablet. Default is All. |
| Split Field | Field by which to split the analytics data. Options: No Split, App Type, Owned Content, Pin Format. Default is No Split. |
| Ad Account ID | Optional advertising account ID to filter analytics related to ads. |
| Include Private Metrics | Boolean flag to include private metrics, requires elevated access. |
| Custom Fields | Comma-separated list of custom fields to include in the analytics response. |
Output
The output JSON contains the analytics data for the specified board according to the selected parameters. It typically includes aggregated metrics such as impressions, clicks, saves, and other engagement statistics over the specified date range. If splitting is enabled, the data will be segmented accordingly (e.g., by app type).
The exact structure depends on the API response but generally includes:
- Metric values keyed by metric type.
- Time series data within the date range.
- Breakdown by split field if specified.
- Possibly additional metadata about the board or metrics.
This node does not output binary data for this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external "N8N Tools API" service that proxies Pinterest API calls.
- Requires OAuth2 credentials for Pinterest API access.
- The node uses internal helper classes to interact with Pinterest's API endpoints via the N8N Tools API.
- Proper configuration of these credentials in n8n is necessary for successful execution.
Troubleshooting
- Invalid subscription or API key error: If you receive errors indicating invalid subscription or API key, verify that your API key credential is correct and active.
- Permission errors when including private metrics: Including private metrics requires elevated access; ensure your Pinterest account has the necessary permissions.
- Date range issues: Ensure that the start and end dates are valid ISO 8601 strings and that the start date is before the end date.
- Empty or incomplete data: Check that the board ID is correct and that there is available analytics data for the specified period.
- API rate limits: Frequent requests may hit rate limits; consider adding delays or handling retries.