Overview
This node integrates with the Pinterest API v5 to manage Pinterest boards and pins. Specifically, for the Board - Get operation, it retrieves detailed information about a single Pinterest board by its unique Board ID.
Common scenarios where this node is useful include:
- Fetching metadata of a specific Pinterest board to display or process in workflows.
- Integrating Pinterest board data into other applications or dashboards.
- Automating content management by retrieving board details before performing further actions.
For example, you might use this node to get the description, name, follower count, or other attributes of a Pinterest board identified by its Board ID.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authentication; currently supports only OAuth2 authentication. |
| Board ID | The unique identifier of the Pinterest board to retrieve information for (required). |
Output
The output is a JSON object representing the retrieved Pinterest board's details as returned by the Pinterest API v5. This typically includes fields such as:
id: The board's unique identifier.name: The name of the board.description: Description text of the board.- Other metadata like counts, privacy settings, URL, etc., depending on the API response.
The node does not output binary data for this operation.
Example output snippet (simplified):
{
"id": "1234567890",
"name": "My Favorite Recipes",
"description": "A collection of my favorite cooking recipes",
...
}
Dependencies
- Requires an OAuth2 authentication credential configured in n8n to access the Pinterest API.
- Makes HTTP requests to the Pinterest API v5 endpoints (
https://api.pinterest.com/v5/boards/{boardId}). - No additional external dependencies beyond the OAuth2 credential and internet connectivity.
Troubleshooting
- Invalid Board ID: If the provided Board ID is incorrect or does not exist, the API will return an error. Verify the Board ID is correct.
- Authentication Errors: Ensure the OAuth2 credentials are valid and have the necessary permissions to access the Pinterest API.
- Network Issues: Connectivity problems can cause request failures. Check your network connection.
- API Rate Limits: Pinterest API may limit the number of requests. If rate limited, wait and retry later.
Common error messages:
- Unauthorized or 401 errors indicate invalid or expired OAuth2 tokens.
- 404 Not Found indicates the board ID does not exist or is inaccessible.
- 400 Bad Request may indicate malformed input parameters.
Resolving these usually involves verifying credentials, checking input values, and ensuring API access rights.