> ## 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.
# YouTube API 爬取工具
## 概述
YouTube API 套件提供多种 API，专为从 YouTube 采集特定数据而设计。以下是这些 API 的交互方式及可用功能概览：
此 API 允许用户基于单一输入（个人资料 URL）收集用户资料详情。
* **发现功能**：
* [通过关键词发现](/cn/api-reference/web-scraper-api/social-media-apis/youtube#discover-profiles-by-keywords)
* **重要字段**：
* `name`、`url`、`videos_count`、`views`。
此 API 允许用户基于单一输入 URL 收集多个帖子。
* **发现功能**：
* 通过关键词发现。
* 通过搜索过滤器发现。
* 通过标签发现。
* 通过频道 URL 发现。
* **重要字段**：
* `url`、`title`、`likes`、`views`。
此 API 允许用户通过帖子 URL 收集多个评论。
* **发现功能**：
* 无
* **重要字段**：
* `comment_text`、`replies`、`likes`、`username`。
## 用户资料 API
### 通过 URL 采集
此 API 允许用户使用提供的频道 URL 获取详细的 YouTube 频道信息。
**输入参数**：
YouTube 频道 URL。
**输出结构**：\
包含丰富的数据点：
* **用户资料详情**：\
`url`、`handle`、`name`、`description`、`created_date`、`identifier`、`id`、`handle_md5`。
* **互动指标**：\
`subscribers`、`videos_count`、`views`。
> 所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lk538t2k2p1k3oos71?id=all\&tab=overview)。
* **媒体资源**：\
`profile_image`、`banner_img`。
> 所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lk538t2k2p1k3oos71?id=all\&tab=overview)。
* **附加信息**：\
`details`、`links`、`discovery_input`。
此 API 提供有关 YouTube 频道的详细信息，包括互动指标、用户资料图片及其他关键信息。
### 通过关键词发现
此 API 允许用户通过搜索与频道或其视频相关的特定关键词来发现 YouTube 频道。
**输入参数**：
与频道或其视频相关的关键词。
**输出结构**：\
包含丰富的数据点：
* **用户资料详情**：\
`url`、`handle`、`name`、`description`、`created_date`、`identifier`、`id`、`handle_md5`。
> 所有数据点，[点击这里](https://brightdata.com/cp/data_api/gd_lk538t2k2p1k3oos71/keyword?id=all\&tab=overview)。
* **互动指标**：\
`subscribers`、`videos_count`、`views`。
* **媒体资源**：\
`profile_image`、`banner_img`。
* **附加信息**：\
`details`、`links`、`discovery_input`。
此 API 通过关键词高效发现 YouTube 频道，提供用户资料信息、互动指标及相关详细信息。
## 帖子 API
### 通过 URL 收集
该 API 允许用户使用提供的视频 URL 从 YouTube 获取详细的视频信息。
**输入参数**：
YouTube 视频 URL。
**输出结构**：\
包含丰富的数据点：
* **视频详情**：\
`url`，`title`，`video_url`，`video_length`，`video_id`，`post_type`，`date_posted`，`description`，`music`，`transcript`，`formatted_transcript`。
> 获取所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lk56epmy2i5g7lzu0k?id=all\&tab=overview)。
* **互动指标**：\
`likes`，`views`，`num_comments`，`related_videos`。
* **频道详情**：\
`youtuber`，`youtuber_id`，`handle_name`，`channel_url`，`subscribers`，`verified`，`avatar_img_channel`，`youtuber_md5`。
* **视频媒体与质量**：\
`preview_image`，`viewport_frames`，`current_optimal_res`，`codecs`，`color`，`quality`，`quality_label`。
* **附加信息**：\
`discovery_input`，`shortcode`，`is_sponsored`，`license`。
该 API 使用户能够获取 YouTube 视频的详细信息，包括元数据、互动指标和频道相关信息，支持内容分析与跟踪。
### 通过频道 URL 发现
该 API 允许用户通过 YouTube 频道的 URL 收集该频道发布的视频，并可使用可选过滤条件，如视频数量、日期范围和排序顺序。
**输入参数**：
YouTube 频道 URL。
要收集的视频数量。如果省略，则无上限。
视频过滤起始日期（MM-DD-YYYY）。
视频过滤结束日期（MM-DD-YYYY）。
结果排序方式（例如按浏览量、日期或相关性排序）。
**输出结构**：\
包含丰富的数据点：
* **视频详情**：\
`url`，`title`，`video_url`，`video_id`，`video_length`，`date_posted`，`description`，`post_type`。
> 获取所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lk56epmy2i5g7lzu0k/url?id=all\&tab=overview)。
* **频道详情**：\
`youtuber`，`youtuber_id`，`channel_url`，`handle_name`，`avatar_img_channel`，`subscribers`，`youtuber_md5`，`verified`。
* **互动指标**：\
`likes`，`views`，`num_comments`，`is_sponsored`。
* **媒体与技术信息**：\
`preview_image`，`related_videos`，`music`，`shortcode`，`viewport_frames`，`current_optimal_res`，`codecs`，`color`，`quality`，`quality_label`，`license`。
* **字幕**：\
`transcript`，`formatted_transcript`。
该 API 允许用户高效获取 YouTube 频道中的视频，提供详细的视频、频道和互动信息，并支持过滤和排序选项以增强分析能力。
### 通过关键词发现
该 API 允许用户使用特定关键词搜索 YouTube 视频，并可通过可选参数按日期范围和视频数量进行筛选。
**输入参数**：
搜索视频的关键词。
要收集的视频数量。
视频过滤起始日期（MM-DD-YYYY）。
视频过滤结束日期（MM-DD-YYYY）。
**输出结构**：\
包含丰富的数据点：
* **视频详情**：\
`url`，`title`，`video_url`，`video_id`，`video_length`，`date_posted`，`description`，`post_type`。
> 获取所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lk56epmy2i5g7lzu0k/keyword?id=all\&tab=overview)。
* **频道详情**：\
`youtuber`，`youtuber_id`，`channel_url`，`handle_name`，`avatar_img_channel`，`subscribers`，`youtuber_md5`，`verified`。
* **互动指标**：\
`likes`，`views`，`num_comments`，`is_sponsored`。
* **媒体与技术信息**：\
`preview_image`，`related_videos`，`music`，`shortcode`，`viewport_frames`，`current_optimal_res`，`codecs`，`color`，`quality`，`quality_label`，`license`。
* **字幕**：\
`transcript`，`formatted_transcript`。
该 API 使用户能够通过关键词高效发现 YouTube 视频，并支持高级筛选功能，以实现精准的视频分析与检索。
### 通过搜索过滤条件发现
该 API 允许用户使用高级搜索过滤条件搜索 YouTube 视频，如上传日期、视频类型、时长和其他特性，以实现更精准和有针对性的视频发现。
**输入参数**：
搜索视频的关键词。
按上传日期筛选结果（例如：今天、本周、本月）。
指定视频类型（例如：视频、频道、播放列表）。
按视频时长筛选（例如：短、中、长）。
指定视频附加特性（例如：4K、HD、字幕、直播）。
**输出结构**：\
包含丰富的数据点：
* **视频详情**：\
`url`，`title`，`video_url`，`video_id`，`video_length`，`date_posted`，`description`，`post_type`。
> 获取所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lk56epmy2i5g7lzu0k/search_filters?id=all\&tab=overview)。
* **频道详情**：\
`youtuber`，`youtuber_id`，`channel_url`，`handle_name`，`avatar_img_channel`，`subscribers`，`youtuber_md5`，`verified`。
* **互动指标**：\
`likes`，`views`，`num_comments`，`is_sponsored`。
* **媒体与技术信息**：\
`preview_image`，`related_videos`，`music`，`shortcode`，`viewport_frames`，`current_optimal_res`，`codecs`，`color`，`quality`，`quality_label`，`license`。
* **字幕**：\
`transcript`，`formatted_transcript`。
该 API 提供 YouTube 高级搜索功能，允许用户通过多个参数筛选结果，实现精准和高效的视频发现。
### 通过标签发现
此 API 允许用户通过特定的标签搜索 YouTube 帖子，使用户能够发现与热门话题或特定主题相关的视频。
**输入参数：**
要搜索的标签 (例如：#fitness, #travel)。
要收集的帖子数量。如果省略，则没有限制。
需要从结果中排除的帖子 ID 数组。
以 MM-DD-YYYY 格式指定筛选帖子的起始日期 (应早于 end\_date)。
以 MM-DD-YYYY 格式指定筛选帖子的结束日期 (应晚于 start\_date)。
**输出结构：**\
包含全面的数据点：
* **视频详情：**\
`url`, `title`, `video_url`, `video_id`, `video_length`, `date_posted`, `description`, `post_type`。
> 获取所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lk56epmy2i5g7lzu0k/hashtag?id=all\&tab=overview)。
* **频道详情：**\
`youtuber`, `youtuber_id`, `channel_url`, `handle_name`, `avatar_img_channel`, `subscribers`, `youtuber_md5`, `verified`。
* **互动指标：**\
`likes`, `views`, `num_comments`, `is_sponsored`。
* **媒体和技术信息：**\
`preview_image`, `related_videos`, `music`, `shortcode`, `viewport_frames`, `current_optimal_res`, `codecs`, `color`, `quality`, `quality_label`, `license`。
* **字幕信息：**\
`transcript`, `formatted_transcript`。
此 API 通过搜索与特定标签相关的帖子，实现高效的视频发现，并提供筛选选项以优化搜索结果。
## 评论 API
### 通过 URL 收集
此 API 允许用户使用提供的视频 URL 检索特定 YouTube 视频的详细评论数据。
**输入参数：**
YouTube 视频的 URL。
加载评论回复的次数。
**输出结构：**\
包含全面的数据点：
* **评论详情：**\
`comment_id`, `comment_text`, `likes`, `replies`, `replies_value`, `replies_without_names`。
> 获取所有数据点，请[点击这里](https://brightdata.com/cp/data_api/gd_lk9q0ew71spt1mxywf?id=all\&tab=overview)。
* **用户详情：**\
`username`, `user_channel`, `username_md5`。
* **附加信息：**\
`date`, `url`, `video_id`。
此 API 使用户能够分析 YouTube 视频的评论，包括回复和用户详细信息，从而提供有关互动和受众参与度的洞察。