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

# TikTok API 抓取器

## 概述

TikTok API 套件提供多种类型的 API，每种 API 都针对从 TikTok 采集数据的特定需求进行设计。以下是这些 API 之间的交互概述，基于可用功能：

<CardGroup cols="1">
  <Card title="Profile API" icon="user" href="/cn/api-reference/web-scraper-api/social-media-apis/tiktok#profile-api">
    该 API 允许用户通过单一输入（个人资料 URL）采集个人资料详情。

    <br />

    *   **发现功能**：

    *   搜索的直接 URL

    <br />

    *   **主要数据列**：

    *   `nickname`，`awg_engagement_rate`，`followers`，`likes`
  </Card>

  <Card title="Posts API" icon="images" href="/cn/api-reference/web-scraper-api/social-media-apis/tiktok#posts-api">
    该 API 允许用户通过单一输入 URL 采集多个帖子。

    <br />

    *   **发现功能**：

    *   - TikTok 个人资料的直接 URL

    *   - 通过关键词发现

    *   - 发现的直接 URL

    <br />

    *   **主要数据列**：

    *   `url`，`share_count`，`description`，`hashtags`
  </Card>

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

    <br />

    *   **发现功能**：

    *   N/A

    <br />

    *   **主要数据列**：

    *   `url`，`comment_text`，`commenter_url`，`num_likes`
  </Card>
</CardGroup>

## Profile API

### 通过 URL 采集

该 API 允许用户使用提供的个人资料 URL 检索详细的 TikTok 个人资料信息。

**输入参数**：

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

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

* **个人资料详情**：\
  `account_id`，`nickname`，`biography`，`bio_link`，`predicted_lang`，`is_verified`，`followers`，`following`，`likes`，`videos_count`，`create_time`，`id`，`url`，`profile_pic_url`，`profile_pic_url_hd` 等。

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

* **互动指标**：\
  `awg_engagement_rate`，`comment_engagement_rate`，`like_engagement_rate`，`like_count`，`digg_count`。

* **隐私与设置**：\
  `is_private`，`relation`，`open_favorite`，`comment_setting`，`duet_setting`，`stitch_setting`，`is_ad_virtual`，`room_id`，`is_under_age_18`。

* **发现与热门视频**：\
  `region`，`top_videos`，`discovery_input`。

该 API 允许用户检索详细的 TikTok 个人资料信息，包括互动指标、隐私设置和热门视频，提供有关用户活动和个人资料数据的见解。

### 通过搜索 URL 发现

该 API 允许用户根据特定的搜索 URL 和国家/地区发现 TikTok 个人资料，并提供详细的个人资料信息。

**输入参数**：

<ParamField path="search_url" type="string" required="true">
  TikTok 搜索 URL。
</ParamField>

<ParamField path="country" type="string" required="true">
  执行搜索的国家/地区。
</ParamField>

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

* **个人资料详情**：\
  `account_id`，`nickname`，`biography`，`bio_link`，`predicted_lang`，`is_verified`，`followers`，`following`，`likes`，`videos_count`，`create_time`，`id`，`url`，`profile_pic_url`，`profile_pic_url_hd` 等。

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

* **互动指标**：\
  `awg_engagement_rate`，`comment_engagement_rate`，`like_engagement_rate`，`like_count`，`digg_count`。

* **隐私与设置**：\
  `is_private`，`relation`，`open_favorite`，`comment_setting`，`duet_setting`，`stitch_setting`，`is_ad_virtual`，`room_id`，`is_under_age_18`。

* **发现与热门视频**：\
  `region`，`top_videos`，`discovery_input`。

该 API 使用户能够根据搜索条件发现 TikTok 个人资料，并提供有关用户活动、互动、隐私设置和热门内容的见解，有助于高效发现和分析 TikTok 用户。

## 帖子 API

### 通过 URL 采集

该 API 允许用户通过提供 TikTok 帖子 URL 来采集详细的帖子数据。

**输入参数**：

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

**输出结构**：\
包含丰富的数据点：

* **帖子详情**：\
  `post_id`、`description`、`create_time`、`share_count`、`collect_count`、`comment_count`、`play_count`、`video_duration`、`hashtags`、`original_sound`、`official_item`、`original_item`、`shortcode`、`video_url`、`music`、`cdn_url`、`width`、`carousel_images` 等。

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

* **个人资料详情**：\
  `profile_id`、`profile_username`、`profile_url`、`profile_avatar`、`profile_biography`、`account_id`、`profile_followers`、`is_verified`。

