YouTube（油管）视频详情 API ，JSON 返回结构及解析方法

import requests# 配置项（替换为你的信息）API_KEY = "你的Google API密钥"VIDEO_ID = "dQw4w9WgXcQ"  # YouTube视频ID（从视频URL中提取：https://youtu.be/dQw4w9WgXcQ）def get_youtube_video_detail():
    """调用YouTube视频详情API，获取原始JSON数据"""
    url = "https://www.googleapis.com/youtube/v3/videos"
    params = {
        "id": VIDEO_ID,
        "part": "snippet,statistics,contentDetails,status",  # 返回4个核心模块
        "key": API_KEY    }

    try:
        response = requests.get(url, params=params, timeout=15)
        response.raise_for_status()  # 抛出HTTP错误
        json_data = response.json()
        return json_data    except Exception as e:
        print(f"请求失败：{e}")
        return None# 执行调用，获取原始JSONraw_json = get_youtube_video_detail()if raw_json:
    # 格式化打印JSON（便于查看结构）
    import json    print(json.dumps(raw_json, ensure_ascii=False, indent=2))

{
  "kind": "youtube#videoListResponse",
  "etag": "XXXXXXXXXX",
  "items": [
    {
      "kind": "youtube#video",
      "etag": "XXXXXXXXXX",
      "id": "dQw4w9WgXcQ",
      "snippet": {
        "publishedAt": "2009-10-25T07:18:22Z",
        "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
        "title": "Rick Astley - Never Gonna Give You Up (Official Music Video)",
        "description": "Official Music Video for “Never Gonna Give You Up” by Rick Astley...",
        "thumbnails": {
          "default": {"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/default.jpg", "width": 120, "height": 90},
          "medium": {"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/mqdefault.jpg", "width": 320, "height": 180},
          "high": {"url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg", "width": 480, "height": 360}
        },
        "channelTitle": "Rick Astley",
        "tags": ["Rick Astley", "Never Gonna Give You Up", "80s"],
        "categoryId": "10",  // 10=音乐类
        "liveBroadcastContent": "none",
        "localized": {
          "title": "Rick Astley - Never Gonna Give You Up (Official Music Video)",
          "description": "..."
        }
      },
      "statistics": {
        "viewCount": "1400000000",  // 播放量
        "likeCount": "10000000",    // 点赞数
        "dislikeCount": "0",        // YouTube已隐藏该字段，固定为0
        "favoriteCount": "0",
        "commentCount": "500000"    // 评论数
      },
      "contentDetails": {
        "duration": "PT3M33S",  // 时长（ISO 8601格式：3分33秒）
        "dimension": "2d",
        "definition": "hd",     // 清晰度：hd/fhd/sd
        "caption": "true",      // 是否有字幕
        "licensedContent": true // 是否为授权内容
      },
      "status": {
        "uploadStatus": "processed",
        "privacyStatus": "public",  // 隐私状态：public/private/unlisted
        "license": "youtube",
        "embeddable": true,         // 是否允许嵌入
        "publicStatsViewable": true // 统计数据是否公开
      }
    }
  ],
  "pageInfo": {
    "totalResults": 1,
    "resultsPerPage": 1
  }}

import jsonimport isodate  # 解析ISO 8601时长，需安装：pip install isodatedef parse_youtube_video_json(raw_json):
    """
    解析YouTube视频详情JSON，返回标准化字典
    :param raw_json: API返回的原始JSON数据
    :return: 清洗后的视频信息字典
    """
    if not raw_json or "items" not in raw_json or len(raw_json["items"]) == 0:
        return None
    
    # 提取第一个视频的核心数据（单视频查询时仅1条）
    video_data = raw_json["items"][0]
    snippet = video_data.get("snippet", {})
    statistics = video_data.get("statistics", {})
    content_details = video_data.get("contentDetails", {})
    status = video_data.get("status", {})

    # 解析时长（ISO 8601 → 秒数）
    duration_iso = content_details.get("duration", "PT0S")
    try:
        duration_seconds = isodate.parse_duration(duration_iso).total_seconds()
        duration_min = round(duration_seconds / 60, 1)  # 转为分钟（保留1位小数）
    except:
        duration_min = 0.0

    # 标准化解析（全容错）
    parsed_result = {
        "视频ID": video_data.get("id", ""),
        "标题": snippet.get("title", "").strip(),
        "发布时间": snippet.get("publishedAt", ""),
        "频道名称": snippet.get("channelTitle", "未知"),
        "视频描述": snippet.get("description", "").strip()[:500],  # 截取前500字
        "标签": ",".join(snippet.get("tags", [])),  # 数组转字符串
        "分类ID": snippet.get("categoryId", ""),
        # 统计数据（字符串转整型，默认0）
        "播放量": int(statistics.get("viewCount", 0)),
        "点赞数": int(statistics.get("likeCount", 0)),
        "评论数": int(statistics.get("commentCount", 0)),
        # 内容详情
        "时长(分钟)": duration_min,
        "清晰度": content_details.get("definition", "sd"),
        "是否有字幕": content_details.get("caption", "false") == "true",
        # 状态信息
        "隐私状态": status.get("privacyStatus", "unknown"),
        "是否允许嵌入": status.get("embeddable", False),
        # 缩略图（取最高清）
        "高清缩略图URL": snippet.get("thumbnails", {}).get("high", {}).get("url", "")
    }
    return parsed_result# 调用示例if raw_json:
    parsed_video = parse_youtube_video_json(raw_json)
    print("=== 解析后的视频详情 ===")
    for key, value in parsed_video.items():
        print(f"{key}：{value}")

def batch_parse_videos(video_ids):
    """
    批量解析多个YouTube视频
    :param video_ids: 视频ID列表，如["id1", "id2"]
    :return: 标准化视频列表
    """
    url = "https://www.googleapis.com/youtube/v3/videos"
    params = {
        "id": ",".join(video_ids),  # 多ID逗号分隔
        "part": "snippet,statistics,contentDetails",
        "key": API_KEY,
        "maxResults": 50  # 最多50条
    }

    try:
        response = requests.get(url, params=params, timeout=15)
        response.raise_for_status()
        raw_json = response.json()
    except Exception as e:
        print(f"批量请求失败：{e}")
        return []

    # 批量解析
    video_list = []
    for video in raw_json.get("items", []):
        # 构造单视频的JSON结构，复用解析函数
        single_video_json = {"items": [video]}
        parsed = parse_youtube_video_json(single_video_json)
        if parsed:
            video_list.append(parsed)
    return video_list# 调用示例# VIDEO_IDS = ["dQw4w9WgXcQ", "9bZkp7q19f0"]# batch_result = batch_parse_videos(VIDEO_IDS)# for idx, video in enumerate(batch_result, 1):#     print(f"\n{idx}. {video['标题']} | 播放量：{video['播放量']}")