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 Pins" operation of the Pinterest Enhanced node allows users to search for Pinterest pins based on a text query and optional filters. This operation is useful for workflows that need to discover relevant pins matching specific keywords or categories, such as content curation, market research, or social media monitoring.
For example, a user might search for pins related to "vegan recipes" to gather popular food ideas or track trends in plant-based diets. The node supports pagination to handle large result sets efficiently.
Properties
| Name | Meaning |
|---|---|
| Search Query | The text query string used to search for pins. |
| Page Size | Number of items to return per page (1 to 250). |
| Cursor | Pagination cursor to fetch the next page of results. |
| Include Private Metrics | Whether to include private metrics data in the response (requires elevated access). |
| Custom Fields | Comma-separated list of additional custom fields to include in the response. |
Output
The output json field contains the search results returned by the Pinterest API for pins matching the query. It typically includes an array of pin objects with details such as pin ID, title, description, media URLs, and other metadata.
If pagination is used, the output may also include a cursor token to retrieve subsequent pages.
This node does not output binary data for this operation.
Dependencies
- Requires a valid subscription and API key for the external N8N Tools API service.
- Requires Pinterest API credentials via OAuth2 or API key configured in n8n.
- The node internally uses the Pinterest API v5 endpoints through helper classes.
- Proper permissions are needed if requesting private metrics.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error about invalid subscription or API key, verify that your N8N Tools API credentials are correct and active.
- Permission Errors for Private Metrics: Requesting private metrics without elevated access will cause errors. Disable this option or ensure your account has the necessary permissions.
- Pagination Issues: Using an invalid or expired cursor may result in empty or error responses. Always use the cursor provided by the previous response.
- Empty Results: If no pins match the query, the output will be empty. Try broadening the search query or removing restrictive filters.