API Documentation
YouTube Transcript API
Powerful API for extracting YouTube transcripts and captions programmatically
Free Forever
No Rate Limits
Coming Soon
API Overview
Simple REST API for extracting YouTube transcripts
Base URL
https://youtubetranscripts.app/api
Response Format
JSON
POST /api/transcript
Extract transcript from a YouTube video
Request Body
{
"videoId": "dQw4w9WgXcQ",
"language": "en"
}
Parameters
videoId
YouTube video ID or full URL (required)language
Language code (optional, default: "en")Response
{
"success": true,
"videoId": "dQw4w9WgXcQ",
"title": "Video Title",
"transcript": [
{
"text": "Hello world",
"start": 0.5,
"duration": 2.3
}
],
"language": "en",
"method": "youtube-transcript"
}
Example Usage
// JavaScript/Node.js
const response = await fetch('https://youtubetranscripts.app/api/transcript', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
videoId: 'dQw4w9WgXcQ',
language: 'en'
})
});
const data = await response.json();
console.log(data.transcript);
Error Handling
Common error responses and how to handle them
Error Response Format
{
"error": "Error message description",
"status": 400
}
Common Error Codes
400
Bad Request - Invalid parameters404
Not Found - Video not found or no transcript available500
Internal Server Error - Something went wrongUsage & Limits
Information about API usage and limitations
Rate Limits
No rate limits - use as much as you need!
Authentication
No API key or authentication required
CORS
CORS enabled for all origins
Uptime
99.9% uptime guarantee
Coming Soon
We're working hard to bring you a comprehensive API for YouTube transcript extraction
Fast Extraction
Lightning-fast transcript extraction
RESTful API
Simple and intuitive REST endpoints
Planned Features:
- Bulk transcript extraction
- Multiple format support (TXT, SRT, VTT, JSON)
- Playlist transcript extraction
- Multi-language support
- Webhook notifications
- Rate limiting and authentication
Want to be notified when the API launches?