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
This node provides enhanced integration with the Pinterest API v5, specifically supporting a wide range of Pinterest-related operations. For the Search & Discovery resource and the Get Search Suggestions operation, it fetches search suggestion data from Pinterest based on a user-provided query string.
Use cases include:
- Autocompleting or suggesting search terms in applications that integrate Pinterest content.
- Enhancing user experience by providing relevant Pinterest search suggestions dynamically.
- Building Pinterest-powered search interfaces or recommendation systems.
Example: Given a partial search query like "home decor", the node returns suggested complete search phrases related to that input, helping users refine their searches.
Properties
| Name | Meaning |
|---|---|
| Search Query | The text string for which to get Pinterest search suggestions. This is the input query text used to generate relevant search suggestions. |
Output
The node outputs an array of JSON objects representing the search suggestions returned by Pinterest's API. Each item corresponds to a suggested search term or phrase related to the input query.
The output structure is:
[
{
"json": {
// Pinterest search suggestions data structure
},
"itemData": {
"item": <index_of_input_item>
}
}
]
No binary data 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/validation layer for Pinterest API calls.
- Requires OAuth2 credentials for Pinterest API access.
- The node internally uses a
SearchDiscoveryApiclass to interact with Pinterest's Search & Discovery endpoints. - Proper configuration of these credentials in n8n is necessary before use.
Troubleshooting
- Invalid subscription or API key error: If the node throws an error about invalid subscription or API key, verify that your API key credential for the external service is correct and active.
- HTTP request failures: Network issues or Pinterest API downtime can cause errors; check connectivity and Pinterest API status.
- Empty or unexpected results: Ensure the search query is non-empty and correctly formatted.
- Continue on Fail: If enabled, the node will continue processing other items even if some fail, returning error details per failed item.
Links and References
- Pinterest API v5 Documentation
- n8n Documentation - Creating Custom Nodes
- N8N Tools API (generic reference) (Note: actual URL depends on provider)