Overview
This node integrates with the Pinterest API v5 to manage Pinterest boards and pins. Specifically, the "Pin" resource with the "Get Many (by Board)" operation allows users to list multiple pins from a specified Pinterest board. This is useful for scenarios where you want to retrieve all or a subset of pins from a particular board for further processing, analysis, or automation workflows.
Practical examples include:
- Aggregating pins from a marketing board to analyze popular content.
- Exporting pin data for reporting or backup purposes.
- Triggering downstream actions based on pins added to a specific board.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with Pinterest API; currently supports OAuth2 only. |
| Board ID | The unique identifier of the Pinterest board from which to retrieve pins. |
| Return All | Boolean flag indicating whether to return all pins from the board or limit the results. |
| Limit | Maximum number of pins to return if "Return All" is false. Minimum value is 1. |
Output
The output consists of an array of JSON objects, each representing a single pin retrieved from the specified board. Each JSON object contains the pin's details as returned by the Pinterest API, such as pin ID, title, description, link, media source information, and other metadata.
No binary data output is produced by this operation.
Dependencies
- Requires an OAuth2 authentication credential configured in n8n to access the Pinterest API.
- The node makes HTTP requests to the Pinterest API endpoints under
https://api.pinterest.com/v5/. - Proper API permissions/scopes must be granted to the OAuth2 token to read board pins.
Troubleshooting
- Missing or invalid Board ID: Ensure the Board ID provided exists and is accessible with the authenticated account.
- Authentication errors: Verify that the OAuth2 credentials are correctly set up and have not expired.
- API rate limits: Pinterest API may throttle requests; consider enabling "Return All" cautiously or use reasonable limits.
- Empty results: If no pins are returned, confirm the board actually contains pins and the user has permission to view them.
- Binary property errors: Not applicable for this operation but relevant for pin creation with binary images.