Toucora RAG와 AI 에이전트
자막을 직접 스크랩하지 않고도 깨끗하고 타임스탬프가 있는 스크립트를 임베딩, 벡터 DB, LLM 파이프라인에 공급하세요.
개발자 인프라
개발자가 진짜 원하는 YouTube 스크립트 API
공개 YouTube 영상, 재생목록, 채널에서 구조화된 스크립트를 가져오는 하나의 REST API. 예측 가능한 크레딧, 기계가 읽는 출력, 명확한 오류. 무료로 시작.
Request
# quickstart.sh curl "https://api.example.com/v1/transcripts/VIDEO_ID" \ -H "Authorization: Bearer YOUR_API_KEY"
200 OK
{
"video_id": "dQw4w9WgXcQ",
"language": "en",
"duration": 213,
"segments": [
{ "text": "...", "start": 18.64, "duration": 3.24 }
]
}
필요한 모든 형식
이미 쓰는 형식을 요청하세요. 응답은 안정적이고 타임스탬프가 있어 이후 도구가 추측할 필요가 없습니다.
Transcripts
Single video, batch up to 50, playlists and channels. JSON, TXT, SRT, VTT, Markdown.
GET /v1/transcripts/{videoId}
Jobs & webhooks
Large requests become asynchronous jobs with per-item status, retries and webhooks.
POST /v1/jobs
AI endpoints
Grounded answers with timestamps, summaries and chapters. Small and focused at launch.
POST /v1/ask
실제 스크립트 워크로드를 위해 설계됨
연구와 분석
재생목록이나 채널 전체의 스크립트를 한 번의 작업으로 가져와 주제, 감정, 발화 시간을 분석하세요.
자막과 접근성
SRT, VTT 또는 일반 텍스트로 내보내 자막을 게시하고, 접근 가능한 아카이브를 만들거나 영상을 글로 바꾸세요.
자동화와 도구
스크립트를 MCP 서버, Claude Code, Codex에 연결해 에이전트가 필요할 때 아무 영상이나 읽게 하세요.
Pricing
Limits are configuration-driven and may change as the API stabilises.
Authentication
Authorization: Bearer YOUR_API_KEY
# or
X-API-Key: YOUR_API_KEY
Keys are hashed at rest, shown once, revocable, and scoped per account.
Errors you can handle
{
"error": {
"code": "TRANSCRIPT_NOT_AVAILABLE",
"message": "...",
"request_id": "req_123"
}
}
Every request carries an X-Request-ID for support and debugging.
OpenAPI
The canonical schema is published and importable into Postman and other tooling.
자주 묻는 질문
무료 YouTube 스크립트 API가 있나요?
네. 모든 계정에 1만 크레딧과 개발자 키가 무료로 제공되며 카드가 필요 없습니다. 영상당 1크레딧이라 무료로 개발하고 테스트할 수 있습니다.
API로 YouTube 스크립트를 어떻게 받나요?
Authorization 헤더에 키를 넣고 GET /v1/transcripts/{videoId}를 호출하세요. 스크립트, 언어, 길이, 타임스탬프 세그먼트가 JSON으로 돌아옵니다.
다른 언어 자막도 지원하나요?
네. GET /v1/transcripts/{videoId}/languages로 트랙을 나열하고 ?lang=로 원하는 것을 요청하세요. 자동 자막은 라벨이 붙습니다.
API는 어떤 출력 형식을 주나요?
JSON, TXT, SRT, VTT, Markdown입니다. 스크립트 요청에 ?format=를 쓰거나 JSON을 직접 변환하세요. 세그먼트는 텍스트와 시작·길이입니다.
Python 예제가 있나요?
네. requests나 httpx로 몇 줄이면 충분합니다. 배치와 재시도를 포함한 Python 빠른 시작은 블로그 가이드를 보세요.
재생목록이나 채널 전체를 받을 수 있나요?
네. POST /v1/transcripts로 최대 50개 영상 ID를 보내거나 재생목록·채널 작업을 시작하세요. 영상별 결과와 상태가 반환됩니다.
YouTube 스크립트용 MCP 서버가 있나요?
네. MCP 서버는 Claude Code, Codex 및 기타 MCP 클라이언트에 스크립트 도구를 제공해 별도 코드 없이 에이전트가 영상을 읽습니다.
비용은 얼마인가요?
얼리 액세스 동안 무료입니다. 계정당 1만 크레딧, 분당 60회 요청. 더 높은 한도의 유료 플랜이 곧 출시됩니다.
오늘부터 스크립트로 개발을 시작하세요
무료 개발자 키를 만들고 1분 안에 첫 요청을 보내며, 사용자가 검색·인용·내보내기 할 수 있는 스크립트를 제공하세요.