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 Popular Pins" operation in the Search & Discovery resource fetches a list of popular Pinterest pins filtered by optional criteria such as category, region, and timeframe. This node is useful for marketers, content creators, and social media managers who want to discover trending or widely engaged content on Pinterest to inform their campaigns, curate content, or analyze popular trends.
Practical examples:
- A marketer wants to find the most popular pins in the "Home Decor" category in the US over the past week to tailor their advertising strategy.
- A content creator seeks popular pins in a specific language or region to inspire new content ideas.
- An analyst gathers data on popular pins across different timeframes to track seasonal trends.
Properties
| Name | Meaning |
|---|---|
| Category | Optional filter to specify the category of pins (e.g., "Home Decor", "Fashion"). |
| Region | Optional filter to specify the geographic region (e.g., "US", "BR", "UK"). |
| Language | Optional filter to specify the language (e.g., "en", "pt", "es"). |
| Timeframe | Time frame for popular content; options are: Day, Week, Month, Year, All Time. Default: Week |
Output
The node outputs an array of JSON objects representing popular pins matching the specified filters. Each item in the output corresponds to one pin's data as returned by the Pinterest API via the integrated service.
The exact structure of each pin object depends on the Pinterest API response but typically includes details such as pin ID, title, description, image URLs, engagement metrics, and other metadata relevant to popular pins.
This node does not output binary data.
Dependencies
- Requires an active subscription and valid API key credential for the external "N8N Tools API" service that acts as a proxy to Pinterest API v5.
- Requires Pinterest OAuth2 authentication credentials configured in n8n.
- The node internally uses a helper class for the Search & Discovery API endpoints of Pinterest.
- Network access to the N8N Tools API endpoint is necessary.
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 set up and has an active subscription.
- API validation failure: Could indicate network issues or misconfiguration of credentials.
- Empty results: If no popular pins are returned, try adjusting filters like category, region, or timeframe to broaden the search.
- Rate limits: Excessive requests may be throttled by the external API; consider adding delays or reducing request frequency.
- Credential errors: Ensure both the API key and Pinterest OAuth2 credentials are valid and authorized.