TubeScribed API · Live
YouTube transcripts and business assets in one call.
TubeScribed is a REST API and Claude connector that turns any captioned YouTube video into a clean transcript and business assets such as blog posts, SOPs and email sequences. Get a key in your TubeScribed account. Included in every plan: 10, 200 or 1,000 calls per month.
YouTube captions + Claude AI cleanup · JSON responses · 4 tools · 10 requests/min
How it works
Three steps to your first transcript
- 1
Get a key
Create an API key in your TubeScribed account under Settings → API Keys.
- 2
Send a YouTube URL
POST the tool name and input to one endpoint with your key in the Authorization header.
- 3
Get JSON back
Receive the transcript or finished asset as clean JSON, ready for your app or workflow.
Tools
Four tools, one endpoint
POST to iblyytktdumianqxfyis.supabase.co/functions/v1/api-v1 with {"tool": "...", "input": {...}}.
transcribe_video
Pulls the video's captions and returns the transcript. On the API it's cleaned by Claude AI; in Claude it returns raw captions by default (fast), or a cleaned version when you ask.
- Input
- youtube_url
- Returns
- Title, transcript, word count, duration
generate_asset
Turns a video or transcript into a blog post, SOP, email sequence, social posts, show notes, FAQ, training guide and more.
- Input
- asset_type + youtube_url or transcript, optional brand_voice
- Returns
- The finished asset as text, plus word count
list_asset_types
Returns the full list of asset types with a short description of each.
- Input
- none
- Returns
- Every output type you can generate
get_usage
Check how many calls you have left before running a batch.
- Input
- none
- Returns
- Calls used this month, your limit, plan, reset date
Examples
Copy, paste, run
curl -X POST https://iblyytktdumianqxfyis.supabase.co/functions/v1/api-v1 \
-H "Authorization: Bearer ts_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"tool": "transcribe_video",
"input": { "youtube_url": "https://www.youtube.com/watch?v=VIDEO_ID" }
}'curl -X POST https://iblyytktdumianqxfyis.supabase.co/functions/v1/api-v1 \
-H "Authorization: Bearer ts_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"tool": "generate_asset",
"input": {
"asset_type": "sop",
"youtube_url": "https://www.youtube.com/watch?v=VIDEO_ID",
"brand_voice": "Clear, direct, no jargon"
}
}'const res = await fetch("https://iblyytktdumianqxfyis.supabase.co/functions/v1/api-v1", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.TUBESCRIBED_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
tool: "transcribe_video",
input: { youtube_url: "https://www.youtube.com/watch?v=VIDEO_ID" },
}),
});
const data = await res.json();
// { title, transcript, word_count, duration_seconds }Need the list of asset types? Call list_asset_types. Check your remaining calls with get_usage.
Limits
Included in every plan
Only transcribe_video and generate_asset count. Failed calls are free. Rate limit: 10 requests per minute per key.
| Plan | Calls per month |
|---|---|
| Free Run | 10 |
| Pro | 200 |
| Agency | 1,000 |
| Status | Meaning |
|---|---|
| 400 | Bad input: missing or invalid fields |
| 401 | Missing or invalid API key |
| 422 | No captions available for this video |
| 429 | Monthly limit or rate limit (10/min) reached |
| 500 | Generation failed. Retry once. |
Use cases
What people build with it
Automations
Call TubeScribed from n8n, Make or Zapier with a simple HTTP request. New video published → transcript and blog draft created automatically.
AI agents
Give your agents the ability to read any captioned YouTube video. Pass a URL, get clean text back as JSON.
Knowledge bases and RAG
Turn channels and playlists into clean, chunk-ready text for vector databases, custom GPTs and Claude Projects.
Content pipelines
Generate blog posts, SOPs and email sequences from videos and push them straight into your CMS as drafts.
Internal tools
Add YouTube transcription to your own dashboards and workflows without building or maintaining a caption pipeline.
Claude, no code
Prefer chatting to coding? Connect TubeScribed to Claude and use the same four tools in plain English.
FAQ
Developer questions
Sign in to TubeScribed at app.tubescribed.com and open Settings → API Keys. Create a key, copy it (it's shown once), and send it as a Bearer token. You can revoke keys there at any time.
Start with 10 free calls
Create a free account, generate a key, and make your first request in under five minutes.