YouTube API 文档

YouTube API: 帖子 — 按用户标识符

通过专门的“按用户标识符”操作从 YouTube 获取帖子数据,并将其接入产品工作流。

当输入标识符或参数已知、需要一个可预期的 API 结果时,请使用此方法。

方法 GET
实体 帖子
版本 2
此端点的作用

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

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

此端点可以帮助您

响应包含公开的帖子数据以及后续 API 请求所需的上下文。

何时使用

当输入标识符或参数已知、需要一个可预期的 API 结果时,请使用此方法。

常见使用场景

精准获取

只请求您需要的对象,而无需加载更大的集合。

产品数据补全

将 YouTube API 结果添加到记录、工作流和内部工具中。

请求编排

将响应用作相邻方法和多步骤工作流的输入。

可用版本

响应版本

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

响应版本 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/posts/by-user-identifier

规范化格式

代码示例

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/youtube.com/posts/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": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "user_identifier": "mkbhd"
  },
  "data": {
    "posts": {
      "count": 8,
      "items": [
        {
          "author": {
            "url": "https://www.youtube.com/@mkbhd",
            "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
            "username": "mkbhd",
            "display_name": "Marques Brownlee",
            "avatar_url": "https://example.com/image.jpg",
            "avatar_urls": "https://example.com/image.jpg"
          },
          "url": "https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ",
          "post_id": "UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ",
          "text": "Alright, it's that time: https://vote.mkbhd.com\n\nWelcome to the Blind Smartphone Camera Test 2023! 20 smartphones. 3 categories. Scientific winners revealed (I'll collect and re…",
          "hashtags": [],
          "emails": [],
          "published_time": "2 years ago (edited)",
          "is_edited": true,
          "vote_count": 11000,
          "comment_count": 1000,
          "links": [
            {
              "url": "https://vote.mkbhd.com/",
              "link_type": "website",
              "label": "https://vote.mkbhd.com",
              "channel_id": null,
              "video_id": null
            }
          ],
          "attachment_type": "image",
          "attached_video": null,
          "image_count": 1,
          "images": [
            {
              "image_url": "https://example.com/image.jpg",
              "thumbnails": "…"
            }
          ]
        },
        {
          "author": {
            "url": "https://www.youtube.com/@mkbhd",
            "channel_id": "UCBJycsmduvYEL83R_U4JriQ",
            "username": "mkbhd",
            "display_name": "Marques Brownlee",
            "avatar_url": "https://example.com/image.jpg",
            "avatar_urls": "https://example.com/image.jpg"
          },
          "url": "https://www.youtube.com/post/Ugkxa3BN5SFLT-KGgPZYyJlmsaR_vGGhu9ok",
          "post_id": "Ugkxa3BN5SFLT-KGgPZYyJlmsaR_vGGhu9ok",
          "text": "Introducing a new colorway and updated design: 251.1. Now in matte black. (Plus a new water repellent ripstop mesh and a little touch of silver reflective detail for the winter)…",
          "hashtags": [],
          "emails": [],
          "published_time": "2 years ago",
          "is_edited": false,
          "vote_count": 31000,
          "comment_count": 1300,
          "links": [
            {
              "url": "https://atoms.com/products/mkbhd251-1",
              "link_type": "website",
              "label": "https://atoms.com/products/mkbhd251-1",
              "channel_id": null,
              "video_id": null
            }
          ],
          "attachment_type": "multi_image",
          "attached_video": null,
          "image_count": 4,
          "images": [
            {
              "image_url": "https://example.com/image.jpg",
              "thumbnails": "…"
            },
            {
              "image_url": "https://example.com/image.jpg",
              "thumbnails": "…"
            },
            {
              "_more_items": 2
            }
          ]
        },
        {
          "_more_items": 6
        }
      ]
    }
  }
}
下一步

继续评估

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

打开 YouTube 平台页面

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

打开平台页面

比较 API 方法价格

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

查看价格

查看集成规则

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

打开文档
常见问题

团队在实现前常问的问题

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

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

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

应该选择 V1 还是 V2?

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

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

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