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 User Liked Pins" operation in the Users resource of this Pinterest Enhanced node retrieves a paginated list of pins that a specified user has liked. This is useful for workflows that need to analyze or display content a user has shown interest in by liking pins.
Common scenarios include:
- Aggregating liked pins for social media analytics.
- Creating personalized recommendations based on user preferences.
- Monitoring engagement with specific users' liked content.
For example, you could use this node to fetch the first 50 pins liked by a user to generate a report on their interests or to curate content feeds tailored to their tastes.
Properties
| Name | Meaning |
|---|---|
| User ID | The unique identifier or username of the user whose liked pins you want to retrieve. |
| Page Size | Number of liked pins to return per page. Can be set between 1 and 250. |
| Cursor | Pagination cursor token to fetch the next page of results. |
| Include Private Metrics | Boolean flag to include private metrics data (requires elevated access). |
| Custom Fields | Comma-separated list of additional custom fields to include in the response. |
Output
The output is an array of JSON objects representing the liked pins of the specified user. Each item contains detailed information about a pin, including standard fields and optionally any requested custom fields or private metrics if enabled.
The structure typically includes:
- Pin identifiers and metadata (title, description, link, etc.).
- Media details such as images or videos associated with the pin.
- Engagement statistics if private metrics are included.
No binary data output is produced by this operation.
Dependencies
- Requires a valid API key credential for the external Pinterest-related API service.
- The node uses an internal validation call to verify subscription and API key validity before executing operations.
- Proper OAuth2 or API authentication credentials must be configured in n8n for Pinterest API access.
- Elevated access permissions are needed to retrieve private metrics.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that your API credentials are correct and active.
- Pagination Issues: When using the cursor property, ensure the cursor token is valid and corresponds to the previous page's response; otherwise, no results or errors may occur.
- Access Denied for Private Metrics: Enabling private metrics without proper elevated access will result in authorization errors.
- User Not Found: Providing an incorrect or non-existent User ID will cause the API to fail fetching liked pins.
To resolve these issues:
- Double-check API keys and OAuth tokens.
- Use the pagination cursor exactly as returned from prior calls.
- Confirm your account has the necessary permissions for private data.
- Validate user identifiers before running the node.