N8N Tools - Pinterest Enhanced icon

N8N Tools - Pinterest Enhanced

Comprehensive Pinterest API v5 integration for N8N workflows

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 SearchDiscoveryApi class 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

Discussion