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 Pins from Board" operation in this Pinterest Enhanced node retrieves a list of pins from a specified Pinterest board. This is useful for workflows that need to analyze, display, or process the pins contained within a particular board on Pinterest.
Common scenarios include:
- Aggregating pins from a board to create reports or analytics.
- Syncing pins from a Pinterest board into another system or database.
- Automating content curation by fetching pins from specific boards.
- Monitoring new pins added to a board for marketing or social media management.
For example, a user might use this node to fetch the latest 50 pins from their "Travel Inspiration" board to automatically post them on a website or newsletter.
Properties
| Name | Meaning |
|---|---|
| Board ID | The unique identifier of the Pinterest board from which to retrieve pins. |
| Page Size | Number of pins to return per page (minimum 1, maximum 250). |
| Cursor | Pagination cursor to fetch the next set of results; used for paginated requests. |
| Include Private Metrics | Boolean flag to include private metrics data in the response (requires elevated access). |
| Custom Fields | Comma-separated list of additional custom fields to include in the response. |
Output
The output is an array of JSON objects representing the pins retrieved from the specified board. Each pin object contains standard Pinterest pin data such as id, title, description, link, media information, and optionally metrics if requested.
If pagination is used, the response may include a cursor for fetching subsequent pages.
This node does not output binary data.
Dependencies
- Requires an active subscription and valid API key credential for the external N8N Tools API service.
- Requires OAuth2 authentication credentials for Pinterest API access.
- The node internally uses the Pinterest API v5 via helper classes bundled with the node.
- No additional environment variables are required beyond configured credentials.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error about invalid subscription or API key, verify that your API key credential is correct and active.
- Permission Errors: Including private metrics requires elevated access; ensure your Pinterest account and API credentials have the necessary permissions.
- Pagination Issues: If using the cursor property, ensure it is correctly passed from previous responses to paginate through results.
- Empty Results: Verify the Board ID is correct and that the board contains pins.
- API Rate Limits: Frequent calls may hit rate limits; consider adding delays or handling errors gracefully.