Reddit Subreddit Search API

Reddit Subreddit Search

主要特性

• 指定社区精准检索将搜索范围精准限制在所提供的 /r/{subreddit} 社区之内，彻底规避跨板块噪音干扰。
• 多样化排序维度支持按相关度（relevance）、热门（hot）、最高赞（top）、最新（new）或讨论量（comments）排列结果。
• 时间窗口筛选提供 1 小时内、当天、当周、当月、近一年或全历史（all）的时间区间过滤能力。
• 丰富帖子元数据统一返回包含帖子标题、正文、作者身份、点赞数、评论数及永久访问链接的标准化结构。

参数

如何使用

提交搜索词与目标社区链接列表作为异步任务，并轮询分页获取命中的帖子。

1. 在 query 中填写关键词，并在 urls 中提供目标 /r/{subreddit} 链接。
2. 按需选填 sort_by 排序指标和 published_within 时间区间。
3. 向 /v1/reddit/subreddit-search 发送 POST 请求。
4. 轮询 /v1/tasks/{task_id} 直至状态为 succeeded，并使用 next_cursor 继续分页。

curl -X POST "https://api.socq.ai/v1/reddit/subreddit-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"AI agents","urls":["https://www.reddit.com/r/technology/"],"results_limit":20,"sort_by":"relevance"}'

# 轮询 GET /v1/tasks/{task_id}，解析 data.results.items 中的版内帖子。

最佳使用场景

• 垂直社群口碑定向监测： 定期在核心技术、游戏或金融版块搜索品牌与产品关键词，沉淀高质量的第一手用户评价。
• 痛点与求助问题挖掘： 在特定行业社区内检索报错、疑难求助或竞品对比帖子，发现真实用户的未满足需求。
• 高价值垂直论战研究： 通过按评论数（comments）倒序排列搜索结果，快速找到观点碰撞激烈的高热度长帖。

使用建议

• urls 参数必须填写完整的 /r/{subreddit} 格式链接，后端会自动解析出准确的版块名称。
• 当只需研究特定圈子内部的讨论而不想被全站海量低质帖干扰时，优先使用此接口而非全局 Reddit Search。
• 按 comments 排序能迅速挑出争议性高、互动密集的讨论贴，适合做深入舆情剖析。
• 搜索出关键帖子后，可搭配 Reddit Comments 接口获取该帖下面的全部跟帖评论树。

相关 API