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
This node integrates with the Pinterest API v5 via the N8N Tools service, providing extensive functionality across multiple Pinterest resources. Specifically, for the Advertising & Campaigns resource and the Get Ads operation, it allows users to retrieve ads associated with a particular Ad Group within an advertising account.
This is useful for marketers and advertisers who want to automate the retrieval of their Pinterest ad data for reporting, analysis, or further processing in workflows. For example, you can use this node to fetch all ads under a specific ad group to monitor performance or to sync ad details with other marketing tools.
Properties
| Name | Meaning |
|---|---|
| Ad Account ID | The unique identifier of the advertising account from which to retrieve ads. |
| Ad Group ID | The unique identifier of the ad group whose ads you want to get. |
These properties are required inputs for the "Get Ads" operation under the "Advertising & Campaigns" resource.
Output
The node outputs JSON data representing the ads retrieved from the specified Ad Group within the given Ad Account. Each item in the output corresponds to an individual ad object as returned by the Pinterest API through the N8N Tools service.
The structure typically includes details such as ad identifiers, status, creative information, targeting, and performance metrics (depending on the API response). The exact fields depend on the Pinterest API's ad object schema.
No binary data output is involved in this operation.
Dependencies
- Requires an active subscription and valid API key credential for the N8N Tools API service.
- Requires OAuth2 authentication credentials for Pinterest API access.
- The node internally uses the N8N Tools Pinterest API wrapper to communicate with Pinterest endpoints.
- Proper configuration of these credentials in n8n is necessary before using the node.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error about invalid subscription or API key, verify that your N8N Tools API key is correct and that your subscription is active.
- Missing or Incorrect IDs: Ensure that the Ad Account ID and Ad Group ID are correctly provided and correspond to existing entities in your Pinterest advertising account.
- Permission Issues: Make sure the OAuth2 credentials have sufficient permissions to access advertising data.
- API Rate Limits: Frequent calls may hit Pinterest API rate limits; consider adding delays or handling retries.
- Network Errors: Check network connectivity and proxy settings if requests fail unexpectedly.
Links and References
- Pinterest API v5 Documentation - Ads
- N8N Documentation - Creating Custom Nodes
- N8N Tools Service (for API key and subscription management)
This summary focuses exclusively on the "Advertising & Campaigns" resource and the "Get Ads" operation as requested.