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 "Get Trending Searches" operation in the Search & Discovery resource of this Pinterest integration node fetches currently trending search terms on Pinterest. This allows users to discover what topics or keywords are popular among Pinterest users over a specified timeframe and region.
This node is beneficial for marketers, content creators, and social media managers who want to:
- Identify trending topics to tailor their content strategy.
- Monitor regional interest shifts by filtering trends by country or language.
- Track seasonal or time-based popularity changes using different timeframes.
Practical example:
A marketing team wants to create pins related to trending searches in the US over the past week to maximize engagement. They configure this node with region set to "US" and timeframe set to "WEEK" to retrieve relevant trending search terms.
Properties
| Name | Meaning |
|---|---|
| Region | Region filter to specify the geographic area for trending searches (e.g., US, BR, UK). |
| Language | Language filter to specify the language context for trending searches (e.g., en, pt, es). |
| Timeframe | Time frame for trending content. Options: Day, Week, Month, Year, All Time. Default: Week. |
Output
The node outputs an array of JSON objects representing the trending search data retrieved from Pinterest via the API. Each item in the output corresponds to one execution input item and contains the trending searches data under the json property.
The exact structure of the trending searches data depends on the Pinterest API response but typically includes fields such as trending search terms, their popularity metrics, and possibly metadata like timestamps or categories.
No binary data output is produced by this operation.
Dependencies
- Requires a valid subscription and API key credential for the external "N8N Tools API" service that acts as a proxy or enhancer for Pinterest API v5.
- The node uses the "Search & Discovery" API client internally to call Pinterest endpoints.
- Proper configuration of the API key credential in n8n is necessary.
- Network access to the N8N Tools API endpoint is required.
Troubleshooting
Invalid subscription or API key error:
If the node throws an error about invalid subscription or API key, verify that the API key credential is correctly configured and active.API validation failure:
Could indicate network issues or misconfiguration of credentials. Check connectivity and credential settings.Empty or unexpected results:
Ensure that theregionandtimeframeparameters are valid and supported by Pinterest. Some regions or timeframes may not have trending data available.Rate limits or quota exceeded:
The external API may enforce rate limits. If you encounter errors related to request limits, consider reducing request frequency or upgrading your subscription.
Links and References
- Pinterest API v5 Documentation
- N8N Custom Node Development
- N8N Tools API - Pinterest Integration (generic reference to the external API used)