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

# Facebook API爬取工具

## 概览

Facebook API套件提供多种类型的API，每种API都针对Facebook数据收集的特定需求进行了优化。以下是这些API的概述，包括它们如何连接和交互的方式：

<CardGroup cols="1">
  <Card title="帖子API" icon="images" href="/cn/api-reference/web-scraper-api/social-media-apis/facebook#帖子api">
    此API允许用户根据单个输入URL（例如Facebook页面、群组或个人资料URL）收集多个帖子。

    <br />

    *   **发现功能**：

    *   需要Facebook页面、群组或个人资料的直接URL。

    <br />

    *   **重要字段**：

    *   `post_url`、`content`、`hashtags`、`likes`
  </Card>

  <Card title="评论API" icon="comments" href="/cn/api-reference/web-scraper-api/social-media-apis/facebook#评论-api">
    此API允许用户使用帖子URL收集多个评论。

    <br />

    *   **发现功能**：

    *   `N/A`

    <br />

    *   **重要字段**：

    *   `commenter_url`、`comment_text`、`num_likes`、`num_replies`
  </Card>
</CardGroup>

<Note>由于Facebook数据需要登录，因此无法跨数据集进行发现。</Note>

该API套件旨在为用户提供灵活性，使他们能够输入特定URL，以批量或精确筛选的方式收集详细的帖子和评论数据。

## 帖子API

帖子API允许用户从Facebook个人资料、群组和页面收集详细的帖子数据。API提供有关帖子、页面/个人资料详情以及附件和媒体的全面数据点。

### 通过个人资料URL收集

此API允许用户通过提供个人资料URL收集Facebook帖子数据。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Facebook个人资料URL。
</ParamField>

<ParamField path="num_of_posts" type="number">
  要收集的最近帖子数量。如果省略，则没有限制。
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  需要从结果中排除的帖子ID数组。
</ParamField>

<ParamField path="start_date" type="string">
  以MM-DD-YYYY格式指定的起始日期（应早于end\_date）。
</ParamField>

<ParamField path="end_date" type="string">
  以MM-DD-YYYY格式指定的结束日期（应晚于start\_date）。
</ParamField>

**输出结构**
包括全面的数据点：

* **帖子详情**：
  `post_id`、`content`、`hashtags`、`date_posted`、`num_comments`、`num_likes`等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lkaxegm826bjpoo9m5?id=all\&tab=overview)。

* **页面/个人资料详情**：
  `page_name`、`page_category`、`page_followers`、`profile_handle`。

  > 我们仅提供有关个人资料的有限数据点。

* **附件和媒体**：
  `attachments` 和 `post_image`（仅链接，不提供文件本身）、`video_view_count`。

### 通过群组URL收集

此API允许用户通过提供群组URL收集详细的Facebook帖子。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Facebook群组URL。
</ParamField>

<ParamField path="num_of_posts" type="number">
  要收集的帖子数量。如果省略，则没有限制。
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  需要从结果中排除的帖子ID数组。
</ParamField>

<ParamField path="start_date" type="string">
  以MM-DD-YYYY格式指定的起始日期（应早于end\_date）。
</ParamField>

<ParamField path="end_date" type="string">
  以MM-DD-YYYY格式指定的结束日期（应晚于start\_date）。
</ParamField>

**输出结构**
包括全面的数据点：

* **帖子详情**：
  `post_id`、`user_url`、`user_username`、`content`、`date_posted`、`hashtags`、`num_comments`、`num_shares`、`num_likes_type`等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lz11l67o2cb3r0lkj3?id=all\&tab=overview)。

* **群组详情**：
  `group_name`、`group_id`、`group_url`、`group_intro`、`group_category`等。

* **用户详情**：
  `user_is_verified`、`profile_handle`等。

* **附件和外部链接**：
  `attachments`（仅链接，不提供文件本身）、`original_post_url`、`other_posts_url`、`post_external_link`等。

### 通过帖子URL收集

此API允许用户使用帖子URL收集详细的Facebook帖子数据。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Facebook帖子URL。
</ParamField>

**输出结构**
包括全面的数据点：

* **帖子详情**：
  `post_id`、`content`、`hashtags`、`date_posted`、`num_comments`、`num_likes`等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lyclm1571iy3mv57zw?id=all\&tab=overview)。

* **页面/个人资料详情**：
  `page_name`、`page_category`、`page_followers`、`profile_handle`。

  > 我们仅提供有关个人资料的有限数据点。

* **附件和媒体**：
  `attachments` 和 `post_image`（仅链接，不提供文件本身）、`video_view_count`。

## 评论 API

评论 API 允许用户从 Facebook 帖子中收集详细的评论数据。该 API 提供关于评论的全面数据点，包括评论详情、用户信息、帖子元数据、附件和媒体。

### 通过帖子 URL 采集

该 API 允许用户通过提供帖子 URL，从 Facebook 帖子中收集详细的评论数据。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Facebook 帖子 URL。
</ParamField>

<ParamField path="num_of_comments" type="number">
  要采集的评论数量。如果省略，则没有限制。
</ParamField>

<ParamField path="comments_to_not_include" type="array">
  要排除的评论 ID 数组。
</ParamField>

<ParamField path="start_date" type="string">
  用于筛选评论的起始日期，格式为 MM-DD-YYYY（应早于 end\_date）。
</ParamField>

<ParamField path="end_date" type="string">
  用于筛选评论的结束日期，格式为 MM-DD-YYYY（应晚于 start\_date）。
</ParamField>

**输出结构**

包含全面的数据点：

* **评论详情**：
  `comment_id`、`comment_text`、`num_likes`、回复、`num_replies` 等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lkay758p1eanlolqw8?id=all\&tab=overview)。

* **用户信息**：
  `user_name`、`user_id`、`user_url`

  > 我们仅提供有限的用户信息数据点。

* **帖子元数据**：
  `post_id`、`post_url`。

* **附件和媒体**：
  `attached_files`（仅链接，不包含文件本身）、`video_length`。

## Reels API

Reels API 允许用户从公共 Facebook 个人资料中收集详细的 Reels 数据。该 API 提供关于 Reels 的全面数据点，包括帖子详情、页面/个人资料信息、附件和媒体。

### 通过个人资料 URL 采集

该 API 允许用户通过提供个人资料 URL，从公共 Facebook 个人资料中收集详细的 Reels 数据。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Facebook 个人资料 URL。
</ParamField>

<ParamField path="num_of_posts" type="number">
  要采集的 Reels 数量（默认最多 1600）。
</ParamField>

<ParamField path="posts_to_not_include" type="array">
  要排除的 Reels ID 数组。
</ParamField>

<ParamField path="start_date" type="string">
  用于筛选 Reels 的起始日期。
</ParamField>

<ParamField path="end_date" type="string">
  用于筛选 Reels 的结束日期。
</ParamField>

**输出结构**

包含全面的数据点：

* **Reels 详情**：
  `post_id`、`content`、`hashtags`、`date_posted`、`num_comments`、`num_likes`、`audio`（音轨详情）、`video_view_count` 等。

  > 查看所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lyclm3ey2q6rww027t?id=all\&tab=overview)。

* **页面/个人资料信息**：
  `page_name`、`page_category`、`page_followers`、`profile_handle`。

  > 我们仅提供有限的个人资料信息数据点。

* **附件和媒体**：
  `external_link`（仅链接，不包含文件本身）。
