Reddit社区存档2 credits

reddit_search

搜索 Reddit 帖子和评论，或读取完整评论串——完全不触碰会拦截爬虫的 reddit.com。查询 Arctic Shift 和 PullPush 社区存档：免费、近实时，且无需 Reddit API 凭据。

使用场景

品牌与产品监控

找到您的产品或公司在 Reddit 上的每一次提及，可限定相关 subreddit 或覆盖全站

市场与舆情研究

挖掘真实用户在其讨论社区中对某个品类、竞争对手或痛点的看法

面向 AI Agent 的讨论串读取

一次调用即可获取帖子及其完整的嵌套评论树——可直接用于摘要或分析

社区趋势追踪

使用 after/before 过滤器观察某个 subreddit 在一段日期范围内的讨论话题

用户研究

获取特定作者的帖子或评论，以理解专家观点和反复出现的主题

Endpoint

POST/api/v1/tools/reddit_search

Auth Required

Free 计划 1 req/s

2 credits

Parameters

Name	Type	Required	Default	Description
query	string	Optional	-	关键词搜索。posts 模式匹配标题 + 正文（selftext）；comments 模式匹配评论内容。支持 "引号短语"、OR 以及 - 排除语法 Example: best mechanical keyboard
subreddit	string	Optional	-	将结果限定在一个 subreddit（可带或不带 r/ 前缀） Example: MechanicalKeyboards
author	string	Optional	-	将结果限定为一位作者（可带或不带 u/ 前缀） Example: spez
mode	string	Optional	posts	搜索目标："posts"（默认）、"comments"，或 "thread"（帖子及其嵌套评论树——需要 link_id） Example: thread
link_id	string	Optional	-	帖子 ID（例如 "1twm1zh" 或 "t3_1twm1zh"）——thread 模式必填，comments 模式可作为可选过滤器 Example: 1twm1zh
after	string	Optional	-	仅返回此日期之后发布的内容——支持 ISO 8601、epoch 秒，或 "7d" 这样的偏移量 Example: 7d
before	string	Optional	-	仅返回此日期之前发布的内容——格式与 after 相同 Example: 2026-08-01
limit	number	Optional	25	最大结果数，1-100（thread 模式：返回的最大评论数） Example: 10
sort	string	Optional	desc	按发帖日期排序："desc"（最新在前）或 "asc" Example: desc
source	string	Optional	auto	强制指定存档后端："auto"（自动路由并回退）、"arctic_shift" 或 "pullpush" Example: auto

reddit.com 会拦截直接抓取，因此 reddit_search 完全不会访问它。限定 subreddit 或作者的搜索以及 thread 模式使用 Arctic Shift 存档（近实时）；覆盖全 Reddit 的关键词搜索则路由到 PullPush，其 2023 年之后的存档存在已知缺口。每次搜索必须至少包含 query、subreddit 或 author 之一。发布不足约 36 小时的内容，其分数和评论数可能显示为 0/1——存档在内容发布的那一刻即完成采集。

请求示例

terminalBash

curl -X POST https://crawlforge.dev/api/v1/tools/reddit_search \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best mechanical keyboard",
    "subreddit": "MechanicalKeyboards",
    "mode": "posts",
    "limit": 10
  }'

响应示例

200 OK850ms

{
  "success": true,
  "data": {
    "source": "arctic_shift",
    "mode": "posts",
    "query": "best mechanical keyboard",
    "subreddit": "MechanicalKeyboards",
    "author": null,
    "count": 2,
    "results": [
      {
        "id": "1x2y3z4",
        "title": "What's the best mechanical keyboard for programming in 2026?",
        "author": "keeb_enthusiast",
        "subreddit": "MechanicalKeyboards",
        "created_utc": 1755993600,
        "created_iso": "2026-08-24T00:00:00.000Z",
        "score": 142,
        "num_comments": 87,
        "upvote_ratio": 0.96,
        "flair": "Discussion",
        "over_18": false,
        "selftext": "After five years on membrane boards I finally want to switch...",
        "selftext_truncated": false,
        "url": "https://www.reddit.com/r/MechanicalKeyboards/comments/1x2y3z4/",
        "permalink": "https://www.reddit.com/r/MechanicalKeyboards/comments/1x2y3z4/whats_the_best_mechanical_keyboard/"
      }
    ],
    "notes": [
      "Data from the Arctic Shift community archive (arctic-shift.photon-reddit.com), not reddit.com (which blocks scrapers).",
      "Scores and comment counts of content less than ~36h old may read 0/1 — the archive captures content the moment it is posted."
    ],
    "checkedAt": "2026-08-24T14:30:00.000Z"
  },
  "credits_used": 2,
  "credits_remaining": 998,
  "processing_time": 850
}

