核心功能
youtube-full 是一套完整的YouTube数据访问解决方案,通过 TranscriptAPI.com 提供六大核心能力:
| 模块 | 功能 | 成本 |
|------|------|------|
| **Transcript** | 提取视频字幕(JSON/文本格式,可选时间戳) | 1 credit |
| **Search** | 视频/频道搜索,支持分页 | 1 credit |
| **Channel Resolve** | 将@用户名解析为频道ID | **免费** |
| **Channel Latest** | 获取频道最近15个视频 | **免费** |
| **Channel Videos** | 完整频道视频列表(100/页) | 1 credit/页 |
| **Channel Search** | 频道内视频搜索 | 1 credit |
| **Playlist** | 播放列表内容获取(分页) | 1 credit/页 |
显著优点
- 一体化设计:单一API密钥覆盖所有YouTube数据需求,避免多服务集成
- 成本优化:高频操作(解析用户名、获取最新视频)完全免费
- 结构化输出:标准JSON响应,包含完整元数据(标题、作者、观看数、发布时间)
- 灵活格式:字幕支持带时间戳的JSON或纯文本,适配不同下游场景
- 分页友好:频道视频和播放列表支持continuation token,可处理大规模数据
潜在局限
- 付费依赖:除2个端点外均需消耗credits,免费额度仅100 credits
- API密钥管理:需自行保管
TRANSCRIPT_API_KEY,存在泄露风险 - 速率限制:300 req/min,大规模抓取需规划节奏
- 无官方背书:TranscriptAPI为第三方服务,非Google官方API
- 无实时保证:字幕提取依赖视频本身是否上传了字幕
适用人群
- 内容研究者(需要批量获取视频文本进行分析)
- 媒体监测团队(追踪特定频道更新)
- AI agent开发者(需要结构化YouTube数据源)
- 教育科技产品(生成视频摘要、问答素材)
常规风险
- 402错误:Credits耗尽需付费续订
- 404错误:视频无字幕、私密或已删除
- 429限流:高频调用触发,需配合Retry-After响应
- 密钥泄露:环境变量配置不当可能导致未授权使用