能否通过API获取YouTube视频观众留存数据（Python优先）

核心结论 #

截止2024年，没有官方公开API支持获取任意YouTube视频的观众留存数据，你提到的多年前反馈的功能需求，至今未在公开API中正式上线。

可实现的数据获取边界 #

• 仅支持获取你本人所有、且完成账号授权的自有频道视频留存数据，无法跨账号获取其他创作者的视频真实留存数据。
• 自有频道数据可以通过以下两种Python可实现的方式获取：
  • 官方YouTube Analytics API（合规方式）：仅能拉取自有账号下视频的留存相关聚合指标，基础调用示例如下：

    from googleapiclient.discovery import build
    
    # 填入你自己完成OAuth2授权的账号凭证
    yt_analytics = build('youtubeAnalytics', 'v2', credentials=your_auth_credentials)
    report = yt_analytics.reports().query(
        ids='channel==MINE',
        startDate='查询起始日期，格式为YYYY-MM-DD',
        endDate='查询截止日期，格式为YYYY-MM-DD',
        metrics='audienceWatchRatio,relativeRetentionPerformance',
        dimensions='elapsedVideoTimeRatio',
        filters='video==你自己账号下的目标视频ID'
    ).execute()
    

  • 非官方接口爬取：通过模拟登录YouTube Studio后台的方式抓取更精细的留存曲线数据，这种方式不符合平台服务条款，存在账号被限流、封禁的风控风险。

关于任意非自有视频留存数据的说明 #

所有声称可以获取任意第三方YouTube视频真实留存数据的方式，都不属于官方开放的合法能力：要么是违规爬取平台非公开数据存在合规风险，要么是基于公开播放、互动数据推算的估算值，和后台真实留存数据存在偏差。

内容的提问来源于stack exchange，提问作者THEMOUNTAINSANDTHESKIES