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 node provides enhanced integration with the Pinterest API v5, enabling users to perform a wide range of Pinterest-related operations within n8n workflows. Specifically for the Search & Discovery resource and the Search Pins operation, it allows users to search for Pinterest pins based on a text query and optional category filters.
This functionality is useful in scenarios such as:
- Automating content discovery by searching for pins related to specific topics or keywords.
- Curating Pinterest content dynamically for marketing or social media management.
- Integrating Pinterest search results into other applications or data pipelines.
For example, a user could set up a workflow that searches for pins about "vegan recipes" in the "Food and Drink" category, then processes or stores the results for further analysis or posting.
Properties
| Name | Meaning |
|---|---|
| Search Query | The text string used to search for relevant Pinterest pins. |
| Category | Optional filter to narrow down search results to a specific category (e.g., fashion). |
Output
The node outputs an array of JSON objects representing the search results from Pinterest pins matching the query and optional category filter. Each item in the output corresponds to one pin's data as returned by the Pinterest API via the integrated service.
The exact structure of each pin object depends on the Pinterest API response but typically includes fields like pin ID, title, description, image URLs, link, and metadata.
No binary data output is produced by this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external "N8N Tools API" service, which acts as a proxy or enhancer for Pinterest API calls.
- Requires OAuth2 credentials for Pinterest API access.
- The node internally uses a
SearchDiscoveryApihelper class to perform the searchPins API call. - Proper configuration of these credentials in n8n is necessary for successful execution.
Troubleshooting
- Invalid subscription or API key error: If the node throws an error indicating invalid subscription or API key, verify that the API key credential is correctly configured and active.
- API request failures: Network issues or Pinterest API rate limits may cause errors; check connectivity and API usage quotas.
- Empty or unexpected results: Ensure the search query is valid and that the category filter (if used) matches supported Pinterest categories.
- Continue on Fail: The node supports continuing execution on individual item failure; enable this option to handle partial failures gracefully.
Links and References
- Pinterest API v5 Documentation
- N8N Official Documentation
- Pinterest Search API Reference (for detailed field descriptions)