* **标记的用户和媒体**：\
  `tagged_user`、`carousel_images`。

* **附加信息**：\
  `tt_chain_token`、`secu_id`

***

### 通过个人资料 URL 发现

该 API 允许用户基于提供的个人资料 URL 获取 TikTok 个人资料的帖子，并可通过帖子数量、日期范围和排除特定帖子的选项进行筛选。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  TikTok 个人资料 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="what_to_collect" type="string">
  指定要采集的帖子类型（例如 "post" 或 "reel"）。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **帖子详情**：\
  `post_id`、`description`、`create_time`、`share_count`、`collect_count`、`comment_count`、`play_count`、`video_duration`、`hashtags`、`original_sound`、`official_item`、`original_item`、`shortcode`、`video_url`、`music`、`cdn_url`、`width`、`carousel_images` 等。

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

* **个人资料详情**：\
  `profile_id`、`profile_username`、`profile_url`、`profile_avatar`、`profile_biography`、`account_id`、`profile_followers`、`is_verified`。

* **标记的用户和媒体**：\
  `tagged_user`、`carousel_images`。

* **附加信息**：\
  `tt_chain_token`、`secu_id`。

该 API 允许用户发现和检索特定 TikTok 个人资料的帖子详细信息，包括帖子数据、创作者的个人资料信息以及标记的用户。支持高效内容发现和帖子分析。

***

### 通过关键词发现

该 API 允许用户基于特定关键词或标签搜索 TikTok 帖子，是发现 TikTok 平台相关内容的强大工具。

**输入参数**：

<ParamField path="search_keyword" type="string" required="true">
  要搜索的关键词或标签。
</ParamField>

<ParamField path="num_of_posts" type="number">
  要采集的帖子数量。如果未提供，则不限制。
</ParamField>

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

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

**输出结构**：\
包含丰富的数据点：

* **帖子详情**：\
  `post_id`、`description`、`create_time`、`digg_count`、`share_count`、`collect_count`、`comment_count`、`play_count`、`video_duration`、`hashtags`、`original_sound`、`post_type`、`discovery_input`、`official_item` 等。

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

* **个人资料详情**：\
  `profile_id`、`profile_username`、`profile_url`、`profile_avatar`、`profile_biography`、`account_id`、`profile_followers`、`is_verified`。

* **标记的用户和媒体**：\
  `tagged_user`、`carousel_images`。

* **附加信息**：\
  `tt_chain_token`、`secu_id`。

该 API 允许用户发现与特定关键词或标签匹配的 TikTok 帖子，并提供帖子详细信息、个人资料信息和媒体信息。这是探索 TikTok 趋势、内容和用户的绝佳工具。

***

### 通过发现 URL 发现

该 API 允许用户从特定 TikTok 发现 URL 采集详细的帖子数据。

**输入参数**：

<ParamField path="URL" type="string" required="true">
  TikTok 发现 URL。
</ParamField>

**输出结构**：\
包含丰富的数据点：

* **帖子详情**：\
  `post_id`、`description`、`create_time`、`digg_count`、`share_count`、`collect_count`、`comment_count`、`play_count`、`video_duration`、`hashtags`、`original_sound`、`post_type`、`discovery_input`、`official_item`、`original_item` 等。

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

* **个人资料详情**：\
  `profile_id`、`profile_username`、`profile_url`、`profile_avatar`、`profile_biography`、`account_id`、`profile_followers`、`is_verified`。

* **标记的用户和媒体**：\
  `tagged_user`、`carousel_images`。

* **附加信息**：\
  `tt_chain_token`、`secu_id`。

该 API 提供详细的 TikTok 发现 URL 相关帖子数据，方便访问热门内容、用户资料和帖子元数据，以便分析和探索。

## 评论 API

### 按 URL 采集

该 API 允许用户通过提供的 TikTok 帖子 URL 采集该帖子的详细评论数据。

**输入参数**：

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

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

* **帖子详情**：
  `post_url`，`post_id`，`post_date_created`。

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

* **评论详情**：
  `date_created`，`comment_text`，`num_likes`，`num_replies`，`comment_id`，`comment_url`。

* **评论者详情**：
  `commenter_user_name`，`commenter_id`，`commenter_url`。

该 API 提供 TikTok 帖子的详细评论数据，包括评论相关的指标以及评论者信息，以便进行有效的评论分析和互动跟踪。
