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 Products" operation under the "Shopping & Catalogs" resource in this Pinterest Enhanced node allows users to retrieve product information from a specified shopping catalog on Pinterest. This is useful for workflows that need to access detailed product data such as product listings, attributes, and availability within a particular catalog.
Typical use cases include:
- Synchronizing product data from Pinterest catalogs into other systems like e-commerce platforms or inventory management tools.
- Automating marketing workflows that require up-to-date product details.
- Generating reports or analytics based on product information stored in Pinterest catalogs.
For example, a user might want to fetch all products from a specific catalog to update their online store's product database or to create targeted ad campaigns based on product attributes.
Properties
| Name | Meaning |
|---|---|
| Catalog ID | The unique identifier of the shopping catalog from which to retrieve products. This is a required string input. |
Output
The node outputs an array of JSON objects representing the product(s) retrieved from the specified catalog. Each item in the output corresponds to a product with its associated details as returned by the Pinterest Shopping Catalog API.
The exact structure of each product object depends on the Pinterest API response but typically includes fields such as product ID, name, description, price, availability, and other relevant metadata.
No binary data output is produced by this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external "N8N Tools API" service, which acts as a proxy or enhancer for Pinterest API v5.
- Requires OAuth2 authentication credentials for Pinterest API access.
- The node internally uses helper classes to interact with various Pinterest API endpoints, including the Shopping Catalogs API.
- Proper configuration of these credentials in n8n is necessary before using this node.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that the API key credential is correctly set up and has the necessary permissions.
- Catalog Not Found: Providing an incorrect or non-existent Catalog ID will result in errors or empty responses. Double-check the Catalog ID value.
- API Rate Limits: Frequent requests may hit Pinterest or N8N Tools API rate limits, causing temporary failures. Implement retry logic or reduce request frequency.
- Missing Required Parameters: Ensure that the "Catalog ID" property is provided; otherwise, the node will fail validation.
- Network Issues: Connectivity problems between n8n and the external APIs can cause timeouts or errors. Check network settings and firewall rules.