Field Descriptions

data.source由哪个存档响应：arctic_shift（限定范围、更及时）或 pullpush（全站关键词搜索）

data.results规范化的帖子或评论，附完整 reddit.com 永久链接和 ISO 日期

data.results.selftext_truncated帖子/评论文本上限为 2,000 字符；被截断时为 true

data.notes响应存档的来源与时效性说明

credits_used每次搜索或讨论串读取固定消耗 2 credits

processing_time存档搜索通常在 2 秒内完成

错误处理

缺少搜索范围（400 Bad Request）

posts 和 comments 模式至少需要 query、subreddit 或 author 之一。thread 模式需要 link_id。

未限定范围的 Arctic Shift 搜索（400 Bad Request）

Arctic Shift 无法对全 Reddit 进行关键词搜索。请添加 subreddit 或 author 限定，或使用 source: "pullpush"。

通过 PullPush 使用 thread 模式（400 Bad Request）

thread 模式仅支持 Arctic Shift——source: "pullpush" 只支持 posts 和 comments 搜索。

日期过滤器无效（400 Bad Request）

after/before 必须为 ISO 8601、epoch 秒，或 "7d" 这样的偏移量。

存档不可用（502 Bad Gateway）

两个社区存档均失败或正在限流。错误消息会包含每个存档的具体原因。不会扣除 credits——请稍后重试。

专业提示： 尽可能将搜索限定到某个 subreddit 或作者——限定范围的查询会路由到 Arctic Shift，它比全站的 PullPush 路径更及时、更可靠。要完整读取一场讨论，请从搜索结果中取出帖子的 id，将其作为 link_id 并配合 mode: "thread" 传入。

Credit 费用

2 credits

每次搜索 2 credits

一次搜索或一次完整讨论串读取的固定费用。仅对成功的请求扣除 credits。

包含内容：

posts、comments 和完整讨论串（thread）模式

subreddit、作者和日期范围过滤器

带 reddit 风格折叠标记的嵌套评论树

每条结果均附完整 reddit.com 永久链接和 ISO 日期

无需 Reddit API 凭据

套餐推荐：

Free 套餐： 1,000 个一次性试用 credits = 500 次搜索

Hobby 套餐： 5,000 credits = 2,500 次搜索（$19/mo）

Professional 套餐： 50,000 credits = 25,000 次搜索（$99/mo）

相关工具

search_web

通过 Google 或 DuckDuckGo 搜索整个网络（5 credits）

summarize_content

将长讨论串总结为要点（4 credits）

analyze_content

从讨论串文本中分析情感、实体和关键词（3 credits）

deep_research

具备 AI 分析的多源研究（10 credits）

准备好试用 reddit_search 了吗？免费注册，获取 1,000 credits，开始挖掘 Reddit 讨论。

使用场景

品牌与产品监控

找到您的产品或公司在 Reddit 上的每一次提及，可限定相关 subreddit 或覆盖全站

市场与舆情研究

挖掘真实用户在其讨论社区中对某个品类、竞争对手或痛点的看法

面向 AI Agent 的讨论串读取

一次调用即可获取帖子及其完整的嵌套评论树——可直接用于摘要或分析

社区趋势追踪

使用 after/before 过滤器观察某个 subreddit 在一段日期范围内的讨论话题

用户研究

获取特定作者的帖子或评论，以理解专家观点和反复出现的主题

Parameters

Name	Type	Required	Default	Description
query	string	Optional	-	关键词搜索。posts 模式匹配标题 + 正文（selftext）；comments 模式匹配评论内容。支持 "引号短语"、OR 以及 - 排除语法 Example: best mechanical keyboard
subreddit	string	Optional	-	将结果限定在一个 subreddit（可带或不带 r/ 前缀） Example: MechanicalKeyboards
author	string	Optional	-	将结果限定为一位作者（可带或不带 u/ 前缀） Example: spez
mode	string	Optional	posts	搜索目标："posts"（默认）、"comments"，或 "thread"（帖子及其嵌套评论树——需要 link_id） Example: thread
link_id	string	Optional	-	帖子 ID（例如 "1twm1zh" 或 "t3_1twm1zh"）——thread 模式必填，comments 模式可作为可选过滤器 Example: 1twm1zh
after	string	Optional	-	仅返回此日期之后发布的内容——支持 ISO 8601、epoch 秒，或 "7d" 这样的偏移量 Example: 7d
before	string	Optional	-	仅返回此日期之前发布的内容——格式与 after 相同 Example: 2026-08-01
limit	number	Optional	25	最大结果数，1-100（thread 模式：返回的最大评论数） Example: 10
sort	string	Optional	desc	按发帖日期排序："desc"（最新在前）或 "asc" Example: desc
source	string	Optional	auto	强制指定存档后端："auto"（自动路由并回退）、"arctic_shift" 或 "pullpush" Example: auto

