n8n-nodes-n8ntools-reddit

N8N Tools - Reddit Enhanced

Complete Reddit integration with 80+ operations covering the full Reddit ecosystem. This N8N community node provides comprehensive access to Posts, Comments, Subreddits, Users, Messaging, Live Threads, Moderation, Awards, Flair, and Wiki APIs that are missing from the official Reddit node.

✨ Features

• 📝 Advanced Posts: Create, update, vote, save, and manage posts with full lifecycle control
• 💬 Comment Management: Reply, edit, delete, vote, and moderate comments with threading support
• 🏘️ Subreddit Operations: Create, configure, moderate, and analyze subreddit communities
• 👤 User Profiles: Manage user data, karma, awards, and social interactions
• 📨 Messaging System: Send messages, manage conversations, and handle notifications
• 🔴 Live Threads: Create and manage real-time discussion threads
• 🛡️ Moderation Tools: Ban users, remove content, manage rules, and automate moderation
• 🏆 Awards System: Give awards, manage coins, and track recognition
• 🏷️ Flair Management: Create, assign, and customize user and post flairs
• 📚 Wiki Management: Create, edit, and moderate wiki pages
• 🔒 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)

• Go to Settings > Community Nodes in your N8N interface
• Click Install a community node
• Enter n8n-nodes-n8ntools-reddit
• Click Install

Via npm

npm install n8n-nodes-n8ntools-reddit

Setup Credentials

• Sign up at N8N Tools and get your API key
• In N8N, create new N8N Tools API credentials
• Enter your API URL: https://api.n8ntools.io
• Enter your API key
• Optionally, configure Reddit OAuth2 credentials for advanced features

📋 Available Resources

📝 Posts (12 Operations)

Complete post management beyond the official node:

Operation	Description	Official Node	Enhanced
Get Posts	Fetch posts from subreddits/users	✅ Basic	✅ Full API
Create Post	Submit new posts with media	❌	✅
Update Post	Edit post content and flair	❌	✅
Delete Post	Remove posts	❌	✅
Vote on Post	Upvote/downvote posts	❌	✅
Save Post	Save/unsave posts	❌	✅
Hide Post	Hide/unhide posts	❌	✅
Lock Post	Lock/unlock for comments	❌	✅
Mark NSFW	Set NSFW status	❌	✅
Pin Post	Pin to profile/subreddit	❌	✅
Crosspost	Share to multiple subreddits	❌	✅
Get Post Details	Full post information	❌	✅

💬 Comments (10 Operations)

Advanced comment system not available in official node:

• Get Comments: Fetch comments with threading support
• Create Comment: Reply to posts and comments
• Update Comment: Edit comment content
• Delete Comment: Remove comments
• Vote on Comment: Upvote/downvote comments
• Save Comment: Save/unsave comments
• Report Comment: Report inappropriate content
• Distinguish Comment: Mark as moderator comment
• Get More Comments: Load additional comment threads
• Get Comment Context: Get parent comment chain

🏘️ Subreddits (15 Operations)

Complete subreddit management system:

• Get Subreddit Info: Detailed subreddit information
• Get Popular Subreddits: Discover trending communities
• Search Subreddits: Find subreddits by topic
• Subscribe: Join/leave subreddits
• Create Subreddit: Start new communities
• Update Subreddit: Modify settings and appearance
• Upload Header: Custom header images
• Upload Icon: Custom subreddit icons
• Get Moderators: List moderation team
• Add Moderator: Invite new moderators
• Remove Moderator: Remove moderation permissions
• Get Rules: Fetch subreddit rules
• Create Rule: Add new community rules
• Update Rule: Modify existing rules
• Delete Rule: Remove rules

👤 Users (8 Operations)

Comprehensive user profile management:

• Get User Profile: Detailed user information
• Get User Posts: All posts by user
• Get User Comments: All comments by user
• Follow User: Follow/unfollow users
• Block User: Block/unblock users
• Get Karma Breakdown: Karma by subreddit
• Get Trophies: User achievements
• Get Preferences: User settings and preferences

📨 Messaging (6 Operations)

Full messaging system capabilities:

• Send Message: Send private messages
• Get Inbox: Retrieve all messages
• Get Sent Messages: Messages you've sent
• Mark as Read: Mark messages as read/unread
• Delete Message: Remove messages
• Block Correspondent: Block message senders

