Developer Documentation

Integrate Reddit insights into your applications with our powerful, easy-to-use API.

Quick Start

Get started with the reddapi.dev Reddit Search API API in minutes. All API endpoints require authentication and are available for Pro and Enterprise subscribers.

Authentication

Authorization: Bearer YOUR_API_KEY

Base URL

https://reddapi.dev/v1

Getting Your API Key

API keys are available in your account dashboard after subscribing to a Pro or Enterprise plan. Each API call counts toward your monthly quota based on your subscription tier.

Interactive API Explorer

Testing Counts Toward Your Quota

API requests made through this explorer will count against your plan's quota. Make sure you have an active subscription or free tier credits available.

Loading API Explorer...

Endpoints

View API Pricing → MCP Server (Claude Desktop) llms.txt (LLM-friendly docs)

POST /api/v1/search/semantic PAID API

Semantic Search (AI Search)

Search Reddit conversations using natural language queries with AI-powered semantic understanding. This endpoint uses advanced language models to understand the meaning and context of your query, returning the most relevant discussions.

Request Example

curl -X POST https://reddapi.dev/api/v1/search/semantic \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "What do young people complain about banking apps?",
  "limit": 20
}'

Response Example

{
  "success": true,
  "data": {
    "query": "What do young people complain about banking apps?",
    "results": [
      {
        "id": "abc123",
        "title": "Why is my bank's app so slow?",
        "content": "I'm 24 and switched to this bank because they claimed to be digital-first...",
        "subreddit": "personalfinance",
        "upvotes": 342,
        "comments": 87,
        "created": "2024-01-15T10:30:00Z",
        "relevance": 0.95,
        "sentiment": "negative",
        "url": "https://reddit.com/r/personalfinance/comments/abc123"
      },
      {
        "id": "def456",
        "title": "Banking app UI is terrible for Gen Z",
        "content": "As someone in their early 20s, I find most banking apps...",
        "subreddit": "technology",
        "upvotes": 256,
        "comments": 64,
        "created": "2024-01-14T15:20:00Z",
        "relevance": 0.89,
        "sentiment": "negative",
        "url": "https://reddit.com/r/technology/comments/def456"
      }
    ],
    "total": 2,
    "processing_time_ms": 1245,
    "ai_summary": "Young users frequently complain about slow performance, outdated UI design, and lack of modern features like instant notifications and biometric authentication."
  }
}

POST /api/v1/search/vector PAID API

Vector Search

Perform high-speed vector similarity search on Reddit posts. This endpoint converts your query into embeddings and finds semantically similar content using vector database technology.

Request Example

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",
  "limit": 30,
  "start_date": "2025-11-01",
  "end_date": "2025-12-31"
}'

Response Example

{
  "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 only to find...",
        "subreddit": "electricvehicles",
        "upvotes": 445,
        "comments": 123,
        "created": "2024-01-20T08:15:00Z",
        "similarity_score": 0.92,
        "url": "https://reddit.com/r/electricvehicles/comments/vec001"
      },
      {
        "id": "vec002",
        "title": "Charging infrastructure needs improvement",
        "content": "Living in a rural area, the lack of reliable charging stations...",
        "subreddit": "teslamotors",
        "upvotes": 312,
        "comments": 89,
        "created": "2024-01-18T14:30:00Z",
        "similarity_score": 0.88,
        "url": "https://reddit.com/r/teslamotors/comments/vec002"
      }
    ],
    "total": 2,
    "processing_time_ms": 234
  }
}

POST /api/v1/trends PAID API

Trending Topics

Discover trending topics and discussions on Reddit, sorted by popularity and engagement. Track what's hot in specific time periods.

Request Example

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

Response Example

{
  "success": true,
  "data": {
    "trends": [
      {
        "id": "trend001",
        "topic": "AI regulation debate",
        "post_count": 1247,
        "total_upvotes": 45632,
        "total_comments": 8934,
        "avg_sentiment": 0.42,
        "top_subreddits": [
          "technology",
          "artificial",
          "futurology"
        ],
        "trending_keywords": [
          "regulation",
          "AI safety",
          "ethics",
          "government"
        ],
        "sample_posts": [
          {
            "id": "post001",
            "title": "EU passes landmark AI regulation",
            "subreddit": "technology",
            "upvotes": 5432,
            "comments": 892,
            "created": "2024-01-25T09:00:00Z"
          }
        ],
        "trend_score": 98.5,
        "growth_rate": 245.3
      },
      {
        "id": "trend002",
        "topic": "Remote work policies",
        "post_count": 892,
        "total_upvotes": 32145,
        "total_comments": 5621,
        "avg_sentiment": 0.15,
        "top_subreddits": [
          "jobs",
          "careerguidance",
          "antiwork"
        ],
        "trending_keywords": [
          "RTO",
          "hybrid",
          "productivity",
          "office"
        ],
        "sample_posts": [
          {
            "id": "post002",
            "title": "Company forcing return to office",
            "subreddit": "antiwork",
            "upvotes": 4123,
            "comments": 734,
            "created": "2024-01-22T11:30:00Z"
          }
        ],
        "trend_score": 87.2,
        "growth_rate": 156.8
      }
    ],
    "total": 2,
    "date_range": {
      "start": "2024-01-01",
      "end": "2024-01-31"
    },
    "processing_time_ms": 567
  }
}

Rate Limits & Pricing

API access is available for Pro and Enterprise subscribers. Each plan includes different rate limits and quotas.

Plan	Monthly Quota	Rate Limit
Free	100 requests/hour	N/A - API not available
Pro	10000 requests/month	60 requests/minute
Enterprise	Unlimited	Custom limits

Rate Limit Headers

All paid API responses include rate limit information in the headers: X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.

Ready to Get Started?

Get Your API Key