Documentation

Learn how to use RedditScanner to find your next customers on Reddit.

Getting Started

RedditScanner finds marketing opportunities on Reddit. Add keywords, we scan Reddit continuously, and you get a ranked list of threads where your target audience is asking for what you built.

Create an account (free, no credit card)
Add a keyword monitor (e.g., your product category)
Run a scan to find opportunities
Engage with high-scoring threads

How Scoring Works

Every Reddit thread gets a 0-100 opportunity score based on:

Freshness: Threads posted in the last 6-24 hours score higher
Comment count: 5-50 comments is the sweet spot. Too few = no engagement. Too many = buried.
Upvotes: Moderate upvotes indicate visibility without being too late to respond
Subreddit size: Communities with 10K-500K subscribers have the best engagement ratios
Question format: Threads with "?" or "recommend" in the title signal buying intent
Keyword relevance: Keyword in title vs body vs comments

REST API

Pro and Team plans include API access. Make requests to find opportunities programmatically.

GET /api/v1/opportunities?keyword=AI+tools&minScore=50
Headers: x-api-key: rs_YOUR_API_KEY

Response:
{
  "keyword": "AI tools",
  "subreddits": "all",
  "min_score": 50,
  "count": 23,
  "opportunities": [
    {
      "reddit_id": "abc123",
      "title": "Best AI writing tools in 2026?",
      "subreddit": "SaaS",
      "url": "https://reddit.com/r/SaaS/comments/abc123",
      "score": 85,
      "age_hours": 3.5,
      "comment_count": 28,
      "upvotes": 142,
      "reason": "Very fresh thread. Question post seeking recommendations."
    }
  ]
}

MCP Integration

Team plan includes MCP (Model Context Protocol) support. AI agents can call our endpoint to find and analyze Reddit opportunities.

POST /api/mcp
Headers: x-api-key: rs_YOUR_API_KEY
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "scan_reddit",
  "params": {
    "keyword": "project management",
    "subreddits": ["SaaS", "Entrepreneur"],
    "min_score": 50
  }
}

Available methods: scan_reddit, get_subreddits, analyze_thread

Need Help?

Email support@redditscanner.ai or open an issue on GitHub.

Ready to start?