Reddit 洞察

面向数百万 Reddit 帖子的语义搜索。与关键词搜索不同，该能力可理解用户意图与语义内涵。

由 reddapi.dev 提供支持 —— 基于 AI 的语义搜索与向量相似度检索，覆盖 1000+ 个 subreddit，索引帖子达数百万篇，并持续实时更新。

核心优势：

• ✅ 双搜索模式 —— 语义搜索（AI 摘要） + 向量搜索（快速相似度匹配）
• ✅ 完整 Reddit 归档 —— 支持访问历史讨论与实时内容
• ✅ AI 摘要生成 —— 语义搜索自动产出全面、凝练的摘要
• ✅ MCP 支持 —— 可直接集成至 Claude Desktop、Cursor 等客户端

配置说明

获取 API 密钥

1. 在 https://reddapi.dev 注册账户
2. 订阅付费方案（Lite：9.90 美元/月；Starter：49 美元/月；Pro：99 美元/月；Enterprise：企业定制）
3. 访问 https://reddapi.dev/account 查看或生成您的 API 密钥

环境变量

export REDDAPI_API_KEY="your_api_key"

速率限制

HTTP API 参考文档

基础 URL： 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": "开发者如何看待 Rust 与 Go 在后端服务中的对比？", "limit": 20}'

响应示例：

{
  "success": true,
  "data": {
    "query": "开发者如何看待 Rust 与 Go 在后端服务中的对比？",
    "results": [
      {
        "id": "1abc234",
        "title": "我们将微服务从 Go 迁移到 Rust —— 实际发生了什么",
        "content": "在生产环境中运行 Go 六个月后...",
        "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": "开发者对 Rust 与 Go 在后端服务中的适用性存在分歧..."
  }
}

POST /api/v1/search/vector

高速向量相似度搜索。不经过大语言模型处理，秒级返回结果。

curl -X POST "https://reddapi.dev/api/v1/search/vector" 
  -H "Authorization: Bearer YOUR_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"query": "最适合 ADHD 人群提升效率的应用有哪些？", "limit": 30, "start_date": "2026-01-01", "end_date": "2026-03-18"}'

响应示例：

{
  "success": true,
  "data": {
    "query": "最适合 ADHD 人群提升效率的应用有哪些？",
    "results": [
      {
        "id": "2def567",
        "title": "终于找到了一款真正适配我 ADHD 大脑的应用",
        "content": "我尝试过 Todoist、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

按订阅人数排序，列出所有可用 subreddit 及其元数据。

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

GET /api/v1/subreddits/{name}

获取指定 subreddit 的详细信息及最新帖子列表。

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 Streamable HTTP Transport

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

语义搜索 vs 向量搜索：如何选择

经实测验证的最佳应用场景

查询策略指南

✅ 高效查询（相关性 ≥ 0.70）

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

"Notion 与 Obsidian 在笔记管理方面的对比，我该选哪一个？"
→ 相关性：0.72–0.81 | 检索结果：详尽对比讨论、真实用户经验

"为何我从 Salesforce 切换到 HubSpot？真实经历分享"
→ 相关性：0.70–0.73 | 检索结果：迁移案例、功能对比分析

副业 / 收入类话题：

"真正能赚钱而非骗局的副业点子有哪些？"
→ 相关性：0.70–0.77 | 检索结果：真实收益案例、具体可行建议

✅ 中效查询（相关性 0.60–0.69）

痛点挖掘类：

"我讨厌当前使用的 CRM，它实在太令人沮丧了"
→ 相关性：0.60–0.64 | 检索结果：CRM 特定槽点、功能需求清单

工具评估类：

"真正能节省时间而非仅靠炒作的 AI 工具有哪些？"
→ 相关性：0.64–0.65 | 检索结果：实际提效证据、工具推荐

❌ 低效查询（应避免的模式）

过于抽象： "商业机会增长潜力" → 相关性：0.52–0.58
非英语查询： "学习编程最好的方法" → 相关性：0.45–0.51

查询公式速查表

典型工作流示例

市场调研：

curl -X POST https://reddapi.dev/api/v1/search/semantic 
  -H "Authorization: Bearer YOUR_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"query": "对项目管理工具感到困扰，正考虑从 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 评价 投诉", "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 质量", "start_date": "2026-01-01", "end_date": "2026-03-18"}'

实用技巧

1. 自然语言效果最佳 —— 像真人一样提问
2. 补充上下文信息 —— 如添加 “面向中小企业” 或 “作为开发者”，可显著提升结果质量
3. 结合情感化词汇 —— 使用 “沮丧”、“喜爱”、“痛恨”、“希望” 等词，更容易定位强烈观点
4. 依据互动数据筛选 —— 高赞 / 高评帖往往代表已被验证的真实痛点
5. 优先使用向量搜索提速 —— 平均耗时约 5 秒，远低于语义搜索的约 20 秒
6. 善用日期筛选 —— 可用于追踪特定时间段内舆情趋势变化

错误处理

所有接口均返回结构一致的错误响应：

{
  "success": false,
  "error": "错误描述",
  "message": {
    "title": "人类可读标题",
    "message": "详细说明",
    "cta": "建议操作",
    "ctaLink": "/pricing"
  }
}

常见状态码：400（参数无效）、401（API 密钥错误）、403（超出套餐额度）、429（触发速率限制）、500（服务端异常）