// DEVELOPER_DOCS

Developer Documentation

› integrate reddit insights into your applications with our restful api

▶ mcp_server /claude_skill

// QUICK_START [ readme ]

› get started with the reddapi.dev Reddit Search API api in minutes · all endpoints require authentication

// AUTHENTICATION

Authorization: Bearer YOUR_API_KEY

// BASE_URL

https://reddapi.dev/v1

// INFO · GET_API_KEY

› api keys are available in your account dashboard after subscribing. each api call counts toward your monthly quota.

// AGENT_SKILL [ install ]

› add the reddapi.dev Reddit Search API skill to your ai coding agent for instant access

// VIA_CLI

› use the skills cli to install into claude code

› ~/ $

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

› view_full_docs

// VIA_OPENCLAW

› browse and install from the openclaw marketplace

/view_on_openclaw ↗

› clawhub.ai/dowands/reddapi

// INFO · ABOUT_SKILLS

› agent skills are portable packages that give ai agents access to external apis. once installed, your agent can use reddapi.dev Reddit Search API endpoints to search reddit, analyze sentiment, and discover trends.

// INTERACTIVE_EXPLORER

API Explorer

// WARN · QUOTA_USAGE

› requests made through this explorer will count against your plan's quota.

// API_EXPLORER

› loading_api_explorer...

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

› language::bash[ readonly ]

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

› response.json [ readonly ]

{
  "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

› language::bash[ readonly ]

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

› response.json [ readonly ]

{
  "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

› Named entities (products, people, games, shows, events) extracted daily from each day's top posts, aggregated over a date window and compared with the equal-length window before it. Ranked by engagement; growth_rate is the change in mentions between the two windows.

// REQUEST_EXAMPLE

› language::bash[ readonly ]

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

// RESPONSE_EXAMPLE

› response.json [ readonly ]

{
  "success": true,
  "data": {
    "trends": [
      {
        "id": "trend_gta_6",
        "topic": "GTA 6",
        "kind": "game",
        "post_count": 41,
        "prior_post_count": 12,
        "growth_rate": 241.7,
        "total_upvotes": 45632,
        "total_comments": 8934,
        "days_active": 15,
        "first_seen": "2026-08-02",
        "top_subreddits": [
          "gaming",
          "GTA6",
          "pcgaming"
        ],
        "trending_keywords": [
          "trailer",
          "delay",
          "leak",
          "release",
          "rockstar"
        ],
        "sample_posts": [
          {
            "id": "1n2abcd",
            "title": "GTA 6 trailer 3 breakdown",
            "subreddit": "gaming",
            "upvotes": 5432,
            "comments": 892,
            "created": "2026-08-15T09:00:00Z"
          }
        ],
        "trend_score": 30952.8
      },
      {
        "id": "trend_jaylen_brown",
        "topic": "Jaylen Brown",
        "kind": "person",
        "post_count": 9,
        "prior_post_count": 0,
        "growth_rate": null,
        "total_upvotes": 12145,
        "total_comments": 2621,
        "days_active": 3,
        "first_seen": "2026-08-14",
        "top_subreddits": [
          "nba",
          "bostonceltics"
        ],
        "trending_keywords": [
          "trade",
          "windhorst",
          "celtics",
          "report"
        ],
        "sample_posts": [
          {
            "id": "1n3efgh",
            "title": "[Windhorst] Celtics listening to offers for Jaylen Brown",
            "subreddit": "nba",
            "upvotes": 4123,
            "comments": 734,
            "created": "2026-08-14T11:30:00Z"
          }
        ],
        "trend_score": 8335.4
      }
    ],
    "total": 2,
    "date_range": {
      "start": "2026-08-01",
      "end": "2026-08-18"
    },
    "prior_date_range": {
      "start": "2026-07-14",
      "end": "2026-07-31"
    },
    "coverage": {
      "days_requested": 18,
      "days_with_data": 18,
      "latest_day": "2026-08-18"
    },
    "processing_time_ms": 567
  }
}

POST /api/v1/leads [paid] api

› Lead Generation

› Find business leads and opportunities from Reddit discussions. Uses AI to score and classify posts based on buying intent, pain points, and solution requests.

// REQUEST_EXAMPLE

› language::bash[ readonly ]

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": 10,
  "min_score": 60
}'

// RESPONSE_EXAMPLE

› response.json [ readonly ]

{
  "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"
      },
      {
        "id": "lead002",
        "title": "What are people using instead of Monday.com?",
        "content": "Monday.com's UI is too cluttered. Need something simpler for a small marketing agency...",
        "subreddit": "smallbusiness",
        "author": "agency_owner_22",
        "upvotes": 156,
        "comments": 67,
        "lead_score": 88,
        "lead_type": "solution_request",
        "pain_point": "UX/UI - interface too complex",
        "opportunity": "Simple project management tool for small agencies",
        "industry": "Marketing / Professional Services",
        "target_product": "Monday.com",
        "url": "https://reddit.com/r/smallbusiness/comments/lead002"
      }
    ],
    "total": 2,
    "processing_time_ms": 840
  }
}

// RATE_LIMITS [ 5 tiers ]

› api access is available on every plan, including free · each plan has different limits

// PLAN	// MONTHLY_QUOTA	// RATE_LIMIT
Free	3 calls / 7 days	3 req/min
Lite	500 requests/month	50 req/min
Starter	5000 requests/month	50 req/min
Pro	15000 requests/month	100 req/min
Enterprise	Unlimited	1000 req/min

// INFO · RATE_LIMIT_HEADERS

› all paid api responses include: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

// CTA · GET_STARTED

Ready to get started?

› sign up to get your api key and start building

▶ get_api_key