Documentation
Documentation
Content Monitoring
Automatically discover high-quality content from HackerNews, Reddit, Twitter (via Nitter), and YouTube using intelligent keyword monitoring with powerful bulk import capabilities.
How It Works
1
Add Keywords
Import keywords individually, via bulk upload, or through reservoir integration
2
Auto Discovery
System continuously monitors HackerNews, Reddit, Twitter, and YouTube for high-quality matches
3
Smart Routing
Discovered content automatically routes to your content reservoirs
NEW
Twitter Monitoring via Nitter
Enable FEATURE_TWITTER_NITTER to ingest public tweets through rotating Nitter RSS instances. Keywords now power HackerNews, Reddit, Twitter, and YouTube sourcing from a single interface—no extra configuration needed.
- • Shared keyword + bulk import workflow across all three platforms
- • Automatic instance rotation with graceful degradation handling
- • Author handles, language badges, and direct X links in the monitoring feed
- • Quick "Hide Twitter" filter to focus on community or RSS signals when needed
YT
YouTube Title Monitoring
Provide a YOUTUBE_API_KEY to search YouTube for newly published videos where your keyword appears directly in the title. Results include channel attribution, thumbnails, and direct watch links inside the monitoring feed.
- • Title-matching keeps discoveries focused on high-intent videos
- • Captures channel, thumbnail, and publication time for quick triage
- • Records duration, views, and likes so you can spot the strongest opportunities fast
- • Uses the same keyword manager and bulk import workflow as other platforms
- • Optional “Exclude Shorts” toggle avoids sub-minute clips when you only want long-form
- • Supports dashboard filtering alongside RSS, HackerNews, Reddit, and Twitter
Bulk Keyword Import
Quick Start
- 1. Navigate to Admin → Content Monitoring
- 2. Click "Keyword Settings" button
- 3. Click "Bulk Import" to open the import modal
- 4. Choose your method: paste text or upload file
- 5. Import your keywords in any supported format
Text Input Method
- • Copy and paste keywords directly
- • Supports CSV, JSON, and simple text formats
- • Interactive format examples
- • Real-time validation feedback
File Upload Method
- • Upload .csv, .json, or .txt files
- • Automatic format detection
- • Error reports with download links
- • Batch processing with progress tracking
Supported Import Formats
CSV Format (Excel/Spreadsheet)
Perfect for exporting from Excel or Google Sheets
// Header row required
keyword,platforms,subreddits,min_score,active
"machine learning","hackernews;reddit","MachineLearning;artificial",100,true
"web development","hackernews;reddit","webdev;javascript",75,true
"startup funding","hackernews","",50,true
"competitive intelligence","hackernews;reddit;twitter;youtube","technology;startups",60,true
JSON Format (API/Export)
Structured format for API integrations and exports
[
{
"keyword": "machine learning",
"platforms": ["hackernews", "reddit"],
"subreddits": ["MachineLearning", "artificial"],
"min_score": 100,
"active": true
},
{
"keyword": "web development",
"platforms": ["hackernews", "reddit"],
"subreddits": ["webdev", "javascript"],
"min_score": 75,
"active": true
},
{
"keyword": "ai social signals",
"platforms": ["twitter"],
"subreddits": [],
"min_score": 0,
"active": true
}
]Simple Text Format (Quick Entry)
Pipe-separated format for quick manual entry
// Format: keyword | platforms | subreddits | min_score
machine learning | both | MachineLearning,artificial | 100
web development | both | webdev,javascript | 75
startup funding | hackernews | | 50
react development | reddit | reactjs,javascript | 60
ai social listening | twitter | | 0
Tip: Use
all for full HackerNews + Reddit + Twitter coverage, or social for Reddit + Twitter only.🎯 Tenant-Specific Subreddit Configuration
NEW
Customize Your Default Subreddits
Each tenant can now configure their own default subreddits for Reddit monitoring. When keywords don't specify specific subreddits, the system uses your tenant-specific defaults instead of generic ones.
📚 Preset Categories
- •Technology & ProgrammingTech, AI, web dev communities
- •Blogging & ContentWriters, bloggers, content creators
- •Marketing & GrowthMarketing, SEO, growth hacking
- •Travel & LifestyleDigital nomad, travel communities
- •Finance & InvestingPersonal finance, crypto, stocks
- •Custom SelectionBuild your own subreddit list
⚙️ How It Works
- 1. Navigate to your monitoring settings
- 2. Select a preset category or choose "Custom"
- 3. Add/remove individual subreddits as needed
- 4. Save your configuration
- 5. All keywords without subreddits will use your defaults
Example Use Case:
If you're a content creator, select the "Blogging & Content" preset to monitor r/blogging, r/writing, r/freelancewriters, and more relevant communities by default.
Preset Examples
Technology & Programming
Defaultr/programmingr/MachineLearningr/artificialr/webdevr/javascriptr/reactjsr/startupsr/technology
Blogging & Content Creation
r/bloggingr/writingr/freelancewritersr/ContentWritingr/copywritingr/SEOr/juststart
Marketing & Growth
r/marketingr/content_marketingr/socialmediar/SEOr/growthhackingr/Entrepreneurr/SaaS
Platform Configuration
HN
HackerNews
Technical discussions
- • Expert-level content
- • Startup and tech news
- • Product launches
- • Developer tools
Platform Value:
"hackernews" or "both"
R
Community discussions
- • Community tutorials
- • Troubleshooting guides
- • Trend identification
- • Beginner to expert content
Platform Value:
"reddit" or "both"
X
Twitter (Nitter)
Real-time social signals
- • Rapid reaction insights
- • Audience sentiment snapshots
- • Handle-level targeting
- • Viral opportunity detection
Platform Value:
"twitter" or "social"
⚡
All Platforms
Maximum coverage
- • Comprehensive monitoring
- • Cross-platform insights
- • Complete trend analysis
- • Strategic planning data
Platform Value:
"all" (recommended)
Quality Threshold Guidelines
Threshold Ranges
90-100Exceptional trending content
70-89High-quality expert discussions
50-69Moderate quality (recommended)
30-49Broad coverage with basic content
Strategic Applications
Technical Reservoirs
Use 70+ for expert-focused content
Business Strategy
Use 60+ for insights and trends
Industry Monitoring
Use 50+ for comprehensive coverage
Competitive Intelligence
Use 40+ for broad market coverage
Best Practices
Bulk Import Strategy
- ✓ Start with 10-20 keywords to test formats
- ✓ Organize keywords by category/topic
- ✓ Set appropriate thresholds per category
- ✓ Choose platforms based on content type
- ✓ Keep original files for future reference
Keyword Selection
General Terms (20%)
Broad scope for trend identification
Specific Terms (60%)
Focused expertise and core content
Trending Terms (20%)
Emerging discussions and early detection
Error Handling & Recovery
Import Error Management
Error Features
- • Line-by-line error identification
- • Downloadable CSV error reports
- • Specific error messages for quick fixes
- • Partial import success with error isolation
- • Re-import capability for corrected data
Common Errors & Solutions
❌ "Keyword is required"
Ensure all rows have keyword values
❌ "Invalid platform"
Use "hackernews", "reddit", or "both"
⚠️ "Duplicate keyword"
Automatically skipped, no action needed
Integration with Content Reservoirs
Keywords added to content reservoirs are automatically integrated with the monitoring system for seamless content discovery.
Automatic Integration
- • Reservoir keywords auto-added to monitoring
- • Protected from accidental deletion in monitoring UI
- • Visual indicators show active monitoring status
- • Unified storage with proper flagging system
Management Protection
- • Reservoir keywords only editable from reservoir settings
- • Prevents accidental removal via monitoring interface
- • Maintains content routing to specific reservoirs
- • Ensures consistent discovery and organization
💡
Pro Tip
Use the monitoring interface for general keyword management and the reservoir settings for topic-specific keyword strategies.