> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Facebook Scraper API

> 使用 Bright Data Facebook Scraper API，通过 9 个端点从 Facebook 个人主页、公共主页、帖子、Marketplace 和活动中提取数据。

发送一个 Facebook URL，即可获得结构化的 JSON 数据。Bright Data Facebook Scraper API 会处理代理、验证码和解析，让你可以专注于自己的数据管道。

<Tip>
  初次使用 Bright Data？[创建免费账户](https://brightdata.com/products/web-scraper/facebook/?hs_signup=1\&utm_source=docs)，即可**每月获得 5,000 个免费积分**，无需信用卡。这相当于最多 **5,000 条 Facebook 记录**，可供你开始抓取。请参阅[免费套餐](/cn/general/account/billing-and-pricing/free-tier)。
</Tip>

## 工作原理

你向 Bright Data Facebook Scraper API 发送一个或多个 Facebook URL。Bright Data 负责处理采集基础设施，并返回干净、结构化的 JSON。

```text theme={null}
Your app  -->  Bright Data API  -->  Structured JSON
           POST /datasets/v3/scrape
           Authorization: Bearer YOUR_API_KEY
```

所有请求都使用 `dataset_id` 来指定数据类型（个人主页、帖子、Marketplace、活动等），并以 JSON、NDJSON 或 CSV 格式返回结果。

## 响应内容示例

Bright Data Facebook Scraper API 返回的单条记录。可在[快速开始](/cn/products/scrapers/facebook/quickstart)中亲自发送该请求。

```json theme={null}
{
  "name": "Mark Zuckerberg",
  "url": "https://www.facebook.com/zuck",
  "followers": 120000000,
  "bio": "Building the future...",
  "profile_type": "public_figure",
  "is_verified": true
}
```

## 支持的数据类型

<CardGroup cols={2}>
  <Card title="个人主页" icon="user" href="/cn/api-reference/scrapers/social-media-apis/facebook-profiles-collect-by-url">
    姓名、粉丝数、简介、认证状态和主页详情。
  </Card>

  <Card title="主页帖子" icon="newspaper" href="/cn/api-reference/scrapers/social-media-apis/facebook-pages-posts-collect-by-url">
    按主页 URL 获取的 Facebook 公共主页帖子，包括文本、互动反应和媒体。
  </Card>

  <Card title="帖子" icon="image" href="/cn/api-reference/scrapers/social-media-apis/facebook-posts-collect-by-url">
    按帖子 URL 获取的单条帖子数据，或按群组 URL 获取的帖子。
  </Card>

  <Card title="Marketplace" icon="shop" href="/cn/api-reference/scrapers/social-media-apis/facebook-marketplace-collect-by-url">
    商品列表、价格、卖家详情和商品描述。
  </Card>

  <Card title="活动" icon="calendar" href="/cn/api-reference/scrapers/social-media-apis/facebook-events-collect-by-url">
    活动详情，包括日期、地点、描述和参加情况。
  </Card>

  <Card title="评论" icon="comments" href="/cn/api-reference/scrapers/social-media-apis/facebook-comments-collect-by-url">
    任意帖子的评论文本、互动反应、回复和评论者详情。
  </Card>

  <Card title="Reels" icon="film" href="/cn/api-reference/scrapers/social-media-apis/facebook-reels-collect-by-url">
    按主页 URL 获取的 Facebook Reels 视频 URL、观看次数和互动数据。
  </Card>

  <Card title="公司评价" icon="star" href="/cn/api-reference/scrapers/social-media-apis/facebook-company-reviews-collect-by-url">
    来自 Facebook 公共主页的商家评价、评分和评价者详情。
  </Card>
</CardGroup>

## 请求方式

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

| 方式     | 端点                                                                  | 适用场景                    |
| :----- | :------------------------------------------------------------------ | :---------------------- |
| **同步** | `/scrape`                                                           | 实时查询，最多 20 个 URL        |
| **异步** | [`/trigger`](/cn/products/scrapers/scrapers-library/async-requests) | 批量任务、20 个及以上 URL、生产环境管道 |

详见[了解同步与异步请求](/cn/products/scrapers/concepts/sync-vs-async)。

## 功能与限制

| 功能               | 详情                                                                                                                                                                                                                            |
| :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **输出格式**         | JSON、NDJSON、CSV                                                                                                                                                                                                               |
| **同步请求最大 URL 数** | 20                                                                                                                                                                                                                            |
| **异步请求最大 URL 数** | 无限制，每个任务最多 1 GB 输入                                                                                                                                                                                                            |
| **数据新鲜度**        | 实时（按需抓取）                                                                                                                                                                                                                      |
| **投递方式**         | API 下载、[webhook](/cn/products/scrapers/scrapers-library/data-delivery)、[Amazon S3](/cn/products/scrapers/scrapers-library/data-delivery)、Snowflake、Azure、GCS（[全部选项](/cn/products/scrapers/scrapers-library/delivery-options)） |
| **计费**           | 按成功记录计费（[查看价格](https://www.bright.cn/pricing/web-scraper)）                                                                                                                                                                    |

## 常见问题

<Accordion title="数据是实时采集的吗？">
  是的。每个请求都会触发一次实时采集，没有缓存或过时的数据。响应时间因端点而异：个人主页通常在 10-30 秒内返回（同步），而发现（discovery）请求可能因结果数量而耗时更长。
</Accordion>

<Accordion title="URL 采集和发现有什么区别？">
  **URL 采集**会采集你提供的特定 Facebook 页面（例如个人主页 URL）。\*\*发现（Discovery）\*\*会查找符合搜索条件的 Facebook 内容（例如某个主页 URL 下的所有帖子）并采集结果。发现功能仅在异步请求中可用。
</Accordion>

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

## 后续步骤

<CardGroup cols={3}>
  <Card title="快速开始" icon="rocket" href="/cn/products/scrapers/facebook/quickstart">
    在 5 分钟内采集你的第一个 Facebook 个人主页。
  </Card>

  <Card title="发送第一个请求" icon="bolt" href="/cn/products/scrapers/facebook/send-first-request">
    完整的 cURL、Python 和 Node.js 代码示例。
  </Card>

  <Card title="API 参考" icon="code" href="/cn/api-reference/scrapers/social-media-apis/facebook-profiles-collect-by-url">
    端点规范、参数和响应模式。
  </Card>
</CardGroup>