🔴 Live Threads (8 Operations)

Real-time discussion management:

• Create Live Thread: Start live discussions
• Update Live Thread: Modify thread details
• Add Update: Post live updates
• Strike Update: Remove live updates
• Close Thread: End live discussions
• Get Thread Info: Thread details and stats
• Get Updates: All thread updates
• Invite Contributors: Add live thread contributors

🛡️ Moderation (12 Operations)

Advanced moderation toolkit:

• Remove Content: Remove posts/comments
• Approve Content: Approve flagged content
• Ban User: Ban users from subreddit
• Unban User: Remove user bans
• Mute User: Temporarily silence users
• Get Mod Queue: View moderation queue
• Get Mod Log: Moderation action history
• Add Removal Reason: Create removal templates
• Get Reports: User-reported content
• Ignore Reports: Dismiss reports
• Lock Post: Prevent new comments
• Set Sticky: Pin posts to subreddit

🏆 Awards (7 Operations)

Complete awards and coins system:

• Give Award: Award posts/comments
• Get User Awards: Awards received by user
• Get Post Awards: Awards on specific post
• Get Award Types: Available award types
• Get Coin Balance: User coin balance
• Purchase Coins: Buy Reddit coins
• Gift Premium: Give Reddit Premium

🏷️ Flair Management (10 Operations)

Advanced flair system for users and posts:

• Get User Flair: Get user flair in subreddit
• Set User Flair: Assign user flair
• Get Post Flair: Get available post flairs
• Set Post Flair: Assign post flair
• Create Flair Template: Design flair templates
• Update Flair Template: Modify flair designs
• Delete Flair Template: Remove flair templates
• Get Flair List: All flair templates
• Enable User Flair: Allow user flair selection
• Get Flair Usage: Flair statistics

📚 Wiki Management (8 Operations)

Complete wiki system for documentation:

• Get Wiki Page: Retrieve wiki content
• Create Wiki Page: Create new wiki pages
• Edit Wiki Page: Update wiki content
• Get Wiki Pages: List all wiki pages
• Get Page History: Wiki revision history
• Revert Page: Restore previous version
• Get Page Settings: Wiki page permissions
• Update Page Settings: Modify wiki permissions

💡 Usage Examples

Create and Manage Posts

// Create a new post
Resource: "Posts"
Operation: "Create Post"
Additional Options: {
  "subreddit": "r/programming",
  "title": "New JavaScript Framework Released",
  "text": "Check out this amazing new framework...",
  "flair_id": "12345",
  "send_replies": true
}

// Vote on the post
Resource: "Posts"
Operation: "Vote on Post"
Post ID: "abc123"
Additional Options: {
  "direction": "upvote"
}

Automate Comment Responses

// Reply to a comment
Resource: "Comments"
Operation: "Create Comment"
Additional Options: {
  "parent_id": "t1_abc123",
  "text": "Thanks for your question! Here's the answer...",
  "distinguish": false
}

// Vote on the reply
Resource: "Comments"
Operation: "Vote on Comment"
Comment ID: "def456"
Additional Options: {
  "direction": "upvote"
}

Subreddit Moderation Workflow

// Get moderation queue
Resource: "Moderation"
Operation: "Get Mod Queue"
Additional Options: {
  "subreddit": "r/myprogramming",
  "limit": 25,
  "type": "all"
}

// Remove inappropriate content
Resource: "Moderation"
Operation: "Remove Content"
Content ID: "t3_abc123"
Additional Options: {
  "spam": false,
  "removal_reason": "Rule 3: No self-promotion"
}

// Ban the user
Resource: "Moderation"
Operation: "Ban User"
Additional Options: {
  "subreddit": "r/myprogramming",
  "username": "spammer123",
  "duration": 7,
  "reason": "Repeated rule violations",
  "ban_message": "You have been temporarily banned for spam."
}

Live Thread Management

// Create live thread for events
Resource: "Live Threads"
Operation: "Create Live Thread"
Additional Options: {
  "title": "Tech Conference 2024 - Live Updates",
  "description": "Follow along for real-time updates",
  "nsfw": false
}

// Add live updates
Resource: "Live Threads"
Operation: "Add Update"
Thread ID: "live_abc123"
Additional Options: {
  "body": "🎯 Keynote starting now with CEO presentation!"
}

Advanced User Analytics

