Skip to main content
本教程向你展示如何使用 Bright Data Reddit 爬虫 API 爬取 Reddit 帖子并获得结构化 JSON 数据。

前提条件

  • 一个 Bright Data 账户(每月含 5,000 个免费积分)
  • 已安装 cURL、Python 3.9+ 或 Node.js 18+
1

获取你的 API 密钥

访问你 Bright Data 账户中的 用户设置页面 并创建一个 API 密钥,或使用已有的密钥。如果你还没有账户,在 brightdata.com 注册。新账户每月可获得 5,000 个免费积分,无需信用卡。请参阅免费套餐。
你的 API 密钥仅在创建时显示一次。请复制并安全地存储。
2

发送请求

我们将使用帖子 — 按 URL 收集端点。最快的方式是使用 Bright Data Python SDK(pip install brightdata-sdk),它会替您等待结果。其他选项卡通过同步请求直接调用 API。将 YOUR_API_KEY 替换为你的实际密钥:
SDK 会输出 result.data 中返回的记录。它最多等待 240 秒获取结果,因此您无需自行处理 202。使用 cURL、Python 或 Node.js 时,您应该看到 200 状态码和一个 JSON 数组。202 表示抓取需要超过 1 分钟,请参阅下方说明。处理时间取决于目标网站状况和爬虫负载。
同步请求最多等待 1 分钟。如果 Bright Data Reddit Scraper API 需要更长时间,响应为 HTTP 202,返回 snapshot_id 而不是帖子数据,采集将继续以异步方式进行。请通过异步工作流获取结果,或使用 Webhook 投递接收结果。
3

查看响应

Bright Data Reddit 爬虫 API 返回一个包含结构化帖子数据的 JSON 数组:
每个帖子对象包括帖子详情、社区统计、互动指标和附带的媒体。查看 完整响应模式。
你已经使用 Bright Data Reddit 爬虫 API 成功爬取了第一个 Reddit 帖子。

常见问题

我可以在一次请求中爬取多个帖子吗?

可以。在输入数组中添加更多对象。Bright Data 建议每个同步请求不超过 20 个 URL,这是最佳实践,而非硬性限制。对于更大的批次或按关键词或子版块发现,请使用 异步 /trigger 端点。

我可以爬取帖子中的评论吗?

可以,使用单独的评论数据集。使用数据集 ID gd_lvzdpsdlw09j6t702 并传入帖子 URL:
你也可以传入 days_back 将结果限制为最近 N 天内发布的评论。

收到 401 或 403 错误?

确认你的 API 密钥正确且未过期。从 账户设置 生成新密钥。详见 认证指南。

请求超时?

同步请求有 1 分钟超时限制。如果请求超过此限制,API 返回 HTTP 202 和 snapshot_id,并以异步方式完成任务。对于大批量请求,请使用 异步工作流。

响应数据为空或不完整?

确认 Reddit 帖子 URL 可公开访问且格式正确。URL 应遵循 https://www.reddit.com/r/{subreddit}/comments/{post_id}/{slug}/ 模式。私有子版块和已删除的帖子无法被爬取。

必须直接调用 API 吗?

不必。Bright Data 的 SDK、CLI 和编程代理工具调用的是同一个 Scraper API,您可以选择最适合自己技术栈的方式开始。

后续步骤

端点

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

异步批量请求

在单个批量任务中爬取数百个帖子或运行关键词发现。

API 参考

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