API Reference

Authentication

All API requests require an API key passed via the x-api-key header. Generate your key in Settings.

API access requires a Pro or Team plan.

GET /api/v1/opportunities

Scan Reddit for opportunities matching your keywords. Returns scored and ranked results.

Query Parameters

keyword required

The keyword to search for on Reddit.

subreddits optional

Comma-separated list of subreddits to search. Defaults to all.

minScore optional, default: 30

Minimum opportunity score (0-100). Only results above this score are returned.

Example Request

curl -H "x-api-key: rs_your_key_here" \
  "https://redditscanner.ai/api/v1/opportunities?keyword=AI+writing+tool&subreddits=SaaS,startups&minScore=40"

Example Response

{
  "keyword": "AI writing tool",
  "subreddits": ["SaaS", "startups"],
  "min_score": 40,
  "count": 12,
  "opportunities": [
    {
      "reddit_id": "abc123",
      "title": "Looking for an AI writing tool for my blog",
      "subreddit": "SaaS",
      "url": "https://reddit.com/r/SaaS/comments/abc123/...",
      "score": 82,
      "age_hours": 3.5,
      "comment_count": 15,
      "upvotes": 28,
      "reason": "Very fresh thread. Active discussion, not overcrowded. Good visibility. Question post seeking recommendations. Keyword in title."
    }
  ]
}

Rate Limits

Pro plan: 100 requests per hour

Team plan: 1,000 requests per hour

Rate limit headers are included in every response: X-RateLimit-Remaining, X-RateLimit-Reset.