Youtube Video Search 用于根据关键词获取 YouTube 视频搜索结果。

• 按关键词搜索 YouTube 视频
• 支持按地区获取对应结果
• 支持通过 continuation 获取下一页结果
• 返回视频列表和下一页 continuation token

使用 XCrawl 获取 Youtube 视频搜索结果

使用方式

curl -s -X POST 'https://run.xcrawl.com/v1/data' \
  -H 'Authorization: Bearer $XCRAWL_API_KEY'\
  -H 'Content-Type: application/json' \
  -d '{
    "engine": "youtube_video_search",
    "keyword": "coffee",
    "location": "US",
    "continuation": "xxxx"
  }'

请求参数说明：

• engine 固定为 youtube_video_search
• keyword 用于指定搜索关键词
• location 用于指定搜索地区
• continuation 用于请求下一页结果

响应示例

{
  "result": [
    {
      "video_list": [
        {
          "video_id": "DzLgJg4uAng",
          "push_time": "6 months ago",
          "thumbnail": [
            {
              "url": "https://i.ytimg.com/vi/DzLgJg4uAng/hq720.jpg",
              "width": 360,
              "height": 202
            }
          ],
          "video_user": "Karl Conrad",
          "video_title": "14\" MacBook Pro M4 Pro UNBOXING (Space Black)",
          "video_length": "0:19",
          "video_view_count": "1,502,716 views",
          "video_user_sort_url": "/@KarlConrad"
        }
      ],
      "continuation": "EqADEgdt....."
    }
  ]
}

参数说明

必填参数

参数	类型	说明
location	string	指定搜索地区。
keyword	string	指定搜索关键词。

可选参数

参数	类型	说明
continuation	string	用于请求下一页结果的 continuation token。

参数补充说明

• location 默认值为 US
• location 支持多个地区值，例如 US、HK、CA、AD、AE
• keyword 默认值为 coffee
• continuation 默认值为空字符串

响应字段

响应数据位于 result[]。

字段	类型	说明
video_list	array	视频结果列表。
continuation	string	下一页结果使用的 continuation token。

视频字段

video_list[] 中每个元素包含以下字段：

字段	类型	说明
video_id	string	YouTube 视频 ID。
push_time	string	视频发布时间相对当前时间的描述。
thumbnail	array	视频缩略图列表。
video_user	string	发布视频的频道名称。
video_title	string	视频标题。
video_length	string	视频时长。
video_view_count	string	视频播放量。
video_user_sort_url	string	频道短链接路径。

缩略图字段

thumbnail[] 中每个元素包含以下字段：

字段	类型	说明
url	string	缩略图地址。
width	number	缩略图宽度。
height	number	缩略图高度。

上一页Google Play TV Detail

下一页Google Question Search