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 Pins" operation in the "Search & Discovery" resource fetches currently trending Pinterest pins based on optional filters such as category, region, and timeframe. This node is useful for marketers, content creators, and social media managers who want to discover popular and trending content on Pinterest to inform their campaigns, curate content, or analyze trends.
Practical examples:
- A marketer can use this node to retrieve trending pins in the "Fashion" category within the US region over the past week to tailor their advertising strategy.
- A content creator might fetch trending pins globally for the last month to get inspiration for new posts.
- An analyst could gather trending pins data filtered by language to understand regional preferences.
Properties
| Name | Meaning |
|---|---|
| Category | Optional filter to specify the category of pins to retrieve (e.g., "Fashion", "Food"). |
| Region | Optional filter to specify the geographic region for trending pins (e.g., "US", "BR"). |
| Language | Optional filter to specify the language of the pins (e.g., "en", "pt", "es"). |
| Timeframe | Time frame for trending content. Options: Day, Week, Month, Year, All Time. Default: Week. |
Output
The output is an array of JSON objects representing the trending pins matching the specified filters. Each item contains detailed information about a pin, such as its ID, title, description, image URLs, link, and other metadata provided by the Pinterest API.
The output structure includes:
json: The main JSON object with pin details returned from the Pinterest API.itemData.item: The index of the input item that generated this output (useful when processing multiple inputs).
No binary data output is produced by this operation.
Dependencies
- Requires a valid subscription and API key for the external "N8N Tools API" service, which acts as a proxy or middleware to interact with the Pinterest API.
- Requires proper credentials configured in n8n for accessing the N8N Tools API.
- The node internally uses a specialized Search & Discovery API client to perform the "getTrendingPins" request.
Troubleshooting
- Invalid subscription or API key error: If you receive an error indicating invalid subscription or API key, verify that your API key credential is correctly set up and active.
- Empty results: If no trending pins are returned, check if the filters (category, region, language) are too restrictive or if there is no trending data for the selected timeframe.
- API rate limits: Frequent requests may hit rate limits imposed by the external API; consider adding delays or reducing request frequency.
- Network issues: Ensure that your n8n instance has internet access to reach the external API endpoints.
Links and References
This summary is based solely on static analysis of the provided source code and property definitions.