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 "Search Boards" operation in the "Search & Discovery" resource allows users to perform a search query specifically for Pinterest boards. This node operation is useful when you want to find Pinterest boards related to a particular topic or keyword, enabling discovery of relevant content collections curated by other users.
Common scenarios include:
- Finding boards on specific interests or niches to gather inspiration.
- Discovering popular or trending boards for marketing research.
- Automating content curation workflows by searching and retrieving boards matching certain criteria.
For example, a user might input a search query like "home decor" to retrieve a list of Pinterest boards focused on home decoration ideas.
Properties
| Name | Meaning |
|---|---|
| Search Query | The text string used to search for boards. This is a required field. |
| Page Size | (Optional) Number of results to return per page. Defaults to 25 if not specified. |
Note: Although "Category" is defined as a property in the JSON, it is not applicable for the "searchBoards" operation according to the display options in the source code.
Output
The output is an array of JSON objects representing the search results for boards matching the query. Each item corresponds to one board found by the search.
- The
jsonfield contains the detailed data returned from the Pinterest API about each board, including metadata such as board name, description, ID, and other relevant attributes. - The output does not include binary data for this operation.
Dependencies
- Requires a valid subscription and API key credential for the external "N8N Tools API" service that acts as a proxy to Pinterest API v5.
- Requires OAuth2 credentials for Pinterest API access.
- The node internally uses a helper class dedicated to the Search & Discovery API endpoints of Pinterest.
- Proper configuration of these credentials in n8n is necessary for successful execution.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that the API key credential is correctly set up and active.
- Empty Results: If no boards are returned, check the search query for typos or try broadening the search terms.
- API Rate Limits: Frequent or large requests may hit rate limits imposed by Pinterest or the proxy API; consider adding delays or reducing page size.
- Network Issues: Ensure network connectivity and that the n8n instance can reach the external API endpoints.