Quick start
Send a YouTube URL and your API key. You get back a structured summary. That's the whole flow.
Endpoint
POST https://summarizetube.com/api/summarize
Authentication
Pass your API key as a Bearer token, or include user_id in the body. Your API key is shown in your account after subscribing to Pro.
Request body
url (string, required) — a YouTube watch / shorts / embed link.api_key (string, required) — your secret API key from your account (Pro/Team). Can also be sent as a Bearer token in the Authorization header.
Example request
# Requires a Pro API key
curl -X POST https://summarizetube.com/api/summarize \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","user_id":"YOUR_API_KEY"}'
Example response
{
"tldr": "A short one-line summary of the video.",
"conclusions": [
"First key takeaway, traced to the real captions.",
"Second key takeaway, no invented facts."
],
"sections": [
{ "ts": "1:23", "point": "What happens at 1:23, clickable in the UI." }
],
"video": { "title": "...", "channel": "...", "url": "..." },
"source": "summarized from real captions"
}
Language examples
Python
import requests
r = requests.post(
"https://summarizetube.com/api/summarize",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
"user_id": "YOUR_API_KEY"},
)
data = r.json()
print(data["tldr"])
JavaScript / Node
const res = await fetch("https://summarizetube.com/api/summarize", {
method: "POST",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY",
},
body: JSON.stringify({
url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
user_id: "YOUR_API_KEY",
}),
});
const data = await res.json();
console.log(data.tldr);
Rate limits & plans
- Free — API not included.
- Pro Monthly ($9.9/mo) — 10,000 credits per month, includes API access. Each API call counts against your monthly quota.
- Pro Annual ($99/yr) — 2 months free vs monthly, includes API access.
- Credits pack — one-time credits for extra volume; a captioned video costs 5 credits, a no-caption video 10.
Notes
- Summaries are generated from the video's public captions. Videos without captions are transcribed when a speech-to-text provider is enabled on the server; otherwise they are not yet supported.
- Responses are AI-generated and grounded in the source captions; we do not invent facts.
- Your API key is available in your account after subscribing to Pro.