YouTube Stats API

A lightweight wrapper around the YouTube Data API that provides structured endpoints for fetching video details, channel statistics, trending content, playlists, comments, and more — designed for easy integration and rapid prototyping.

原始信息汇总

根据提供的HTML内容，以下是该数据集的详情总结：

数据集概述：YouTube Stats API

• 平台：RapidAPI
• 提供者：Aakash Giri
• 类别：娱乐 (Entertainment)
• 适用计划：基础版 (BASIC / $0.00/mo)、专业版 (PRO / $5.00/mo)、至尊版 (ULTRA / $25.00/mo)、顶级版 (MEGA / $99.00/mo)

核心描述

一个围绕 YouTube 数据 API 的轻量级封装，提供结构化的端点，用于获取视频详细信息、频道统计、热门内容、播放列表、评论等，专为易于集成和快速原型设计而构建。

主要功能特点

• 全面数据提取：访问视频、频道、播放列表、评论和订阅。
• 实时洞察：检查频道是否正在直播或即将有直播。
• 深度分析：获取详细指标，包括观看次数、点赞数、评论数和订阅者数。
• 全球覆盖：根据区域代码检索热门视频和类别。
• 可访问性：提取任何视频的字幕。

可用端点 (共14个)

1. 频道与用户 (Channels & Users)

• GET /youtube/channel (获取频道详情)：根据频道ID获取元数据和统计数据。
  • 必需参数：id (频道ID)
• GET /youtube/subscriptions (列出订阅)：获取特定频道订阅的频道列表。
  • 必需参数：channelId
  • 可选参数：maxResults (默认20)

2. 视频与内容 (Videos & Content)

• GET /youtube/video (获取视频详情)：根据视频ID获取详细信息。
  • 必需参数：id
• GET /youtube/videoStats (获取视频统计)：快速获取视频的指标（观看次数、点赞数、评论数等）。
  • 必需参数：videoId
• GET /youtube/search (搜索视频)：在 YouTube 上搜索视频。【仅限至尊版(ULTRA)和顶级版(MEGA)计划】
  • 必需参数：q (搜索查询)
  • 可选参数：maxResults (默认10), order (默认 relevance)
• GET /youtube/trending (获取热门视频)：检索特定地区的最受欢迎视频。
  • 可选参数：country (默认 US), maxResults (默认10)
• GET /youtube/related (获取相关视频)：发现与特定视频相关的视频。【仅限至尊版(ULTRA)和顶级版(MEGA)计划】
  • 必需参数：videoId
  • 可选参数：maxResults (默认10)

3. 播放列表 (Playlists)

• GET /youtube/playlist (获取播放列表详情)：检索特定播放列表的元数据。
  • 必需参数：id
• GET /youtube/playlistItems (获取播放列表项目)：列出播放列表中的视频。
  • 必需参数：playlistId
  • 可选参数：maxResults (默认20)

4. 社区与元数据 (Community & Metadata)

• GET /youtube/comments (获取评论)：获取特定视频的顶级评论。
  • 必需参数：videoId
  • 可选参数：maxResults (默认20)
• GET /youtube/categories (获取类别)：检索特定地区的视频类别列表。
  • 可选参数：regionCode (默认 US)
• GET /youtube/captions (获取字幕)：列出视频可用的字幕轨道。【仅限专业版(PRO)、至尊版(ULTRA)和顶级版(MEGA)计划】
  • 必需参数：videoId

5. 直播 (Live Streams)

• GET /youtube/live (检查直播状态)：检查特定频道是否正在直播。【仅限至尊版(ULTRA)和顶级版(MEGA)计划】
  • 必需参数：channelId
• GET /youtube/upcomingLive (获取即将到来的直播)：查找频道即将举行的直播。【仅限至尊版(ULTRA)和顶级版(MEGA)计划】
  • 必需参数：channelId

认证方式

所有请求必须在请求头中包含 RapidAPI 密钥：

• x-rapidapi-host: <YOUR-RAPIDAPI-HOST>
• x-rapidapi-key: YOUR_API_KEY

基础URL

通过 RapidAPI 消费此 API 时，使用提供的托管主机 URL。

错误处理

API 返回标准 HTTP 状态码：

• 200 OK：成功
• 400 Bad Request：缺少必需的查询参数。
• 403 Forbidden：API 配额超出或评论被禁用。
• 404 Not Found：请求的资源不存在。
• 500 Internal Server Error：服务器内部错误。