工作原理
你向 Bright Data Facebook Scraper API 发送一个或多个 Facebook URL。Bright Data 负责处理采集基础设施，并返回干净、结构化的 JSON。dataset_id 来指定数据类型（个人主页、帖子、Marketplace、活动等），并以 JSON、NDJSON 或 CSV 格式返回结果。
响应内容示例
Bright Data Facebook Scraper API 于 2026 年 9 月 6 日返回的单条记录（已裁剪为所示字段）。可在快速开始中亲自发送该请求。支持的数据类型
个人主页
姓名、粉丝数、简介、认证状态和主页详情。
主页帖子
按主页 URL 获取的 Facebook 公共主页帖子，包括文本、互动反应和媒体。
帖子
按帖子 URL 获取的单条帖子数据，或按群组 URL 获取的帖子。
Marketplace
商品列表、价格、卖家详情和商品描述。
活动
活动详情，包括日期、地点、描述和参加情况。
评论
任意帖子的评论文本、互动反应、回复和评论者详情。
Reels
按主页 URL 获取的 Facebook Reels 视频 URL、观看次数和互动数据。
公司评价
来自 Facebook 公共主页的商家评价、评分和评价者详情。
请求方式
Bright Data Scraper API 支持两种请求方式，请根据您的数据量和延迟需求选择。
详见了解同步与异步请求。
两个端点都接受两种请求体格式：本页所有示例使用的纯 JSON 数组，或带有
input 数组的对象。当您同时传入 custom_output_fields 或 limit_per_input（两个端点均支持），或在 /trigger 上传入 deliver 配置时，请使用对象格式。详见请求体。
功能与限制
常见问题
数据是实时采集的吗？
是的。每个请求都会触发一次实时采集，没有缓存或过时的数据。处理时间取决于目标网站状况和爬虫负载。Bright Data Facebook Scraper API 不公布固定的响应时间。同步请求最多等待 1 分钟，之后返回 HTTP202 和 snapshot_id，并继续以异步方式采集。发现（discovery）请求始终以异步方式运行，耗时更长，具体取决于结果数量。
响应时间为什么会发生变化？
Facebook 会调整其页面的提供方式，Bright Data Facebook Scraper API 的采集器也会相应更新。即使成功率保持不变，采集器更新也可能改变一次采集所需的时间。对于生产环境的工作负载，请基于异步工作流或 Webhook 投递进行构建，这样较长的运行时间不会破坏集成。URL 采集和发现有什么区别？
URL 采集会采集你提供的特定 Facebook 页面（例如个人主页 URL）。**发现（Discovery）**会查找符合搜索条件的 Facebook 内容（例如某个主页 URL 下的所有帖子）并采集结果。发现请求在两个端点上均可使用。在/scrape 上通常会超过 1 分钟限制并返回 HTTP 202 和 snapshot_id，因此发现请求请使用异步 /trigger 端点。
与使用代理或 Web Unlocker API 抓取有何不同？
使用代理或 Web Unlocker API 抓取时，您仍需编写和维护自己的解析逻辑，并在目标网站页面结构变化时随时更新。Bright Data Scraper API 处理整个链路：代理轮换、反爬绕过与解析。您只需发送 URL 或关键词，即可获得干净的结构化 JSON，无需自建抓取基础设施或维护解析器。后续步骤
快速开始
在 5 分钟内采集你的第一个 Facebook 个人主页。
端点
每个端点一个请求，附实际抓取的响应。
API 参考
端点规范、参数和响应模式。