> ## 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.

# Instagram API 抓取工具

## 概述

Instagram API 套件提供多种类型的 API，每种 API 都针对特定的 Instagram 数据采集需求设计。以下是这些 API 的连接和交互概览，基于可用功能：

<CardGroup cols="1">
  <Card title="Profiles API" icon="user" href="/cn/api-reference/web-scraper-api/social-media-apis/instagram#profiles-api">
    此 API 允许用户基于单一输入（个人资料 URL）收集个人资料详细信息。

    <br />

    *   **发现功能**：

    *   `N/A`

    <br />

    *   **关键字段**：

    *   `followers`、`post_count`、`post_hashtags`、`profile_name`。
  </Card>

  <Card title="Posts API" icon="images" href="/cn/api-reference/web-scraper-api/social-media-apis/instagram#posts-api">
    此 API 允许用户基于单一输入 URL（如 Instagram Reels URL、搜索 URL 或个人资料 URL）收集多个帖子。

    <br />

    *   **发现功能**：

      *   - Instagram Reels 直接 URL

      *   - 搜索结果的直接 URL

      *   - 个人资料的直接 URL

    <br />

    *   **关键字段**：

    *   `url`、`followers`、`hashtags`、`engagement_score_view`。
  </Card>

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

    <br />

    *   **发现功能**：

    *   `N/A`

    <br />

    *   **关键字段**：

    *   `comment_user`、`comment`、`likes_number`、`replies_number`。
  </Card>
</CardGroup>

该 API 套件旨在提供灵活的数据采集能力，用户可以输入特定的 URL 以批量或精准筛选的方式获取详细的帖子和评论数据。

## Profiles API

### 通过 URL 采集

此 API 允许用户通过提供 Instagram 个人资料 URL 来收集详细的 Instagram 个人资料数据。它提供了 Instagram 个人资料的全面概览，包括商业和互动信息、帖子以及用户详细信息。

**输入参数**

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

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

* **页面/个人资料详情**：\
  `account`、`id`、`followers`、`posts_count`、`is_business_account`、`is_professional_account`、`is_verified`、`avg_engagement`、`profile_name`、`profile_url`、`profile_image_link` 等。

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

***

## Posts API

### 通过 URL 采集

此 API 允许用户通过提供帖子 URL 来收集 Instagram 帖子的详细数据。

**输入参数**

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

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

* **帖子详情**：\
  `post_id`、`description`、`hashtags`、`date_posted`、`num_comments`、`likes`、`content_type`、`video_view_count`、`video_play_count` 等。

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

* **页面/个人资料详情**：\
  `user_posted`、`followers`、`posts_count`、`profile_image_link`、`is_verified`、`profile_url`。

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

* **附件和媒体**：\
  `photos`、`videos`、`thumbnail`、`display_url`（仅链接，非文件）、`audio`。

***

### 通过 URL 发现

此 API 允许用户通过提供 Instagram 个人资料 URL 并指定额外参数，发现该公共个人资料的最新帖子。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Instagram 个人资料 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>

<ParamField path="post_type" type="string">
  指定要采集的帖子类型（如 `post`、`reel`）。
</ParamField>

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

* **帖子详情**：\
  `post_id`、`description`、`hashtags`、`date_posted`、`num_comments`、`likes`、`video_view_count`、`video_play_count` 等。

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

* **页面/个人资料详情**：\
  `user_posted`、`followers`、`posts_count`、`profile_image_link`、`is_verified`、`profile_url`、`is_paid_partnership`、`partnership_details`、`user_posted_id`。

* **附件和媒体**：\
  `photos`、`videos`、`thumbnail`、`audio`、`display_url`、`content_type`、`product_type`、`coauthor_producers`、`tagged_users`。

此 API 允许进行过滤、排除特定帖子，并按类型（普通帖子或短视频）在指定时间范围内采集帖子。它提供详细的帖子和个人资料信息，适用于数据采集和分析。

## 评论 API

### 通过 URL 采集

此 API 允许用户通过提供 Instagram 帖子 URL 来收集特定帖子的最新评论。

<Note>
  此 API 仅获取最近 10 条评论及相关元数据。
</Note>

**输入参数**

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

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

* **评论详情**：\
  `comment_id`、`comment_user`、`comment_user_url`、`comment_date`、`comment`、`likes_number`、`replies_number`、`replies`、`hashtag_comment`、`tagged_users_in_comment` 等。

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

* **用户详情**：\
  `user_name`、`user_id`、`user_url`

  > 我们仅提供有限的用户资料数据点。

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

## Reels API（短视频 API）

### 通过 URL 采集

此 API 允许用户通过提供 Reels 短视频的 URL，从公开的 Instagram 个人资料中收集详细数据。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Instagram Reels 短视频 URL。
</ParamField>

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

* **短视频详情**：\
  `post_id`、`description`、`hashtags`、`date_posted`、`tagged_users`、`num_comments`、`likes`、`views`、`video_play_count`、`length` 等。

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

* **页面/个人资料详情**：\
  `user_posted`、`followers`、`posts_count`、`profile_image_link`、`is_verified`、`profile_url`。

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

* **附件和媒体**：\
  `video_url`、`thumbnail`、`audio_url`。

### 通过 URL 发现

此 API 允许用户通过个人资料 URL 或直接搜索 URL 发现 Instagram Reels 短视频。

**输入参数**

<ParamField path="URL" type="string" required="true">
  Instagram 个人资料 URL 或直接搜索 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。
</ParamField>

<ParamField path="end_date" type="string">
  过滤短视频的结束日期，格式为 MM-DD-YYYY（应晚于 `start_date`）。
</ParamField>

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

* **短视频详情**：\
  `post_id`、`description`、`hashtags`、`date_posted`、`num_comments`、`likes`、`views`、`video_play_count`、`top_comments`、`length`、`video_url`、`audio_url`、`content_id` 等。

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

* **个人资料详情**：\
  `user_posted`、`followers`、`posts_count`、`following`。

* **附件和媒体**：\
  `video_url`、`thumbnail`、`audio_url`（仅提供链接，不包含文件本身）。

此 API 提供有关 Instagram Reels 的详细信息，并支持按日期范围过滤、排除特定帖子以及限制收集的短视频数量。