N8N Tools - Pinterest Enhanced

Complete Pinterest integration with 70+ operations covering the full Pinterest Business ecosystem. This N8N community node provides comprehensive access to Pins, Boards, Users, Shopping Catalogs, Advertising, Analytics, Search, Discovery, Engagement, and Business Tools APIs that are missing from the official Pinterest node.

✨ Features

• 📌 Advanced Pins: Create, update, delete, and analyze pins with rich media support
• 📋 Board Management: Create, organize, and collaborate on Pinterest boards
• 👥 User Operations: Manage profiles, followers, and user interactions
• 🛍️ Shopping Catalogs: Complete e-commerce integration with product catalogs
• 📈 Advertising Campaigns: Create and manage Pinterest Ads campaigns
• 📊 Advanced Analytics: Detailed performance metrics and insights
• 🔍 Search & Discovery: Find trending content and optimize discoverability
• 💝 Engagement Features: Manage likes, saves, comments, and social interactions
• 🏢 Business Tools: Professional features for Pinterest Business accounts
• 🔒 Secure API: Powered by N8N Tools platform with usage tracking and validation

🚀 Quick Start

Installation

Install this node in your N8N instance:

Via Community Nodes (Recommended)

1. Go to Settings > Community Nodes in your N8N interface
2. Click Install a community node
3. Enter n8n-nodes-n8ntools-pinterest
4. Click Install

Via npm

npm install n8n-nodes-n8ntools-pinterest

Setup Credentials

1. Sign up at N8N Tools and get your API key
2. In N8N, create new N8N Tools API credentials
3. Enter your API URL: https://api.n8ntools.io
4. Enter your API key
5. Optionally, configure Pinterest OAuth2 credentials for advanced features

📋 Available Resources

📌 Pins (8 Operations)

Complete pin lifecycle management:

| Operation | Description | Official Node | Enhanced | |-----------|-------------|---------------|----------| | Create Pin | Upload and create new pins | ❌ | ✅ | | Get Pin | Retrieve pin details | ✅ Basic | ✅ Full API | | Update Pin | Modify pin content and settings | ❌ | ✅ | | Delete Pin | Remove pins | ❌ | ✅ | | Save Pin | Save pins to boards | ❌ | ✅ | | Get Pin Analytics | Pin performance metrics | ❌ | ✅ | | Get Pin Comments | Comments and engagement | ❌ | ✅ | | Report Pin | Report inappropriate content | ❌ | ✅ |

📋 Boards (7 Operations)

Advanced board management capabilities:

• Create Board: Create new Pinterest boards
• Get Board: Retrieve board information
• Update Board: Modify board settings and description
• Delete Board: Remove boards
• Get Board Pins: All pins in a specific board
• Get Board Analytics: Board performance metrics
• Follow Board: Follow/unfollow boards

👥 Users (6 Operations)

Comprehensive user profile management:

• Get User Profile: Detailed user information
• Update User Profile: Modify profile settings
• Get User Pins: All pins created by user
• Get User Boards: All boards owned by user
• Follow User: Follow/unfollow users
• Get User Analytics: User account metrics

🛍️ Shopping Catalogs (8 Operations)

Complete e-commerce integration system:

• Create Catalog: Set up product catalogs
• Get Catalog: Retrieve catalog information
• Update Catalog: Modify catalog settings
• Delete Catalog: Remove catalogs
• Get Product Groups: Organize products
• Create Product Group: Group related products
• Get Products: Retrieve product listings
• Get Catalog Analytics: E-commerce performance metrics

📈 Advertising (7 Operations)

Full Pinterest Ads campaign management:

• Get Ad Accounts: List advertising accounts
• Get Ad Account: Account details and settings
• Get Campaigns: List ad campaigns
• Create Campaign: Set up new campaigns
• Get Campaign: Campaign details and metrics
• Update Campaign: Modify campaign settings
• Delete Campaign: Remove campaigns

📊 Analytics (6 Operations)

Advanced analytics and reporting system:

• Get User Analytics: Account performance metrics
• Get Pin Analytics: Individual pin performance
• Get Board Analytics: Board engagement metrics
• Get Top Pins: Most engaging content
• Get Campaigns Analytics: Advertising ROI metrics
• Get Report Status: Async report generation

🔍 Search & Discovery (8 Operations)

Advanced search and content discovery:

• Search Pins: Find pins by keywords
• Search Boards: Discover boards by topic
• Search Users: Find users and creators
• Get Trending Pins: Popular content discovery
• Get Related Pins: Similar content suggestions
• Get Keywords: Trending search terms
• Get Popular Categories: Trending topics
• Get Search Suggestions: Auto-complete suggestions

