REST API

Powerful RESTful API for integrating YouTube transcript generation and AI summarization into any application or platform.

Base URL

https://api.tubescript.ai/v1/

All API requests should be made to this base URL with the appropriate endpoint path.

Authentication

All API requests require authentication using an API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Get Your API Key

API Endpoints

POST /transcript/generate

Generate transcript from YouTube URL with optional timestamp inclusion.

Request Body

                                
{
  "youtube_url": "https://www.youtube.com/watch?v=VIDEO_ID",
  "include_timestamps": true,
  "format": "json"
}
                                
                            

Response 200

                                
{
  "success": true,
  "video_id": "VIDEO_ID",
  "title": "Video Title",
  "transcript": [
    {
      "timestamp": "00:00:05.000",
      "text": "Transcript text here"
    }
  ],
  "processing_time": "2.34s",
  "total_segments": 150
}
                                
                            

POST /summary/generate

Generate AI-powered summary from transcript data.

Request Body

                                
{
  "transcript": [
    {
      "timestamp": "00:00:05.000",
      "text": "Transcript text here"
    }
  ],
  "summary_type": "detailed",
  "format": "structured"
}
                                
                            

Response 200

                                
{
  "success": true,
  "summary": {
    "overview": "Main content overview...",
    "key_points": ["Point 1", "Point 2"],
    "insights": ["Insight 1", "Insight 2"],
    "conclusion": "Final thoughts..."
  },
  "word_count": 1250,
  "processing_time": "3.45s"
}
                                
                            

POST /process/complete

Generate both transcript and summary in a single API call.

Request Body

                                
{
  "youtube_url": "https://www.youtube.com/watch?v=VIDEO_ID",
  "include_transcript": true,
  "include_summary": true,
  "summary_type": "detailed"
}
                                
                            

Response 200

                                
{
  "success": true,
  "video_id": "VIDEO_ID",
  "title": "Video Title",
  "transcript": [...],
  "summary": "AI generated summary...",
  "processing_time": "5.67s"
}
                                
                            

Rate Limits

Basic

100

requests per hour

10 concurrent requests

30-minute video limit

Pro

1,000

requests per hour

50 concurrent requests

2-hour video limit

Enterprise

∞

unlimited requests

200 concurrent requests

No video limit

Error Codes

Status Code	Error Code	Description
400	MISSING_URL	YouTube URL is required
401	INVALID_API_KEY	Invalid or missing API key
429	RATE_LIMIT_EXCEEDED	Too many requests
500	TRANSCRIPT_FAILED	Could not generate transcript
500	SUMMARY_FAILED	AI summary generation failed

Ready to Integrate?

Start building with our REST API today. Simple, powerful, and reliable.

Full Documentation Get API Key