Reddit 讨论搜索

用 Reddit 搜索 API 检索帖子与讨论

通过 HTTP 检索 Reddit 帖子，每条结果直接带上子版块和作者，不需要注册 OAuth 应用，也不用处理 Reddit 的速率限制。

接口
POST https://api.search1api.com/search
Reddit 搜索结果包含什么

结果的 JSON 结构与其他引擎一致，现有的解析逻辑不需要改动。

1
帖子标题与链接

链接指向 reddit.com 上的原帖。

2
子版块与作者

摘要以 r/子版块 和 /u/ 作者名开头。

3
帖子正文

摘要的其余部分是帖子内容。

适用于

产品调研 / 舆情分析 / 客服排查

带出处的社区真实讨论

把 `search_service` 设为 `reddit`，结果就来自 Reddit 帖子。接口地址、鉴权方式和响应结构与其他引擎完全一致，整个过程不涉及 Reddit 的 OAuth 应用。

摘要里直接带社区名

`snippet` 字段的格式为「r/子版块 | /u/作者 | 正文」，不用再发一次请求就能拿到社区和发帖人。

搜的是真实意见所在的地方

Reddit 的帖子里有厂商页面上没有的实际比较和真话，而调研类问题往往问的正是这个。

不需要注册 OAuth 应用

请求按 Search1API 积分计费，不需要管理 Reddit 的 client ID、refresh token 和按应用的速率限制。

标准 Search 参数

`max_results` 最大 50，以及 `include_sites`、`exclude_sites`、`time_range`。

什么是 Reddit 搜索 API？

Reddit 搜索 API 是一种 HTTP 接口，把 Reddit 帖子以结构化结果返回。Reddit 自己也有 API，但需要注册 OAuth 应用，对第三方客户端的使用条款经历过大幅调整，返回的 listing 格式在喂给模型之前还要先重整。Search1API 把 Reddit 作为 Search 接口的一个搜索服务提供，返回帖子标题、原帖链接，以及带子版块和作者的摘要，JSON 结构与其他引擎一致。这一点对调研类流程很重要：意见来自哪个社区，本身通常就是答案的一部分，而不是附加的元信息。

接入路径

典型流程

通过 HTTP 检索 Reddit 帖子，每条结果直接带上子版块和作者，不需要注册 OAuth 应用，也不用处理 Reddit 的速率限制。

1

把 `search_service` 设为 `reddit` 后发送查询。

2

按竖线切分 `snippet`，分离出子版块、作者和正文。

3

当流程需要整个讨论串而不只是主贴时，设置 `crawl_results`。

一次请求，带社区出处的讨论

一次调用即可检索 Reddit 帖子，每条结果带上子版块和作者，引用时可以标明来自哪个社区。

bash
curl -X POST https://api.search1api.com/search \
  -H "Authorization: Bearer $SEARCH1API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best local llm",
    "search_service": "reddit",
    "max_results": 5
  }'

适合场景

需要真实比较而不是厂商说辞的产品调研。

围绕品牌或版本发布的舆情与社区监控。

排查是否有其他用户遇到同一故障的客服流程。

需要标明意见来自哪个社区的 AI 助手。

下一步链接

一个接口支持 17 个搜索引擎

X 搜索 API
GitHub 搜索 API
YouTube 搜索 API
搜索 API
查看 API 文档
查看定价

常见问题

和 Reddit 官方 API 有什么区别？

Reddit 自己的 API 需要注册 OAuth 应用并管理客户端凭证，返回的 listing 结构使用前还要重整。Search1API 按自己的积分计费，不需要注册 Reddit 应用，返回的是摘要里已经带好子版块和作者的紧凑结果。

需要 Reddit 账号或 OAuth 应用吗？

不需要。鉴权用的是 Search1API 的 key。请求是向 https://api.search1api.com/search 发 POST，把 `search_service` 设为 `reddit`。

可以拿到整个讨论串的正文吗？

可以。把 `crawl_results` 设为需要抓取的结果数量，成功抓取的页面会包含 `content` 字段，内容是 markdown 格式的正文。抓取失败的结果不返回 `content`，也不计费。

Reddit 搜索的费用是多少？

每次搜索消耗 1 积分，通过 `crawl_results` 每成功抓取一个页面追加 1 积分。按 $1 = 1,000 积分的充值基础价计算，1,000 次搜索为 $1。注册即送 100 个免费积分，无需信用卡。

可以限定在某一个子版块吗？

按域名收窄可以用 `include_sites`；需要指定某个具体子版块时，把社区名写进查询词里。子版块也会在摘要中返回，因此也可以在拿到结果之后再过滤。

还支持哪些社区类来源？

同一个 Search 接口还支持帖子的 `x`、仓库的 `github` 和视频的 `youtube`，加上通用网页引擎和中文引擎，一套契约共 17 个引擎。