Reddit Insights
Semantic search across millions of Reddit posts. Unlike keyword search, this understands intent and meaning.
Powered by reddapi.dev — AI-powered semantic search and vector similarity across 1000+ subreddits with millions of indexed posts, updated continuously.
Key Advantage:
- - ✅ Two search modes - Semantic (AI summary) + Vector (fast similarity)
- ✅ Full Reddit archive - Access historical and real-time discussions
- ✅ AI summaries - Semantic search generates comprehensive summaries
- ✅ MCP support - Direct integration with Claude Desktop, Cursor, etc.
Setup
Get API Key
- 1. Create an account at https://reddapi.dev
- Subscribe to a paid plan (Lite $9.90/mo, Starter $49/mo, Pro $99/mo, or Enterprise)
- Go to https://reddapi.dev/account to view or generate your API key
Environment Variable
CODEBLOCK0
Rate Limits
| Plan | Monthly API Calls | Per Minute |
|---|
| Lite | 500 | 50 |
| Starter |
5,000 | 50 |
| Pro | 15,000 | 100 |
| Enterprise | Unlimited | 1,000 |
HTTP API Reference
Base URL: INLINECODE0
Authentication: All requests require header:
Authorization: Bearer YOUR_API_KEY
POST /api/v1/search/semantic
AI-powered semantic search with keyword extraction, vector search, and AI summary generation.
CODEBLOCK2
| Parameter | Type | Required | Description |
|---|
| query | string | Yes | Natural language question |
| limit |
number | No | Results to return (default: 20, max: 100) |
Response:
{
"success": true,
"data": {
"query": "What do developers think about Rust vs Go for backend services?",
"results": [
{
"id": "1abc234",
"title": "Switched our microservices from Go to Rust - here's what happened",
"content": "After 6 months of running Go in production...",
"subreddit": "rust",
"upvotes": 847,
"comments": 234,
"created": "2026-02-15T10:30:00.000Z",
"relevance": 0.92,
"sentiment": "Discussion",
"url": "https://reddit.com/r/rust/comments/1abc234"
}
],
"total": 20,
"processing_time_ms": 12450,
"ai_summary": "Developers are divided on Rust vs Go for backend services..."
}
}
POST /api/v1/search/vector
Fast vector similarity search. No LLM processing, returns results in seconds.
CODEBLOCK4
| Parameter | Type | Required | Description |
|---|
| query | string | Yes | Search query |
| limit |
number | No | Results to return (default: 30, max: 30) |
| start_date | string | No | Start date filter (YYYY-MM-DD) |
| end_date | string | No | End date filter (YYYY-MM-DD) |
Response:
{
"success": true,
"data": {
"query": "best productivity apps for ADHD",
"results": [
{
"id": "2def567",
"title": "Finally found an app that works for my ADHD brain",
"content": "I've tried everything from Todoist to Notion...",
"subreddit": "ADHD",
"upvotes": 1203,
"comments": 456,
"created": "2026-03-01T14:22:00.000Z",
"similarity_score": 0.89,
"url": "https://reddit.com/r/ADHD/comments/2def567"
}
],
"total": 30,
"processing_time_ms": 3200
}
}
GET /api/v1/subreddits
List available subreddits with metadata, sorted by subscribers.
CODEBLOCK6
| Parameter | Type | Required | Description |
|---|
| search | string | No | Filter by name/title/description |
| page |
number | No | Page number (default: 1) |
| limit | number | No | Results per page (default: 50, max: 100) |
| sort | string | No | Sort by "subscribers" or "created" (default: subscribers) |
| order | string | No | "asc" or "desc" (default: desc) |
GET /api/v1/subreddits/{name}
Get detailed information about a specific subreddit with recent posts.
CODEBLOCK7
| Parameter | Type | Required | Description |
|---|
| name | string | Yes | Subreddit name without r/ prefix |
POST /api/v1/trends
Get trending topics from Reddit based on post engagement.
CODEBLOCK8
| Parameter | Type | Required | Description |
|---|
| startdate | string | No | Start date (default: today) |
| enddate |
string | No | End date (default: today) |
| limit | number | No | Topics to return (default: 20, max: 100) |
MCP Server
reddapi.dev also provides a Model Context Protocol (MCP) server for direct integration with AI clients.
Endpoint: https://reddapi.dev/api/mcp
Protocol: MCP Streamable HTTP Transport
CODEBLOCK9
MCP tools: reddit_semantic_search, reddit_vector_search, reddit_list_subreddits, reddit_get_subreddit, reddit_get_trends
Choosing Between Semantic and Vector Search
| Use Case | Recommended | Why |
|---|
| Exploratory research | Semantic | LLM extracts keywords, generates summary |
| Known-topic monitoring |
Vector | Faster, direct matching, no LLM overhead |
| Batch processing | Vector | 5x faster per request |
| Answering complex questions | Semantic | AI summary synthesizes insights |
| Real-time dashboards | Vector | Low latency (~5s vs ~20s) |
Best Use Cases (Tested)
| Use Case | Effectiveness | Why |
|---|
| Product comparisons (A vs B) | ⭐⭐⭐⭐⭐ | Reddit loves debates |
| Tool/app recommendations |
⭐⭐⭐⭐⭐ | High-intent discussions |
| Side hustle/money topics | ⭐⭐⭐⭐⭐ | Engaged communities |
| Pain point discovery | ⭐⭐⭐⭐ | Emotional posts rank well |
| Health questions | ⭐⭐⭐⭐ | Active health subreddits |
| Technical how-to | ⭐⭐⭐ | Better to search specific subreddits |
| Abstract market research | ⭐⭐ | Too vague for semantic search |
| Non-English queries | ⭐ | Reddit is English-dominant |
Query Strategies
✅ Excellent Queries (relevance 0.70+)
Product Comparisons (best results!):
CODEBLOCK10
Side Hustle/Money Topics:
CODEBLOCK11
✅ Good Queries (relevance 0.60-0.69)
Pain Point Discovery:
CODEBLOCK12
Tool Evaluation:
CODEBLOCK13
❌ Weak Queries (avoid these patterns)
Too Abstract: "business opportunity growth potential" → 0.52-0.58
Non-English: "学习编程最好的方法" → 0.45-0.51
Query Formula Cheat Sheet
| Goal | Pattern | Relevance |
|---|
| Compare products | "[A] vs [B] which should I use" | 0.70-0.81 |
| Find switchers |
"why I switched from [A] to [B]" | 0.70-0.73 |
| Money/hustle topics | "[topic] that actually [works/makes money] not [scam/hype]" | 0.70-0.77 |
| App recommendations | "[category] apps which one is [accurate/best] and why" | 0.67-0.72 |
| Pain points | "I hate my current [tool] it is so [frustrating/slow]" | 0.60-0.64 |
| Solutions seeking | "[problem] tried everything what actually works" | 0.60-0.63 |
Example Workflows
Market Research:
CODEBLOCK14
Brand Monitoring (fast):
CODEBLOCK15
Deep Research (combine both):
- 1. Vector search first to quickly scope the landscape
- Semantic search for deep analysis on specific angles
Time-Filtered Sentiment Tracking:
CODEBLOCK16
Tips
- 1. Natural language works best - Ask questions like a human would
- Include context - "for small business" or "as a developer" improves results
- Combine emotion words - "frustrated", "love", "hate", "wish" find stronger opinions
- Filter by engagement - High upvotes/comments = validated pain points
- Use vector search for speed - ~5s vs ~20s for semantic
- Use date filters - Track sentiment changes over time periods
Error Handling
All endpoints return consistent error responses:
CODEBLOCK17
Common status codes: 400 (invalid params), 401 (bad API key), 403 (plan limit), 429 (rate limit), 500 (server error)
Reddit Insights
在数百万条Reddit帖子中进行语义搜索。与关键词搜索不同，它能理解意图和含义。
由 reddapi.dev 提供技术支持 — 基于AI的语义搜索和向量相似度，覆盖1000+子版块，数百万条已索引帖子，持续更新。
核心优势：
- - ✅ 两种搜索模式 - 语义搜索（AI摘要）+ 向量搜索（快速相似度匹配）
- ✅ 完整Reddit存档 - 访问历史和实时讨论
- ✅ AI摘要 - 语义搜索生成全面摘要
- ✅ MCP支持 - 直接集成Claude Desktop、Cursor等
设置
获取API密钥
- 1. 在 https://reddapi.dev 创建账户
- 订阅付费计划（Lite $9.90/月，Starter $49/月，Pro $99/月，或企业版）
- 前往 https://reddapi.dev/account 查看或生成您的API密钥
环境变量
bash
export REDDAPI
APIKEY=your
apikey
速率限制
| 计划 | 每月API调用次数 | 每分钟调用次数 |
|---|
| Lite | 500 | 50 |
| Starter |
5,000 | 50 |
| Pro | 15,000 | 100 |
| 企业版 | 无限制 | 1,000 |
HTTP API参考
基础URL： https://reddapi.dev
认证： 所有请求需包含请求头：
Authorization: Bearer YOURAPIKEY
POST /api/v1/search/semantic
基于AI的语义搜索，包含关键词提取、向量搜索和AI摘要生成。
bash
curl -X POST https://reddapi.dev/api/v1/search/semantic \
-H Authorization: Bearer YOURAPIKEY \
-H Content-Type: application/json \
-d {query: What do developers think about Rust vs Go for backend services?, limit: 20}
| 参数 | 类型 | 必填 | 描述 |
|---|
| query | string | 是 | 自然语言问题 |
| limit |
number | 否 | 返回结果数（默认：20，最大：100） |
响应：
json
{
success: true,
data: {
query: What do developers think about Rust vs Go for backend services?,
results: [
{
id: 1abc234,
title: Switched our microservices from Go to Rust - heres what happened,
content: After 6 months of running Go in production...,
subreddit: rust,
upvotes: 847,
comments: 234,
created: 2026-02-15T10:30:00.000Z,
relevance: 0.92,
sentiment: Discussion,
url: https://reddit.com/r/rust/comments/1abc234
}
],
total: 20,
processingtimems: 12450,
ai_summary: Developers are divided on Rust vs Go for backend services...
}
}
POST /api/v1/search/vector
快速向量相似度搜索。无需LLM处理，数秒内返回结果。
bash
curl -X POST https://reddapi.dev/api/v1/search/vector \
-H Authorization: Bearer YOURAPIKEY \
-H Content-Type: application/json \
-d {query: best productivity apps for ADHD, limit: 30, startdate: 2026-01-01, enddate: 2026-03-18}
| 参数 | 类型 | 必填 | 描述 |
|---|
| query | string | 是 | 搜索查询 |
| limit |
number | 否 | 返回结果数（默认：30，最大：30） |
| start_date | string | 否 | 开始日期筛选（YYYY-MM-DD） |
| end_date | string | 否 | 结束日期筛选（YYYY-MM-DD） |
响应：
json
{
success: true,
data: {
query: best productivity apps for ADHD,
results: [
{
id: 2def567,
title: Finally found an app that works for my ADHD brain,
content: Ive tried everything from Todoist to Notion...,
subreddit: ADHD,
upvotes: 1203,
comments: 456,
created: 2026-03-01T14:22:00.000Z,
similarity_score: 0.89,
url: https://reddit.com/r/ADHD/comments/2def567
}
],
total: 30,
processingtimems: 3200
}
}
GET /api/v1/subreddits
列出可用子版块及其元数据，按订阅者数排序。
bash
curl https://reddapi.dev/api/v1/subreddits?search=programming&limit=10 \
-H Authorization: Bearer YOURAPIKEY
| 参数 | 类型 | 必填 | 描述 |
|---|
| search | string | 否 | 按名称/标题/描述筛选 |
| page |
number | 否 | 页码（默认：1） |
| limit | number | 否 | 每页结果数（默认：50，最大：100） |
| sort | string | 否 | 按subscribers或created排序（默认：subscribers） |
| order | string | 否 | asc或desc（默认：desc） |
GET /api/v1/subreddits/{name}
获取特定子版块的详细信息及近期帖子。
bash
curl https://reddapi.dev/api/v1/subreddits/webdev \
-H Authorization: Bearer YOURAPIKEY
| 参数 | 类型 | 必填 | 描述 |
|---|
| name | string | 是 | 子版块名称，不含r/前缀 |
POST /api/v1/trends
基于帖子互动量获取Reddit热门话题。
bash
curl -X POST https://reddapi.dev/api/v1/trends \
-H Authorization: Bearer YOURAPIKEY \
-H Content-Type: application/json \
-d {startdate: 2026-03-11, enddate: 2026-03-18, limit: 20}
| 参数 | 类型 | 必填 | 描述 |
|---|
| startdate | string | 否 | 开始日期（默认：今天） |
| enddate |
string | 否 | 结束日期（默认：今天） |
| limit | number | 否 | 返回话题数（默认：20，最大：100） |
MCP服务器
reddapi.dev还提供模型上下文协议（MCP）服务器，用于直接集成AI客户端。
端点： https://reddapi.dev/api/mcp
协议： MCP可流式HTTP传输
json
{
mcpServers: {
reddit-search-api: {
transport: {
type: http,
url: https://reddapi.dev/api/mcp,
headers: {
Authorization: Bearer YOURAPIKEY
}
}
}
}
}
MCP工具：redditsemanticsearch、redditvectorsearch、redditlistsubreddits、redditgetsubreddit、redditgettrends
语义搜索与向量搜索的选择
| 使用场景 | 推荐方式 | 原因 |
|---|
| 探索性研究 | 语义搜索 | LLM提取关键词，生成摘要 |
| 已知主题监控 |
向量搜索 | 更快，直接匹配，无LLM开销 |
| 批量处理 | 向量搜索 | 每次请求快5倍 |
| 回答复杂问题 | 语义搜索 | AI摘要综合洞察 |
| 实时仪表盘 | 向量搜索 | 低延迟（~5秒 vs ~20秒） |
最佳使用场景（已验证）
| 使用场景 | 效果 | 原因 |
|---|
| 产品对比（A vs B） | ⭐⭐⭐⭐⭐ | Reddit热衷辩论 |
| 工具/应用推荐 |
⭐⭐⭐⭐⭐ | 高意图讨论 |
| 副业/赚钱话题 | ⭐⭐⭐⭐⭐ | 社区活跃度高 |
| 痛点
