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, specifically supporting a wide range of Pinterest-related operations grouped by resource types such as Pins, Boards, Users, Shopping & Catalogs, Advertising & Campaigns, Analytics, Engagement Features, Business Tools, and Search & Discovery.
For the Search & Discovery resource with the Search Users operation, this node allows you to search for Pinterest users based on a text query. This is useful when you want to find users matching certain keywords or interests, for example, to analyze user profiles, gather audience insights, or automate marketing workflows that involve Pinterest user data.
Practical examples include:
- Searching for influencers or content creators related to a niche.
- Finding users to follow or engage with in automated social media campaigns.
- Extracting user data for analytics or CRM enrichment.
Properties
| Name | Meaning |
|---|---|
| Search Query | Text string used to search users on Pinterest. This is the main input to specify what user names or keywords to look for. |
| Page Size | (Optional) Number of results to return per page. Defaults to 25. Limits the number of users returned in one request. |
Output
The output is an array of JSON objects representing the search results for users matching the query. Each item contains user data as returned by the Pinterest API's user search endpoint. The exact structure depends on the API response but typically includes user profile information such as username, display name, profile image, follower counts, and other metadata.
No binary data output is involved in 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 Pinterest OAuth2 credentials for authenticated access to Pinterest endpoints.
- The node internally uses a
SearchDiscoveryApiclass to perform the actual searchUsers API call. - Proper configuration of these credentials in n8n is necessary before using the node.
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 is correct and active.
- Authentication errors: Ensure that the Pinterest OAuth2 credentials are properly set up and authorized.
- Empty or no results: Check that the search query is correctly specified and not empty. Also, consider increasing the page size if too few results are returned.
- Rate limits or API errors: The underlying Pinterest API may impose rate limits; handle errors gracefully and consider retry mechanisms.
- Continue On Fail: The node supports continuing execution on failure for individual items, allowing partial success in batch operations.
Links and References
This summary focuses on the Search & Discovery resource and the Search Users operation as requested.