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 paid plan. Each API call counts toward your monthly quota based on your subscription tier.

Install as Agent Skill

Add the reddapi.dev Reddit Search API skill to your AI coding agent for instant access to Reddit search, subreddit data, and trend analysis directly in your workflow.

Install via CLI

Use the Skills CLI to install the skill into Claude Code or other compatible agents:

npx skills add https://reddapi.dev reddit-search-api

View full skill documentation →

Install via OpenClaw

Browse and install from the OpenClaw skill marketplace:

View on OpenClaw

clawhub.ai/dowands/reddapi

What are Agent Skills?

Agent Skills are portable packages that give AI coding agents access to external APIs and tools. Once installed, your agent can use reddapi.dev Reddit Search API endpoints to search Reddit, analyze sentiment, and discover trends — all through natural language.

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 llms.txt (LLM-friendly docs) Claude Code Skill

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	0 requests/month	N/A - API not available
Lite	500 requests/month	50 requests/minute
Starter	5000 requests/month	50 requests/minute
Pro	15000 requests/month	100 requests/minute
Enterprise	Unlimited	1000 requests/minute

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