Overview
This node integrates with the Pinterest API v5 to manage Pinterest Pins. Specifically, the Get Pin operation retrieves detailed information about a single pin by its unique ID. This is useful when you want to fetch metadata or details of a specific pin for further processing, analysis, or display in your workflows.
Common scenarios include:
- Fetching pin details to enrich data records.
- Verifying pin existence or status before performing other operations.
- Integrating Pinterest content into marketing automation or reporting pipelines.
Example: You have a list of pin IDs from an external source and want to retrieve their full details (title, description, link, image info) to store or use elsewhere.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with Pinterest API. Only option available is OAuth2. |
| Pin ID | The unique identifier of the pin to retrieve. Required for the Get and Delete operations. |
Output
The output is a JSON object representing the pin's data as returned by the Pinterest API. It includes all standard pin fields such as:
id: The pin's unique identifier.board_id: The board to which the pin belongs.title: The title of the pin.description: Description text of the pin.link: Destination URL linked to the pin.media_source: Information about the image source (URL, base64 data, etc.).- Other metadata fields provided by Pinterest.
No binary data output is produced by this operation.
Dependencies
- Requires an OAuth2 authentication credential configured in n8n to access the Pinterest API.
- Uses the Pinterest API v5 endpoints.
- Network connectivity to
https://api.pinterest.comis required.
Troubleshooting
- Missing or invalid Pin ID: The node requires a valid pin ID string. Ensure the Pin ID property is set and corresponds to an existing pin.
- Authentication errors: If the OAuth2 token is expired or invalid, requests will fail. Re-authenticate or refresh the token.
- API rate limits: Pinterest API may limit request rates; handle errors accordingly.
- Network issues: Connectivity problems to Pinterest API endpoints will cause failures.
- Pin not found: If the specified pin ID does not exist or is inaccessible, the API returns an error.