💝 Engagement Features (6 Operations)

Social interaction and engagement tools:

• Get Pin Comments: Comments and replies
• Create Comment: Reply to pins
• Delete Comment: Remove comments
• Like Pin: Like/unlike pins
• Get Pin Saves: Save analytics
• Get Audience Insights: Follower demographics

🏢 Business Tools (7 Operations)

Professional Pinterest Business features:

• Verify Website: Domain verification
• Get Website Analytics: Website traffic from Pinterest
• Create Rich Pins: Enhanced pin metadata
• Manage Catalogs: Business catalog management
• Get Conversion Tracking: E-commerce conversions
• Claim Website: Claim domain ownership
• Get Business Insights: Professional account metrics

💡 Usage Examples

Create and Optimize Pins

// Create a new pin
Resource: "Pins"
Operation: "Create Pin"
Additional Options: {
  "board_id": "123456789",
  "media_source": {
    "source_type": "image_url",
    "url": "https://example.com/image.jpg"
  },
  "title": "Amazing Product Launch",
  "description": "Check out our latest innovation! Perfect for tech enthusiasts.",
  "alt_text": "Innovative tech product on white background",
  "link": "https://example.com/product"
}

// Get pin analytics
Resource: "Analytics"
Operation: "Get Pin Analytics"
Pin ID: "987654321"
Additional Options: {
  "start_date": "2024-01-01",
  "end_date": "2024-01-31",
  "metric_types": ["IMPRESSION", "SAVE", "PIN_CLICK", "OUTBOUND_CLICK"]
}

E-commerce Catalog Management

// Create product catalog
Resource: "Shopping"
Operation: "Create Catalog"
Additional Options: {
  "name": "My Store Catalog",
  "format": "TSV",
  "default_country": "US",
  "default_currency": "USD",
  "default_locale": "en_US"
}

// Add product group
Resource: "Shopping"
Operation: "Create Product Group"
Catalog ID: "catalog123"
Additional Options: {
  "name": "Electronics",
  "filters": {
    "product_type": ["smartphone", "laptop", "tablet"]
  }
}

// Get catalog analytics
Resource: "Shopping"
Operation: "Get Catalog Analytics"
Catalog ID: "catalog123"
Additional Options: {
  "start_date": "2024-01-01",
  "end_date": "2024-01-31",
  "granularity": "DAY"
}

Pinterest Ads Campaign Setup

// Create advertising campaign
Resource: "Advertising"
Operation: "Create Campaign"
Ad Account ID: "123456789"
Additional Options: {
  "name": "Summer Sale 2024",
  "status": "ACTIVE",
  "objective": "TRAFFIC",
  "budget": {
    "daily_spend_cap": 5000,
    "lifetime_spend_cap": 100000
  },
  "start_time": "2024-06-01T00:00:00Z",
  "end_time": "2024-08-31T23:59:59Z"
}

// Monitor campaign performance
Resource: "Analytics"
Operation: "Get Campaigns Analytics"
Ad Account ID: "123456789"
Additional Options: {
  "start_date": "2024-06-01",
  "end_date": "2024-06-30",
  "granularity": "DAY",
  "campaign_ids": ["campaign123"]
}

Content Discovery and Research

// Search for trending content
Resource: "Search"
Operation: "Search Pins"
Additional Options: {
  "query": "sustainable fashion",
  "limit": 50,
  "include_related": true
}

// Get trending keywords
Resource: "Search"
Operation: "Get Keywords"
Additional Options: {
  "category": "fashion",
  "limit": 20,
  "trending_only": true
}

// Find related content
Resource: "Search"
Operation: "Get Related Pins"
Pin ID: "456789123"
Additional Options: {
  "limit": 25
}

Business Analytics Dashboard

// Get comprehensive user analytics
Resource: "Analytics"
Operation: "Get User Analytics"
Additional Options: {
  "start_date": "2024-01-01",
  "end_date": "2024-03-31",
  "metric_types": [
    "IMPRESSION",
    "SAVE",
    "PIN_CLICK",
    "OUTBOUND_CLICK",
    "ENGAGEMENT"
  ],
  "granularity": "WEEK"
}

// Get top performing pins
Resource: "Analytics"
Operation: "Get Top Pins"
Additional Options: {
  "start_date": "2024-01-01",
  "end_date": "2024-01-31",
  "sort_by": "IMPRESSION",
  "limit": 10
}

⚙️ Configuration Options

Authentication Methods

• N8N Tools API: Primary authentication (required)
• Pinterest OAuth2: Enhanced features and higher rate limits

Media Upload Options

