Reddit Insights

跨数百万 Reddit 帖子的语义搜索。与关键词搜索不同，此功能可理解意图和语义。

由 [reddapi.dev](https://reddapi.dev) 提供支持 —— 基于 AI 的语义搜索与向量相似性分析，覆盖 1000+ 个子版块，数百万条已索引帖子，持续更新。

核心优势：

• ✅ 两种搜索模式 - 语义（AI 摘要） + 向量（快速相似性）
• ✅ 完整 Reddit 归档 - 可访问历史与实时讨论
• ✅ AI 摘要生成 - 语义搜索自动生成全面摘要
• ✅ 支持 MCP - 可直接集成 Claude Desktop、Cursor 等工具

设置

获取 API 密钥

1. 访问 https://reddapi.dev 注册账户
2. 选择付费计划（基础版 $9.90/月，入门版 $49/月，专业版 $99/月，企业版）
3. 进入 https://reddapi.dev/account 查看或生成你的 API 密钥

环境变量

export REDDAPI_API_KEY="your_api_key"

速率限制

HTTP API 参考

基础地址： https://reddapi.dev

认证方式： 所有请求需包含以下头部：

Authorization: Bearer YOUR_API_KEY

POST /api/v1/search/semantic

基于 AI 的语义搜索，支持关键词提取、向量搜索及 AI 摘要生成。

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 developers think about Rust vs Go for backend services?", "limit": 20}'

响应示例：

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

快速向量相似性搜索。无需 LLM 处理，结果可在秒级返回。

curl -X POST "https://reddapi.dev/api/v1/search/vector" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "best productivity apps for ADHD", "limit": 30, "start_date": "2026-01-01", "end_date": "2026-03-18"}'

响应示例：

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

列出可用子版块及其元数据，按关注人数排序。

curl "https://reddapi.dev/api/v1/subreddits?search=programming&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /api/v1/subreddits/{name}

获取特定子版块的详细信息及最近帖子。

curl "https://reddapi.dev/api/v1/subreddits/webdev" \
  -H "Authorization: Bearer YOUR_API_KEY"

POST /api/v1/trends

根据帖子互动情况获取 Reddit 上的趋势话题。

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

MCP 服务器

reddapi.dev 同时提供 Model Context Protocol (MCP) 服务器，支持与 AI 客户端直接集成。

端点： https://reddapi.dev/api/mcp

协议： MCP 流式 HTTP 传输