// Get user karma breakdown
Resource: "Users"
Operation: "Get Karma Breakdown"
Username: "targetuser"

// Get user's recent activity
Resource: "Users"
Operation: "Get User Posts"
Username: "targetuser"
Additional Options: {
  "sort": "new",
  "time": "week",
  "limit": 50
}

⚙️ Configuration Options

Authentication Methods

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

Filtering and Sorting

• Sort: hot, new, top, controversial, rising
• Time Period: hour, day, week, month, year, all
• Limit: 1-100 items per request (default: 25)

Advanced Options

• Include NSFW: Include/exclude adult content
• Raw JSON: Return raw Reddit API responses
• Expand Comments: Auto-expand comment threads

🛠️ Example Workflows

Content Aggregation

[Scheduler] → [Reddit Enhanced: Get Posts from r/technology] → [Filter by Score] → [Post to Slack/Discord] → [Save to Database]

Community Management

[Reddit Enhanced: Get Reports] → [Analyze Content] → [Auto-Remove Spam] → [Ban Repeat Offenders] → [Log to Mod Channel]

Social Media Monitoring

[Reddit Enhanced: Search Posts by Keyword] → [Sentiment Analysis] → [Alert on Negative Mentions] → [Notify Marketing Team]

Live Event Coverage

[Event Trigger] → [Reddit Enhanced: Create Live Thread] → [Monitor Social Media] → [Reddit Enhanced: Add Updates] → [Close Thread]

📊 Comparison with Official Reddit Node

Feature Category	Official Node	Reddit Enhanced	Improvement
Posts	1 operation	12 operations	+1100%
Comments	0 operations	10 operations	∞ (new)
Subreddits	0 operations	15 operations	∞ (new)
Users	1 operation	8 operations	+700%
Messaging	0 operations	6 operations	∞ (new)
Live Threads	0 operations	8 operations	∞ (new)
Moderation	0 operations	12 operations	∞ (new)
Awards	0 operations	7 operations	∞ (new)
Flair Management	0 operations	10 operations	∞ (new)
Wiki Management	0 operations	8 operations	∞ (new)
Total Operations	2 operations	96 operations	+4700%

🔧 API Endpoints

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

Resource	Base Endpoint
Posts	/api/v1/reddit/posts/
Comments	/api/v1/reddit/comments/
Subreddits	/api/v1/reddit/subreddits/
Users	/api/v1/reddit/users/
Messaging	/api/v1/reddit/messages/
Live Threads	/api/v1/reddit/live/
Moderation	/api/v1/reddit/moderation/
Awards	/api/v1/reddit/awards/
Flair	/api/v1/reddit/flair/
Wiki	/api/v1/reddit/wiki/

🚨 Error Handling

Comprehensive error handling with detailed Reddit-specific messages:

{
  "error": "SUBREDDIT_NOT_FOUND",
  "success": false,
  "resource": "subreddits",
  "operation": "getSubredditInfo",
  "details": {
    "issue": "The specified subreddit does not exist or is private",
    "field": "subreddit",
    "value": "r/nonexistent"
  }
}

💸 Pricing & Limits

• Standard Operations: 1 credit per API call
• Complex Operations: 2-3 credits (moderation, live threads, wiki)
• List Operations: 1 credit per page (25-100 items)
• Media Operations: 2 credits (image uploads, video posts)
• Rate Limits: Respects Reddit'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 Reddit OAuth2 credentials if using advanced features
• Ensure sufficient credits in your account

Permission Errors

• Verify you're subscribed/member of target subreddit
• Check if subreddit is private or restricted
• Ensure proper moderation permissions for mod operations

Content Policy Violations

• Review Reddit's content policy
• Check subreddit-specific rules
• Avoid spam and excessive posting

Rate Limiting

• Implement delays between operations
• Use batch operations where possible
• Monitor rate limit headers in responses

📈 Performance Tips

• Batch Operations: Use pagination for bulk data retrieval
• Caching: Cache subreddit info and user data
• Rate Limiting: Respect Reddit's rate limits (60 requests/minute)
• Error Handling: Implement retry logic for transient failures
• Content Filtering: Use Reddit's filtering options to reduce data transfer

🆘 Support

• Documentation: docs.n8ntools.io
• API Reference: api.n8ntools.io/docs
• Community: Discord
• Email: [e-mail]

📄 License

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

Made with ❤️ by N8N Tools