transcriptapi

📺 YouTube 数据一站式 API 工具箱

一站式 YouTube 数据 API,支持转录文本提取、视频搜索、频道监控与播放列表浏览,100 免费积分开箱即用。

收藏
14.8k
安装
5.5k
版本
1.2.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心功能

TranscriptAPI 提供完整的 YouTube 程序化数据获取能力,涵盖六大核心模块:

1. 字幕转录 (`/transcript`) — 核心能力,支持任意 YouTube 视频(含 Shorts)的字幕提取,返回 JSON 结构化数据或纯文本,可选时间戳与元数据。支持多语言自动识别,是视频摘要、内容分析、AI 训练数据构建的基础工具。

2. 智能搜索 (`/search`) — 支持视频与频道双维度检索,返回丰富的结构化字段:观看量、时长、发布时间、频道认证状态、字幕可用性等,便于快速筛选目标内容。

3. 频道管理套件 — 包含四大工具:

  • channel/resolve(免费):@用户名/URL/ID 互转
  • channel/latest(免费):RSS 模式获取最新 15 条视频,含精确观看量
  • channel/videos:分页获取完整上传列表(100 条/页)
  • channel/search:频道内关键词搜索

4. 播放列表浏览 (`/playlist/videos`):支持标准播放列表、稍后观看、 liked videos 等特殊列表的分页遍历。

显著优点

  • 成本友好:免费 tier 100 积分,关键端点(频道解析、最新视频)零消耗
  • 数据丰富:返回 YouTube 原生隐藏或难以抓取的字段(精确观看量、频道 handle、RSS feed URL)
  • 格式灵活:转录支持 JSON(结构化)与 text(下游 LLM 友好)双输出
  • 开发体验佳:统一 Bearer Token 鉴权,清晰的错误码体系(402 欠费、408 重试、429 限流)

局限性与风险

数据依赖风险:字幕提取依赖视频创作者上传的字幕或 YouTube 自动生成字幕,无字幕视频返回 404;自动字幕质量参差不齐,专业术语、口音视频误差率高。

配额限制:免费 300 req/min 对批量处理较紧张,高并发场景需升级付费计划。

合规边界:工具仅提供数据获取能力,用户需自行确保符合 YouTube ToS 第 4.H 条(禁止大规模自动化下载)及当地著作权法规,商业性转录再分发存在法律灰色地带。

单点依赖:第三方商业服务,存在定价调整、服务终止或 API 变更风险,建议核心业务场景保持数据缓存与备选方案。

适用人群

  • 内容创作者与研究者:批量获取竞品频道数据、构建视频内容数据库
  • AI/ML 开发者:构建 YouTube 视频理解、摘要、问答的训练数据集
  • 媒体监控从业者:追踪特定频道更新、热点话题视频追踪
  • 教育机构:为无障碍学习获取课程字幕文本

定价

| 层级 | 月费 | 积分 | 速率限制 |
|------|------|------|----------|
| 免费 | $0 | 100 | 300/min |
| Starter | $5 | 1,000 | 300/min |

转录 1 积分/次,搜索 1 积分/次,频道/播放列表分页 1 积分/页,关键解析接口免费。

安全解读

核心用法

TranscriptAPI 是一个纯文档型 Skill,为用户提供通过 TranscriptAPI.com 访问 YouTube 数据的完整 API 指南。用户需自行注册获取 API 密钥(TRANSCRIPT_API_KEY),按文档中的 curl 示例手动执行请求。

主要功能

  • 转录获取:提取视频字幕(支持 JSON/text 格式,可选时间戳)
  • 全局搜索:视频/频道搜索(1-50 条结果)
  • 频道管理:解析频道 ID、浏览上传列表、获取最新 15 条视频(免费)、频道内搜索
  • 播放列表:遍历播放列表全部视频

典型工作流channel/resolve(免费)→ channel/latest(免费)→ transcript(1 积分)获取最新视频转录。

显著优点

| 优势 | 说明 |
|------|------|
| **零执行风险** | 纯 Markdown 文档,无本地代码运行,彻底杜绝代码注入、沙盒逃逸等风险 |
| **清晰的成本结构** | 明确标注积分消耗:转录/搜索/分页各 1 积分,`resolve`/`latest` 免费,免费 tier 含 100 积分 |
| **完整的错误处理** | 提供 401/402/404/408/422/429 等状态码的明确处理建议 |
| **灵活的输出格式** | 转录支持 JSON(结构化)或纯文本,可选时间戳与元数据 |
| **批量处理能力** | 支持分页 token 遍历频道全部上传或大型播放列表 |

潜在缺点与局限性

  • 完全依赖第三方:服务可用性、数据准确性、隐私政策均由 TranscriptAPI.com 控制,无 fallback 机制
  • 无原生 SDK:仅提供 curl 示例,需用户自行封装为 Python/JS 等客户端
  • 隐私信息未明确:Skill 未链接 transcriptapi.com 的隐私政策,用户需自行查证
  • 积分消耗陷阱channel/videos 按页计费(约 100 视频/页),遍历大型频道成本较高
  • 无离线能力:必须联网,无法缓存或离线处理

适合人群

  • 内容研究者:批量获取 YouTube 转录进行 NLP 分析、主题建模
  • 媒体监测团队:监控特定频道更新,自动化摘要生成
  • 开发者:需要 YouTube Data API 替代方案(规避 Google 配额限制)
  • 播客/视频制作人:快速获取参考素材的口述内容

常规风险

1. API 密钥泄露:用户手动配置环境变量,存在误提交到版本控制的风险
2. 成本失控:未注意分页计费,大量调用快速耗尽积分

3. 数据隐私:处理的视频可能含敏感个人信息,需遵守 GDPR/CCPA

4. 服务中断:第三方 API 变更或下线将影响工作流

5. 内容版权:转录内容受原视频版权保护,商用需谨慎

配置建议

# 安全存储密钥(避免硬编码)
echo 'export TRANSCRIPT_API_KEY="sk_..."' >> ~/.zshenv
source ~/.zshenv

# 验证配置
echo $TRANSCRIPT_API_KEY | grep -q "^sk_" && echo "✓ Key configured" || echo "✗ Key missing"

transcriptapi 内容

手动下载zip · 3.1 kB
SKILL.mdtext/markdown
请选择文件