[中文]

用途:

• 获取YouTube视频的相似内容推荐（推荐视频列表）
• 类似于视频播放页面右侧的相关视频
• 一次性返回所有推荐视频（通常20-30个）

参数:

• video_id: 视频ID（推荐）
• video_url: 完整的视频URL（可选，如果提供video_id则忽略）
• need_format: 是否格式化数据（默认 true）
  • true: 返回格式化的结构化数据（推荐）
  • false: 返回原始的 YouTube API 结构（用于调试或自定义解析）

返回数据包含:

当 need_format=true 时:

• video_id: 当前视频ID
• related_videos: 相关视频列表（格式化后的数据）
  • video_id: 相关视频的ID
  • title: 视频标题
  • author: 作者名称
  • author_id: 作者频道ID
  • author_url: 作者频道链接
  • length_text: 视频时长文本（如 "3:45"）
  • length_seconds: 视频时长（秒数）
  • view_count_text: 观看次数文本（如 "1.2M views"）
  • short_view_count_text: 简短观看次数文本（如 "1.2M"）
  • published_time_text: 发布时间文本（如 "2 days ago"）
  • thumbnails: 所有分辨率的缩略图列表
  • rich_thumbnail: 动态缩略图（如果有）
  • badges: 视频徽章（如 NEW、LIVE 等）
  • owner_badges: 作者徽章（如验证标识）
  • video_url: 视频链接
  • navigation_endpoint: 导航端点
• total_count: 推荐视频总数

当 need_format=false 时:

• video_id: 当前视频ID
• related_videos: 原始的 lockupViewModel 对象列表
• total_count: 推荐视频总数

注意事项:

• 每个视频的推荐内容由 YouTube 算法生成，可能会变化
• 推荐列表通常包含 20-30 个视频
• ⚠️ 此接口不支持分页，一次性返回所有推荐视频

价格:

• $0.001 USD / 请求

[English]

Purpose:

• Get YouTube video's related content recommendations (recommended videos list)
• Similar to the related videos shown on the right side of video playback page
• Returns all recommended videos at once (typically 20-30 videos)

Parameters:

• video_id: Video ID (recommended)
• video_url: Full video URL (optional, ignored if video_id is provided)
• need_format: Whether to format data (default true)
  • true: Return formatted structured data (recommended)
  • false: Return raw YouTube API structure (for debugging or custom parsing)

Returns:

When need_format=true:

• video_id: Current video ID
• related_videos: Related videos list
  • video_id: Related video's ID
  • title: Video title
  • author: Author name
  • author_id: Author channel ID
  • author_url: Author channel URL
  • length_text: Video duration text (e.g., "3:45")
  • length_seconds: Video duration in seconds
  • view_count_text: View count text (e.g., "1.2M views")
  • short_view_count_text: Short view count text (e.g., "1.2M")
  • published_time_text: Published time text (e.g., "2 days ago")
  • thumbnails: All resolution thumbnails
  • rich_thumbnail: Moving thumbnail (if available)
  • badges: Video badges (e.g., NEW, LIVE)
  • owner_badges: Channel verification badges
  • video_url: Video URL
  • navigation_endpoint: Navigation endpoint
• total_count: Total number of recommended videos

When need_format=false:

• video_id: Current video ID
• related_videos: Raw lockupViewModel object list
• total_count: Total number of recommended videos

Notes:

• Each video's recommendations are generated by YouTube's algorithm and may change
• Recommendation list typically contains 20-30 videos
• ⚠️ This API does not support pagination, returns all recommendations at once

Price:

• $0.001 USD / request

[示例/Example]

获取推荐视频: video_id = "dQw4w9WgXcQ"