核心用法
YouTube Search 是一款面向开发者和研究人员的 YouTube 内容检索与转录技能，通过 TranscriptAPI.com 提供标准化 API 服务。
主要功能模块
1. 全局搜索 (/api/v2/youtube/search)
- 按关键词搜索视频或频道
- 返回结构化元数据：视频 ID、标题、频道信息、时长、观看量、发布时间、字幕可用状态
- 支持视频/频道类型过滤，结果数 1-50 可调
2. 频道内搜索 (/api/v2/youtube/channel/search)
- 在特定频道内精准检索视频
- 支持
@handle、频道 URL 或UC...ID 作为频道标识
3. 频道解析 (/api/v2/youtube/channel/resolve)
- 免费将
@handle转换为标准频道 ID
4. 转录获取（需配合 transcript 端点）
- 提取视频字幕，支持纯文本/时间戳格式
显著优点
- 即用即付：100 免费额度，无信用卡注册门槛
- 结构化输出：JSON 格式，便于程序化分析和集成
- 灵活标识：支持多种频道引用方式（handle/URL/ID）
- 速率友好：免费 tier 支持 300 req/min
潜在缺点与局限性
- 付费墙：超出 100 额度需充值
- 速率限制：高频场景需升级套餐
- 依赖第三方：TranscriptAPI.com 服务可用性决定功能稳定性
- YouTube 限制：频道内搜索上限约 30 条结果
适合人群
- 内容研究者、数据分析师、自动化工作流开发者、需要批量处理 YouTube 元数据的团队
常规风险
- API 密钥泄露风险（存储于本地 shell profile）
- 超出额度导致服务中断
- YouTube 反爬策略变化可能影响服务稳定性
技术细节
- 环境依赖: Node.js,
TRANSCRIPT_API_KEY - 认证流程: 邮箱注册 → OTP 验证 → 自动密钥配置
- 错误处理: 402（额度不足）、404（未找到）、408（超时重试）、422（无效频道标识）