QuickTube Developer Documentation

REST API and Model Context Protocol (MCP) server reference. No login required to read.

REST API — Getting Started

The QuickTube REST API allows you to programmatically access YouTube transcript fetching and AI analysis features.

Base URL

https://quicktube.ai

Authentication

Include your API key in the request headers:

X-API-Key: qt_your_api_key_here

Don't have an API key? Generate one in Settings → API Keys (sign in required).

Rate Limiting

API requests are subject to rate limiting to ensure fair usage. Contact us if you need higher limits.

REST API Endpoints

Transcript

POST

/api/transcript

Fetch Transcript

Fetch the transcript for a YouTube video

Request Body:

{
  "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "languages": ["en"]
}

AI Analysis

POST

/api/best-sections

Find Best Sections

AI analyzes the transcript to find the most interesting moments

Request Body:

{
  "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "num_sections": 10
}

POST

/api/summarize

Generate Summary

Generate an AI summary of the video content

Request Body:

{
  "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}

POST

/api/characters

Detect Characters

Identify people speaking or being interviewed in the video

Request Body:

{
  "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}

POST

/api/chat

Chat with Video

Ask questions about the video content

Request Body:

{
  "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "messages": [
    {"role": "user", "content": "What is the main topic?"}
  ],
  "transcript_text": "Optional full transcript...",
  "character": "John Doe"
}

POST

/api/quiz

Generate Quiz

Generate a quiz from the video content (3 credits)

Request Body:

{
  "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "num_questions": 5
}

Media Generation

POST

/api/speech

Generate Speech

Convert text to speech using OpenAI TTS

Request Body:

{
  "text": "Text to convert to speech",
  "voice": "nova"
}

POST

/api/download-video

Download Video

Download full video or create highlights compilation

Request Body:

{
  "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "video_type": "highlights",
  "sections": [
    {"start": 10.0, "end": 30.0, "title": "...", "reason": "..."}
  ]
}

POST

/api/get-download-url

Get Download URL

Get a direct download URL for a video (10 credits for API key)

Request Body:

{
  "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "video_type": "full"
}

YouTube Data

GET

/api/video/metadata/{video_id}

Get Video Metadata

Fetch comprehensive metadata for a YouTube video

Request Body:

GET /api/video/metadata/dQw4w9WgXcQ

GET

/api/video/search

Search Videos

Search YouTube videos by query

Request Body:

GET /api/video/search?q=machine+learning&max_results=10&order=relevance

GET

/api/video/comments/{video_id}

Get Video Comments

Fetch comments for a YouTube video

Request Body:

GET /api/video/comments/dQw4w9WgXcQ?max_results=100&order=relevance

GET

/api/video/related/{video_id}

Get Related Videos

Fetch videos related to a specific video

Request Body:

GET /api/video/related/dQw4w9WgXcQ?max_results=10

GET

/api/channel/{channel_id}

Get Channel Details

Fetch details about a YouTube channel

Request Body:

GET /api/channel/UC_x5XG1OV2P6uZZ5FSM9Ttw

GET

/api/videos/popular

Get Popular Videos

Fetch trending/popular videos by region

Request Body:

GET /api/videos/popular?region_code=US&max_results=10

Batch Processing

POST

/api/batch/process

Batch Process Videos

Process multiple videos at once (up to 10). Credits: 5 per summary + 5 per sections per video.

Request Body:

{
  "video_urls": [
    "https://www.youtube.com/watch?v=video1",
    "https://www.youtube.com/watch?v=video2"
  ],
  "include_transcript": true,
  "include_summary": true,
  "include_sections": false,
  "num_sections": 5
}

MCP Server

The quicktube-mcp package exposes QuickTube's capabilities to AI agents via the Model Context Protocol. Plug it into Claude Code, Claude Desktop, or any MCP-compatible client and your agent can fetch transcripts, summarize videos, run quizzes, fact-check claims, and more.

Setup

Three steps to wire QuickTube into your AI agent.

1. Get an API key

Create an API key at Settings → API Keys with the scopes you need (read, ai, sessions:read, sessions:write, billing:read).

2. Install the MCP server

pip install quicktube-mcp

3. Configure your client

Add this to your Claude Code (~/.claude/settings.json) or Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "quicktube": {
      "command": "quicktube-mcp",
      "env": {
        "QUICKTUBE_API_KEY": "qt_your_api_key_here"
      }
    }
  }
}

Optional env vars: QUICKTUBE_BASE_URL (default https://quicktube.ai), QUICKTUBE_TIMEOUT (default 60s).

Available Tools

Tools your AI agent can call. Credit costs match the REST API.

Tool	Description	Credits
`get_transcript`	Fetch YouTube video transcript	1
`summarize_video`	Generate AI summary	5
`get_best_sections`	Identify key moments/highlights	5
`detect_characters`	Detect speakers/people	3
`chat_with_video`	Ask questions about video content	1/msg
`generate_quiz`	Create comprehension quiz	5
`fact_check_video`	Fact-check claims (web-grounded)	varies
`get_bias_score`	Analyze political/ideological bias	varies
`neutralize_bias`	Rewrite biased language neutrally	varies
`get_video_metadata`	Get video title, stats, duration	0
`search_videos`	Search YouTube	0
`get_video_comments`	Get video comments	0
`get_related_videos`	Find related videos	0
`list_sessions`	List saved analysis sessions	0
`get_session`	Get a saved session	0
`save_session`	Save analysis for later	0
`delete_session`	Delete a saved session	0
`get_credit_balance`	Check credit balance	0
`batch_process_videos`	Analyze multiple videos at once	varies

Example Agent Interactions

"Get me the transcript of this YouTube video and summarize it."
"What are the key moments in this podcast episode?"
"Fact-check the claims made in this news video."
"Generate a quiz from this educational video."
"Is this video politically biased? Analyze it."
"Process these 5 videos and give me summaries of each."

Need Help?

For support or questions about the REST API or MCP server, please contact us. Source for the MCP package lives in packages/quicktube-mcp.