请求示例

terminalBash

curl -X POST https://crawlforge.dev/api/v1/tools/reddit_search \
  -H "X-API-Key: cf_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best mechanical keyboard",
    "subreddit": "MechanicalKeyboards",
    "mode": "posts",
    "limit": 10
  }'

响应示例

200 OK850ms

{
  "success": true,
  "data": {
    "source": "arctic_shift",
    "mode": "posts",
    "query": "best mechanical keyboard",
    "subreddit": "MechanicalKeyboards",
    "author": null,
    "count": 2,
    "results": [
      {
        "id": "1x2y3z4",
        "title": "What's the best mechanical keyboard for programming in 2026?",
        "author": "keeb_enthusiast",
        "subreddit": "MechanicalKeyboards",
        "created_utc": 1755993600,
        "created_iso": "2026-08-24T00:00:00.000Z",
        "score": 142,
        "num_comments": 87,
        "upvote_ratio": 0.96,
        "flair": "Discussion",
        "over_18": false,
        "selftext": "After five years on membrane boards I finally want to switch...",
        "selftext_truncated": false,
        "url": "https://www.reddit.com/r/MechanicalKeyboards/comments/1x2y3z4/",
        "permalink": "https://www.reddit.com/r/MechanicalKeyboards/comments/1x2y3z4/whats_the_best_mechanical_keyboard/"
      }
    ],
    "notes": [
      "Data from the Arctic Shift community archive (arctic-shift.photon-reddit.com), not reddit.com (which blocks scrapers).",
      "Scores and comment counts of content less than ~36h old may read 0/1 — the archive captures content the moment it is posted."
    ],
    "checkedAt": "2026-08-24T14:30:00.000Z"
  },
  "credits_used": 2,
  "credits_remaining": 998,
  "processing_time": 850
}

Field Descriptions

data.source由哪个存档响应：arctic_shift（限定范围、更及时）或 pullpush（全站关键词搜索）

data.results规范化的帖子或评论，附完整 reddit.com 永久链接和 ISO 日期

data.results.selftext_truncated帖子/评论文本上限为 2,000 字符；被截断时为 true

data.notes响应存档的来源与时效性说明

credits_used每次搜索或讨论串读取固定消耗 2 credits

processing_time存档搜索通常在 2 秒内完成

错误处理

缺少搜索范围（400 Bad Request）

posts 和 comments 模式至少需要 query、subreddit 或 author 之一。thread 模式需要 link_id。

未限定范围的 Arctic Shift 搜索（400 Bad Request）

Arctic Shift 无法对全 Reddit 进行关键词搜索。请添加 subreddit 或 author 限定，或使用 source: "pullpush"。

通过 PullPush 使用 thread 模式（400 Bad Request）

thread 模式仅支持 Arctic Shift——source: "pullpush" 只支持 posts 和 comments 搜索。

日期过滤器无效（400 Bad Request）

after/before 必须为 ISO 8601、epoch 秒，或 "7d" 这样的偏移量。

存档不可用（502 Bad Gateway）

两个社区存档均失败或正在限流。错误消息会包含每个存档的具体原因。不会扣除 credits——请稍后重试。

Credit 费用

2 credits

每次搜索 2 credits

一次搜索或一次完整讨论串读取的固定费用。仅对成功的请求扣除 credits。

包含内容：

posts、comments 和完整讨论串（thread）模式

subreddit、作者和日期范围过滤器

带 reddit 风格折叠标记的嵌套评论树

每条结果均附完整 reddit.com 永久链接和 ISO 日期

无需 Reddit API 凭据

套餐推荐：

Free 套餐： 1,000 个一次性试用 credits = 500 次搜索

Hobby 套餐： 5,000 credits = 2,500 次搜索（$19/mo）

Professional 套餐： 50,000 credits = 25,000 次搜索（$99/mo）