Reddit 爬虫 API

发送 Reddit URL 或关键词，获得结构化 JSON 返回。Bright Data Reddit 爬虫 API 处理代理、验证码和解析，让你专注于数据管道。

初次使用 Bright Data？创建免费账户，即可每月获得 5,000 个免费积分，无需信用卡。这相当于最多 5,000 条 Reddit 记录，可供你开始抓取。请参阅免费套餐。

工作原理

你向 Bright Data Reddit 爬虫 API 发送一个或多个 Reddit URL 或关键词。Bright Data 处理爬虫基础设施并返回清晰的结构化 JSON。

你的应用  -->  Bright Data API  -->  结构化 JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY

所有请求都使用 dataset_id 来指定数据类型（帖子或评论），并以 JSON、NDJSON 或 CSV 格式返回结果。

响应内容示例

Bright Data Reddit Scraper API 于 2026 年 9 月 6 日返回的单条记录（已裁剪为所示字段）。可在快速开始中亲自发送该请求。

{
  "post_id": "t3_1w8chn8",
  "url": "https://www.reddit.com/r/learnpython/comments/1w8chn8/found_a_for_loop_and_cant_find_an_explanation_can/",
  "user_posted": "xq_***x",
  "title": "found a for loop and can't find an explanation. Can someone explain, please?",
  "num_upvotes": 8,
  "num_comments": 14,
  "date_posted": "2026-09-05T21:03:33.625Z",
  "community_name": "learnpython",
  "community_members_num": 1053086,
  "description": "Hey there, I just started the Project Euler Archive and started with the classic \"Find the sum of all the multiples of 3 or 5 below 1000.\" And when I wanted..."
}

支持的数据类型

帖子

标题、描述、点赞数、社区统计和附带的媒体。按帖子 URL 收集，或按关键词或子版块 URL 发现。

评论文本、回复、点赞数和帖子上下文。按帖子或评论 URL 收集，可选按天数过滤。

端点

Reddit 爬虫 API 提供两个数据集系列，每个系列支持一种或多种输入形式。

数据集	输入	返回内容
帖子 — 按 URL 收集 (`gd_lvz8ah06191smkebj4`)	`url`（帖子 URL）	单个帖子及其元数据、社区信息和媒体
帖子 — 按关键词发现 (`gd_lvz8ah06191smkebj4`)	`keyword`、`date`、`num_of_posts`	匹配搜索词的帖子，按日期过滤
帖子 — 按子版块 URL 发现 (`gd_lvz8ah06191smkebj4`)	`url`（子版块 URL）、`sort_by`	来自单一子版块的帖子，按 `new`、`top` 或 `hot` 排序
评论 — 按 URL 收集 (`gd_lvzdpsdlw09j6t702`)	`url`（帖子或评论 URL）、`days_back`	来自帖子的评论及完整线程上下文

请求方式

Bright Data Scraper API 支持两种请求方式，请根据您的数据量和延迟需求选择。

方式	端点	适用场景
同步	`/scrape`	实时查询，最多 20 个 URL
异步	`/trigger`	批量任务、20 个及以上 URL、生产环境管道

详见了解同步与异步请求。两个端点都接受两种请求体格式：本页所有示例使用的纯 JSON 数组，或带有 input 数组的对象。当您同时传入 custom_output_fields 或 limit_per_input（两个端点均支持），或在 /trigger 上传入 deliver 配置时，请使用对象格式。详见请求体。

功能与限制

功能	详情
输出格式	JSON、NDJSON、CSV
同步请求最大 URL 数	20
异步请求最大 URL 数	无限制，每个任务最多 1 GB 输入
数据新鲜度	实时（按需抓取）
投递方式	API 下载、webhook、Amazon S3、Snowflake、Azure、GCS（全部目标）
计费	按成功记录计费（查看价格）

常见问题

数据是实时爬取的吗？

是的。每个请求都会触发对 Reddit 的实时爬取。没有缓存或过期数据。处理时间取决于目标网站状况和爬虫负载。Bright Data Reddit Scraper API 不公布固定的响应时间。同步请求最多等待 1 分钟，之后返回 HTTP 202 和 snapshot_id，并继续以异步方式采集。发现（discovery）请求始终以异步方式运行，耗时更长，具体取决于结果数量。

响应时间为什么会发生变化？

Reddit 会调整其页面的提供方式，Bright Data Reddit Scraper API 的采集器也会相应更新。即使成功率保持不变，采集器更新也可能改变一次采集所需的时间。对于生产环境的工作负载，请基于异步工作流或 Webhook 投递进行构建，这样较长的运行时间不会破坏集成。

收集和发现有什么区别？

按 URL 收集爬取你提供的特定 Reddit 页面 —— 单个帖子、评论线程或子版块。发现查找匹配搜索条件的 Reddit 帖子，例如关键词或子版块列表，然后爬取结果。当你不知道确切的 URL 时，发现通过异步请求使用最为有效。

我可以只收集帖子中最近的评论吗？

可以。评论 API 接受可选的 days_back 参数。传入整数以将结果限制为在该天数内发布的评论。

与使用代理或 Web Unlocker API 抓取有何不同？

使用代理或 Web Unlocker API 抓取时，您仍需编写和维护自己的解析逻辑，并在目标网站页面结构变化时随时更新。Bright Data Scraper API 处理整个链路：代理轮换、反爬绕过与解析。您只需发送 URL 或关键词，即可获得干净的结构化 JSON，无需自建抓取基础设施或维护解析器。

后续步骤

快速开始

在 5 分钟内爬取你的第一个 Reddit 帖子。

端点

每个端点一个请求，附实际抓取的响应。

API 参考

端点规范、参数和响应模式。

开始使用

数据提取

网页搜索

AI 训练数据

代理网络

工作原理

响应内容示例

支持的数据类型

帖子

评论

端点

请求方式

功能与限制

常见问题

数据是实时爬取的吗？

响应时间为什么会发生变化？

收集和发现有什么区别？

我可以只收集帖子中最近的评论吗？

与使用代理或 Web Unlocker API 抓取有何不同？

后续步骤

快速开始

端点

API 参考

​工作原理

​响应内容示例

​支持的数据类型

帖子

评论

​端点

​请求方式

​功能与限制

​常见问题

​数据是实时爬取的吗？

​响应时间为什么会发生变化？

​收集和发现有什么区别？

​我可以只收集帖子中最近的评论吗？

​与使用代理或 Web Unlocker API 抓取有何不同？

​后续步骤

快速开始

端点

API 参考

工作原理

响应内容示例

支持的数据类型

端点

请求方式

功能与限制

常见问题

数据是实时爬取的吗？

响应时间为什么会发生变化？

收集和发现有什么区别？

我可以只收集帖子中最近的评论吗？

与使用代理或 Web Unlocker API 抓取有何不同？

后续步骤