YouTube API 文档

YouTube API: 播放列表 — 按用户标识符

从 YouTube 加载分页的播放列表集合,用于同步、归档和监控。

在需要保证条目顺序和下一页续取的定期采集工作流中使用“按用户标识符”。

方法 GET
实体 播放列表
版本 2
此端点的作用

利用此 API 方法可以构建什么

先查看结果和常见工作流,然后再了解参数和可运行的请求示例。

此端点可以帮助您

响应包含播放列表集合、每个条目的上下文以及下一页的游标。

何时使用

在需要保证条目顺序和下一页续取的定期采集工作流中使用“按用户标识符”。

常见使用场景

数据同步

按顺序将新的 YouTube 条目迁入内部存储。

归档

保存可用的公开集合,以便搜索和后续处理。

定期监控

从最新的一页继续,发现新出现的对象。

可用版本

响应版本

两个版本完成相同的任务,接受相同的参数。使用切换按钮比较响应结构,并选择您的客户端所需的版本。

响应版本 V2

在本页面切换版本,即可在同一文档 URL 下比较响应结构。

保持不变的部分

V1 和 V2 的身份验证、必填参数和请求结构均相同。实际上,您只需在构建端点路径和解析响应时选择版本。

版本之间的差异

主要区别在于响应结构。新集成请使用 V2;仅在需要兼容现有客户端契约时保留 V1。

使用方法

如何调用该方法

两个版本使用相同的 API 密钥请求头和相同的查询参数。本文档先展示共享的参数集合,然后展示各版本特定的端点路径和代码片段。

输入参数

共享参数
参数 必填 类型 示例 说明
user_identifier 是 str mkbhd YouTube channel handle, username, or channel identifier. Example: mkbhd.
cursor 否 str | None cursor-next-page 上一次响应返回的下一页游标。获取第一页时请省略。

各版本的请求路径

V2

复制确切的端点路径、示例 URL 和代码片段时请选择版本。上方的参数列表保持不变。

GET /api/v2/youtube.com/playlist/by-user-identifier

规范化格式

代码示例

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/youtube.com/playlist/by-user-identifier" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'user_identifier=mkbhd' \
  # Optional parameters:
  # --data-urlencode 'cursor=cursor-next-page'
响应示例

按版本查看真实响应

预览保留了关键字段和集合中的前几项,便于您快速浏览响应结构。切换版本会改变 JSON 格式。

响应示例

V2 响应 JSON

已验证示例

此简明 JSON 示例来自 V2 最近一次成功的验证运行。

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": null,
    "has_more": false
  },
  "search_context": {
    "user_identifier": "mkbhd"
  },
  "data": {
    "playlists": {
      "count": 23,
      "items": [
        {
          "url": "https://www.youtube.com/playlist?list=PLBsP89CPrMeNIuvr9j3_EQaMwaNJ6rhuQ",
          "playlist_id": "PLBsP89CPrMeNIuvr9j3_EQaMwaNJ6rhuQ",
          "title": "Retro Tech S2",
          "playlist_type": "series",
          "video_count": 5,
          "content_count_text": "5 episodes",
          "first_video_id": "ifI_fwg55k8",
          "first_video_url": "https://www.youtube.com/watch?v=ifI_fwg55k8&list=PLBsP89CPrMeNIuvr9j3_EQaMwaNJ6rhuQ",
          "thumbnail_url": "https://example.com/image.jpg",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/ifI_fwg55k8/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLB60CMX6sapZh-Ie9FtxWJza9a9QA",
              "width": 480,
              "height": 270
            }
          ]
        },
        {
          "url": "https://www.youtube.com/playlist?list=PLBsP89CPrMeO7uztAu6YxSB10cRMpjgiY",
          "playlist_id": "PLBsP89CPrMeO7uztAu6YxSB10cRMpjgiY",
          "title": "Retro Tech",
          "playlist_type": "series",
          "video_count": 11,
          "content_count_text": "11 episodes",
          "first_video_id": "kMtN9KJHn5Y",
          "first_video_url": "https://www.youtube.com/watch?v=kMtN9KJHn5Y&list=PLBsP89CPrMeO7uztAu6YxSB10cRMpjgiY",
          "thumbnail_url": "https://example.com/image.jpg",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/kMtN9KJHn5Y/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLC0TNdLeMkXHV1ZDh1TcFSCFIhhgw",
              "width": 480,
              "height": 270
            }
          ]
        },
        {
          "_more_items": 21
        }
      ]
    }
  }
}
下一步

继续评估

将本文档作为第一个决策点,然后在将端点接入常规使用之前,继续了解价格、平台覆盖范围和集成规则。

打开 YouTube 平台页面

在实现之前,比较相邻的实体、API 方法分组和相关文档。

打开平台页面

比较 API 方法价格

在扩大使用规模之前,查看此 API 方法在公开价格表中的位置。

查看价格

查看集成规则

通过入门文档确认身份验证、版本管理、重试以及模拟环境与正式环境的差异。

打开文档
常见问题

团队在实现前常问的问题

借助这些解答,判断此 API 方法是否适合您的工作流、版本选择和上线计划。

此 YouTube API 方法返回哪些数据?

该方法针对播放列表执行“按用户标识符”操作。下方的简明响应示例展示了确切的字段结构。

应该选择 V1 还是 V2?

新集成请选择 V2,因为它提供规范化的结构。仅在兼容已使用平台原生格式的客户端时使用 V1。

第一个请求需要准备什么?

创建 API 密钥,在请求头中发送它,并提供表格中的必填参数。代码示例中已包含正确的路径和请求结构。