Documentation
Back to Dashboard

Content Monitoring

Discover high-quality content from HackerNews, Reddit, and YouTube with keyword monitoring, bulk keyword import, and automatic routing to your reservoirs.

Automatically discover high-quality content from HackerNews, Reddit, 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, and YouTube for high-quality matches
  3. Smart Routing: Discovered content automatically routes to your content reservoirs

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

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 & Programming: Tech, AI, web dev communities
  • Blogging & Content: Writers, bloggers, content creators
  • Marketing & Growth: Marketing, SEO, growth hacking
  • Travel & Lifestyle: Digital nomad, travel communities
  • Finance & Investing: Personal finance, crypto, stocks
  • Custom Selection: Build 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 (Default): r/programming, r/MachineLearning, r/artificial, r/webdev, r/javascript, r/reactjs, r/startups, r/technology
  • Blogging & Content Creation: r/blogging, r/writing, r/freelancewriters, r/ContentWriting, r/copywriting, r/SEO, r/juststart
  • Marketing & Growth: r/marketing, r/content_marketing, r/socialmedia, r/SEO, r/growthhacking, r/Entrepreneur, r/SaaS

Platform Configuration

HackerNews (Technical discussions)

  • Expert-level content
  • Startup and tech news
  • Product launches
  • Developer tools

Platform Value: "hackernews" or "both"

Reddit (Community discussions)

  • Community tutorials
  • Troubleshooting guides
  • Trend identification
  • Beginner to expert content

Platform Value: "reddit" or "both"

All Platforms (Maximum coverage)

  • Comprehensive monitoring
  • Cross-platform insights
  • Complete trend analysis
  • Strategic planning data

Platform Value: "all" (recommended)

Quality Threshold Guidelines

Threshold Ranges

| Score | Meaning | |-------|---------| | 90-100 | Exceptional trending content | | 70-89 | High-quality expert discussions | | 50-69 | Moderate quality (recommended) | | 30-49 | Broad 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.

Next Steps

Want this page as machine-readable markdown? GET /docs/features/content-monitoring.md