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 Pins" operation in the Users resource of this Pinterest integration node retrieves a list of pins created or saved by a specified user. This operation is useful for workflows that need to analyze, display, or process content associated with a particular Pinterest user.
Common scenarios include:
- Aggregating a user's pins for content curation or marketing analysis.
- Monitoring user activity or engagement on Pinterest.
- Integrating Pinterest user content into other platforms or reports.
For example, you could use this operation to fetch the latest pins from a user and then automatically share them on social media or analyze their popularity trends.
Properties
| Name | Meaning |
|---|---|
| User ID | The unique identifier or username of the Pinterest user whose pins you want to retrieve. |
| Page Size | Number of pins to return per page. Accepts values from 1 to 250. Defaults to 25. |
| Cursor | Pagination cursor to fetch the next set of results when paginating through large pin lists. |
| Include Private Metrics | Boolean flag to include private metrics data in the response (requires elevated access). |
| Custom Fields | Comma-separated list of additional custom fields to include in the response for each pin. |
Output
The output is an array of JSON objects representing the pins retrieved for the specified user. Each object 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 (images, videos)
- Engagement statistics (if private metrics are included)
- Pagination info if applicable
No binary data is output by this operation.
Dependencies
- Requires a valid API key credential for the external Pinterest API service via the integrated API platform.
- The node uses an internal validation call to verify subscription and API key validity before executing operations.
- No additional environment variables are required beyond the configured credentials.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that your API key credential is correct and active.
- Permission Errors on Private Metrics: Enabling "Include Private Metrics" requires elevated access; without it, the API may reject the request.
- Pagination Issues: When using the "Cursor" property, ensure the cursor value is correctly obtained from previous responses to avoid empty or repeated results.
- Missing or Incorrect User ID: Providing an invalid or empty User ID will result in errors or no data returned. Confirm the User ID or username is accurate.
Links and References
- Pinterest API Documentation
- Pinterest User Pins Endpoint (for reference on available fields and parameters)