---
name: reddit-search
description: Search and analyze Reddit conversations using reddapi.dev semantic AI search API. Use when researching user opinions, market trends, product feedback, competitor analysis, or any topic discussed on Reddit.
allowed-tools: WebFetch, Bash(curl *)
---

# reddapi.dev Reddit Search API - Reddit Semantic Search

Search Reddit using natural language questions, not keywords. Get AI-powered sentiment analysis and summaries.

## Authentication

All API requests require a Bearer token in the Authorization header:
```
Authorization: Bearer YOUR_API_KEY
```

Get your API key at https://reddapi.dev/account

---

## Use Cases with Examples

### 1. Product Research
Find what users really think about products:
```bash
curl -X POST "https://reddapi.dev/api/v1/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "What do people hate about the iPhone 15 camera?", "limit": 20}'
```

### 2. Market Research
Understand consumer pain points:
```bash
curl -X POST "https://reddapi.dev/api/v1/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Why are young people switching from traditional banks to neobanks?", "limit": 20}'
```

### 3. Competitor Analysis
See how users compare products:
```bash
curl -X POST "https://reddapi.dev/api/v1/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Notion vs Obsidian which one do developers prefer and why?", "limit": 20}'
```

### 4. Feature Validation
Validate product ideas before building:
```bash
curl -X POST "https://reddapi.dev/api/v1/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "What features do users wish Spotify had?", "limit": 20}'
```

### 5. Time-Filtered Vector Search
Search with date range using vector search:
```bash
curl -X POST "https://reddapi.dev/api/v1/search/vector" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Tesla autopilot problems", "limit": 30, "start_date": "2024-01-01", "end_date": "2024-12-31"}'
```

### 6. Discover Trending Topics
Find what's trending in a date range:
```bash
curl -X POST "https://reddapi.dev/api/v1/trends" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start_date": "2024-01-01", "end_date": "2024-01-31", "limit": 20}'
```

---

## API Reference

### POST /api/v1/search

AI-powered semantic search with sentiment analysis and AI summary.

**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| query | string | Yes | - | Natural language question |
| limit | number | No | 20 | Max results (1-100) |

**Example:**
```bash
curl -X POST "https://reddapi.dev/api/v1/search" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "What do developers think about TypeScript?", "limit": 20}'
```

**Response:**
```json
{
  "success": true,
  "data": {
    "query": "What do developers think about TypeScript?",
    "results": [
      {
        "id": "abc123",
        "title": "Finally switched our codebase to TypeScript",
        "content": "After 2 years of plain JS, we migrated to TS and...",
        "subreddit": "webdev",
        "upvotes": 892,
        "comments": 234,
        "created": "2024-03-15T10:30:00Z",
        "relevance": 0.95,
        "sentiment": "positive",
        "url": "https://reddit.com/r/webdev/comments/abc123"
      }
    ],
    "total": 20,
    "processing_time_ms": 1250,
    "ai_summary": "Developers generally favor TypeScript for larger projects due to type safety and better IDE support..."
  }
}
```

---

### POST /api/v1/search/vector

High-speed vector similarity search with date filtering.

**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| query | string | Yes | - | Search query |
| limit | number | No | 30 | Max results (1-30) |
| start_date | string | No | - | Start date (YYYY-MM-DD or ISO 8601) |
| end_date | string | No | - | End date (YYYY-MM-DD or ISO 8601) |

**Example:**
```bash
curl -X POST "https://reddapi.dev/api/v1/search/vector" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "electric vehicle charging problems", "limit": 30, "start_date": "2024-01-01", "end_date": "2024-12-31"}'
```

**Response:**
```json
{
  "success": true,
  "data": {
    "query": "electric vehicle charging problems",
    "results": [
      {
        "id": "vec001",
        "title": "EV charging station was broken again",
        "content": "Drove 20 miles to the nearest charging station...",
        "subreddit": "electricvehicles",
        "upvotes": 445,
        "comments": 123,
        "created": "2024-01-20T08:15:00Z",
        "similarity_score": 0.92,
        "url": "https://reddit.com/r/electricvehicles/comments/vec001"
      }
    ],
    "total": 30,
    "processing_time_ms": 320
  }
}
```

---

### POST /api/v1/trends

Discover trending topics sorted by popularity.

**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| start_date | string | No | today | Start date (YYYY-MM-DD or ISO 8601) |
| end_date | string | No | today | End date (YYYY-MM-DD or ISO 8601) |
| limit | number | No | 20 | Max topics (1-100) |

**Example:**
```bash
curl -X POST "https://reddapi.dev/api/v1/trends" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"start_date": "2024-01-01", "end_date": "2024-01-31", "limit": 20}'
```

**Response:**
```json
{
  "success": true,
  "data": {
    "trends": [
      {
        "id": "trend_ai",
        "topic": "ai",
        "post_count": 1247,
        "total_upvotes": 45632,
        "total_comments": 8923,
        "avg_sentiment": 0.42,
        "top_subreddits": ["technology", "artificial", "futurology"],
        "trending_keywords": ["regulation", "safety", "ethics", "chatgpt", "openai"],
        "sample_posts": [
          {
            "id": "sample1",
            "title": "AI regulation debate heats up",
            "subreddit": "technology",
            "upvotes": 2341,
            "comments": 456,
            "created": "2024-01-15T10:30:00Z"
          }
        ],
        "trend_score": 98.5,
        "growth_rate": 245.3
      }
    ],
    "total": 20,
    "date_range": {
      "start": "2024-01-01",
      "end": "2024-01-31"
    },
    "processing_time_ms": 850
  }
}
```

---

## Rate Limits

| Plan | Price | Monthly Quota | Rate Limit |
|------|-------|---------------|------------|
| Lite | $9.90/mo | 500 | 50 req/min |
| Starter | $49/mo | 5,000 | 50 req/min |
| Pro | $99/mo | 15,000 | 100 req/min |
| Enterprise | Custom | Unlimited | Custom |

---

## Error Codes

| HTTP Code | Error | Description |
|-----------|-------|-------------|
| 400 | Bad Request | Invalid parameters (missing query, invalid date format) |
| 401 | Unauthorized | Invalid or missing API key |
| 403 | Forbidden | Quota exceeded or subscription required |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Internal Error | Server error, retry with backoff |

**Error Response:**
```json
{
  "success": false,
  "error": "Query parameter is required and must be a non-empty string"
}
```

---

## Links

- Get API Key: https://reddapi.dev/account
- Pricing: https://reddapi.dev/pricing
- Documentation: https://reddapi.dev/developers
- MCP Server: https://reddapi.dev/mcp