{
  "mcpServers": {
    "reddit-search-api": {
      "transport": {
        "type": "http",
        "url": "https://reddapi.dev/api/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
}

MCP 工具：`reddit_semantic_search`、`reddit_vector_search`、`reddit_list_subreddits`、`reddit_get_subreddit`、`reddit_get_trends`

---

## 语义搜索与向量搜索的选择

| 使用场景 | 推荐方式 | 原因 |
|----------|-------------|-----|
| 探索性研究 | 语义搜索 | 大语言模型提取关键词并生成摘要 |
| 已知主题监控 | 向量搜索 | 速度更快，直接匹配，无大模型开销 |
| 批量处理 | 向量搜索 | 单次请求快 5 倍 |
| 回答复杂问题 | 语义搜索 | AI 摘要可综合提炼洞察 |
| 实时仪表盘 | 向量搜索 | 延迟低（约 5 秒 vs 约 20 秒） |

## 最佳使用场景（已验证）

| 使用场景 | 有效性 | 原因 |
|----------|--------------|-----|
| 产品对比（A 对比 B） | ⭐⭐⭐⭐⭐ | Reddit 用户热衷于辩论 |
| 工具/应用推荐 | ⭐⭐⭐⭐⭐ | 高意图讨论活跃 |
| 副业/赚钱话题 | ⭐⭐⭐⭐⭐ | 社区参与度高 |
| 痛点发现 | ⭐⭐⭐⭐ | 情绪化内容排名靠前 |
| 健康类问题 | ⭐⭐⭐⭐ | 健康类子版块活跃 |
| 技术操作指南 | ⭐⭐⭐ | 更建议直接搜索具体子版块 |
| 抽象市场调研 | ⭐⭐ | 语义搜索难以处理过于模糊的问题 |
| 非英文查询 | ⭐ | Reddit 以英语为主 |

## 查询策略

### ✅ 优质查询（相关性 0.70+）

**产品对比**（效果最佳！）：

"Notion vs Obsidian for note taking which one should I use"

→ 相关性：0.72-0.81 | 找到：详细的对比讨论、用户实际体验

"why I switched from Salesforce to HubSpot honest experience"

→ 相关性：0.70-0.73 | 找到：迁移故事、功能对比

**副业/赚钱话题：**

"side hustle ideas that actually make money not scams"

→ 相关性：0.70-0.77 | 找到：真实经验分享、具体建议

### ✅ 良好查询（相关性 0.60-0.69）

**痛点发现：**

"I hate my current CRM it is so frustrating"

→ 相关性：0.60-0.64 | 找到：具体的 CRM 抱怨、功能改进建议

**工具评估：**

"AI tools that actually save time not just hype"

→ 相关性：0.64-0.65 | 找到：真实的效率提升、工具推荐

### ❌ 弱查询（避免此类模式）

**过于抽象：** "business opportunity growth potential" → 0.52-0.58
**非英文查询：** "学习编程最好的方法" → 0.45-0.51

### 查询公式速查表

| 目标 | 模式 | 相关性 |
|------|---------|-----------|
| 产品对比 | "[A] vs [B] which should I use" | 0.70-0.81 |
| 寻找转换者 | "why I switched from [A] to [B]" | 0.70-0.73 |
| 赚钱/副业话题 | "[主题] that actually [有效/赚钱] not [骗局/炒作]" | 0.70-0.77 |
| 应用推荐 | "[类别] apps which one is [准确/最好] and why" | 0.67-0.72 |
| 痛点表达 | "I hate my current [工具] it is so [令人沮丧/缓慢]" | 0.60-0.64 |
| 寻求解决方案 | "[问题] tried everything what actually works" | 0.60-0.63 |

## 示例工作流

**市场研究：**

curl -X POST https://reddapi.dev/api/v1/search/semantic \

-H "Authorization: Bearer YOUR_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "frustrated with project management tools switching from Jira", "limit": 50}'

**品牌监控（快速）：**

curl -X POST https://reddapi.dev/api/v1/search/vector \

-H "Authorization: Bearer YOUR_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "your-brand-name reviews complaints", "limit": 30}'

**深度研究（结合两种方式）：**
1. 先使用向量搜索快速梳理整体情况
2. 再对特定角度使用语义搜索进行深入分析

**时间过滤的情感追踪：**

curl -X POST https://reddapi.dev/api/v1/search/vector \

-H "Authorization: Bearer YOUR_API_KEY" \

-H "Content-Type: application/json" \

-d '{"query": "ChatGPT quality", "start_date": "2026-01-01", "end_date": "2026-03-18"}'

## 使用建议

1. **自然语言最有效** —— 像人类一样提问
2. **加入上下文信息** —— 如“for small business”或“as a developer”可提升结果质量
3. **结合情绪词汇** —— “frustrated”、“love”、“hate”、“wish”等词更容易捕捉强烈观点
4. **关注互动量** —— 高点赞数和评论数 = 经过验证的痛点
5. **优先使用向量搜索** —— 响应速度约 5 秒，远快于语义搜索的约 20 秒
6. **使用日期筛选** —— 可追踪情感随时间的变化趋势

## 错误处理

所有接口返回统一的错误格式：

{

"success": false,

"error": "错误描述",

"message": {

"title": "可读性标题",

"message": "详细解释",

"cta": "建议操作",

"ctaLink": "/pricing"

}

}

常见状态码：`400`（参数无效）、`401`（API 密钥错误）、`403`（套餐限制）、`429`（速率限制）、`500`（服务器错误）