Reddit Leads

# reddit-leads Skill

## Overview

AI-powered B2B lead discovery from Reddit. Finds users actively expressing buying intent, scores them 0-100, and classifies by lead type — so you can focus on the warmest prospects first.

**Powered by [reddapi.dev](https://reddapi.dev/leads)** — The Lead Engine indexes 50K+ subreddits with 1.5M+ posts, using 1024D vector search to match on meaning, not just keywords.

**Key Advantage:**
- ✅ **AI lead scoring** — Every post scored 0-100 on buying intent signal strength
- ✅ **5 lead type categories** — pain_point, solution_request, complaint, feature_request, comparison
- ✅ **Industry inference** — AI auto-detects industry/context from discussion content
- ✅ **Zero noise** — Filters out support tickets, memes, and irrelevant mentions
- ✅ **Competitor intelligence** — Find users actively complaining about or switching from competitors

## Setup

### Get API Key
1. Create an account at https://reddapi.dev
2. Subscribe to a paid plan (Free: 3 searches/mo, Lite $19.9/mo, Starter $49/mo, Pro $99/mo)
3. Go to https://reddapi.dev/account to view or generate your API key

### Environment Variable
```bash
export REDDAPI_API_KEY="your_api_key_here"
```

### Rate Limits

| Plan | Monthly API Calls | Per Minute |
|------|-------------------|------------|
| Free | 3 | — |
| Lite | 500 | 50 |
| Starter | 5,000 | 50 |
| Pro | 15,000 | 100 |
| Enterprise | Unlimited | 1,000 |

## API Reference

**Base URL:** `https://reddapi.dev`

**Authentication:** All requests require header:
```
Authorization: Bearer YOUR_API_KEY
```

### POST /api/v1/leads

Find scored, classified business leads from Reddit discussions.

```bash
curl -X POST "https://reddapi.dev/api/v1/leads" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "people frustrated with project management tools", "limit": 20, "min_score": 60}'
```

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| query | string | Yes | Natural language lead query — describe who you're looking for |
| limit | number | No | Results to return (default: 20, max: 100) |
| min_score | number | No | Minimum lead score filter (0-100, default: 0) |

**Response:**
```json
{
  "success": true,
  "data": {
    "query": "people frustrated with project management tools",
    "results": [
      {
        "id": "lead001",
        "title": "Asana is getting too expensive for our team of 15",
        "content": "We're paying $400/mo for Asana and half our team doesn't even use it...",
        "subreddit": "projectmanagement",
        "author": "pm_burnt_out",
        "upvotes": 234,
        "comments": 89,
        "lead_score": 94,
        "lead_type": "pain_point",
        "pain_point": "Pricing - cost too high for team size",
        "opportunity": "Affordable project management alternative for mid-size teams",
        "industry": "SaaS / Project Management",
        "target_product": "Asana",
        "url": "https://reddit.com/r/projectmanagement/comments/lead001"
      }
    ],
    "total": 2,
    "processing_time_ms": 840
  }
}
```

### Lead Types (5 Categories)

| Type | Description | Example |
|------|-------------|---------|
| `pain_point` | Users frustrated with current solutions | "Jira is so slow and bloated" |
| `solution_request` | Users actively asking for alternatives | "What's a good alternative to X?" |
| `complaint` | Users complaining about specific products | "Salesforce support is terrible" |
| `feature_requ