• Image URLs: Direct image URL upload
• Base64 Images: Encoded image data
• Local Files: File system uploads
• Video Support: Video pin creation

Advanced Settings

• Rich Pins: Enhanced metadata support
• Shopping Features: E-commerce integration
• Analytics Granularity: Hour, day, week, month reporting
• Bulk Operations: Batch processing support

🛠️ Example Workflows

E-commerce Product Sync

[Product Database] → [Pinterest Enhanced: Create Pin] → [Pinterest Enhanced: Add to Catalog] → [Pinterest Enhanced: Monitor Performance] → [Update Inventory]

Content Marketing Automation

[Content Creation] → [Pinterest Enhanced: Create Pin] → [Pinterest Enhanced: Add to Board] → [Pinterest Enhanced: Monitor Analytics] → [Report Performance]

Social Media Management

[Scheduler] → [Pinterest Enhanced: Create Pin] → [Pinterest Enhanced: Schedule Publishing] → [Pinterest Enhanced: Track Engagement] → [Generate Reports]

Advertising Campaign Management

[Campaign Strategy] → [Pinterest Enhanced: Create Campaign] → [Pinterest Enhanced: Monitor Performance] → [Optimize Budget] → [Scale Successful Ads]

📊 Comparison with Official Pinterest Node

| Feature Category | Official Node | Pinterest Enhanced | Improvement | |------------------|---------------|-------------------|-------------| | Pins | 2 operations | 8 operations | +300% | | Boards | 1 operation | 7 operations | +600% | | Users | 1 operation | 6 operations | +500% | | Shopping | 0 operations | 8 operations | ∞ (new) | | Advertising | 0 operations | 7 operations | ∞ (new) | | Analytics | 0 operations | 6 operations | ∞ (new) | | Search & Discovery | 0 operations | 8 operations | ∞ (new) | | Engagement | 0 operations | 6 operations | ∞ (new) | | Business Tools | 0 operations | 7 operations | ∞ (new) | | Total Operations | 4 operations | 63 operations | +1475% |

🔧 API Endpoints

All operations are routed through N8N Tools API for consistent authentication:

| Resource | Base Endpoint | |----------|---------------| | Pins | /api/v1/pinterest/pins/ | | Boards | /api/v1/pinterest/boards/ | | Users | /api/v1/pinterest/users/ | | Shopping | /api/v1/pinterest/shopping/ | | Advertising | /api/v1/pinterest/advertising/ | | Analytics | /api/v1/pinterest/analytics/ | | Search | /api/v1/pinterest/search/ | | Engagement | /api/v1/pinterest/engagement/ | | Business Tools | /api/v1/pinterest/business/ |

🚨 Error Handling

Comprehensive error handling with Pinterest-specific error codes:

{
  "error": "PIN_NOT_FOUND",
  "success": false,
  "resource": "pins",
  "operation": "getPin",
  "details": {
    "issue": "The specified pin does not exist or is not accessible",
    "field": "pin_id",
    "value": "invalid_pin_id"
  }
}

💸 Pricing & Limits

• Standard Operations: 1 credit per API call
• Media Operations: 2 credits (pin creation with images/videos)
• Analytics Operations: 1-2 credits depending on data volume
• Advertising Operations: 2-3 credits (campaign management)
• Bulk Operations: 1 credit per item processed
• Rate Limits: Follows Pinterest's official rate limiting
• Usage Tracking: Real-time credit monitoring

🔧 Troubleshooting

Common Issues

Authentication Errors

• Verify N8N Tools API key is valid and active
• Check Pinterest OAuth2 credentials if using business features
• Ensure sufficient credits in your account

Media Upload Failures

• Verify image URL is publicly accessible
• Check image format (JPEG, PNG, GIF supported)
• Ensure image size is within Pinterest limits (10MB max)

Catalog Sync Issues

• Verify product feed format matches Pinterest requirements
• Check that all required fields are present
• Ensure products meet Pinterest merchant guidelines

Campaign Creation Errors

• Verify ad account has sufficient budget
• Check campaign dates are in the future
• Ensure targeting parameters are valid

📈 Performance Tips

1. Batch Operations: Use bulk APIs for multiple pins/boards
2. Image Optimization: Optimize images for Pinterest (2:3 or 1:1 aspect ratio)
3. Rich Pins: Use rich pins for better engagement
4. Keyword Research: Use trending keywords for better discoverability
5. Analytics Monitoring: Regular performance tracking for optimization

🆘 Support

• Documentation: docs.n8ntools.io
• API Reference: api.n8ntools.io/docs
• Community: Discord
• Email: [email protected]

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Made with ❤️ by N8N Tools