Skip to content
TranscriptDock
Sign inStart free

Site menu

TranscriptDock
Start freeSign in
Documentation

Build with TranscriptDock from your app or your agent

Transcripts from YouTube, TikTok and your own audio or video, through one REST API or straight from an AI agent over MCP.

QuickstartAPI reference

Documentation

Tools
IntroductionHow it works, guides, and what you can transcribe.
QuickstartSubmit a link, wait for the job, export the transcript. Three requests.
AuthenticationAPI keys, scopes, Idempotency-Key and X-Request-Id.
JobsCreate, wait for, list, cancel and retry jobs.
TranscriptsThe transcript object and txt, srt, vtt, json exports.
BatchesUp to 50 videos in one request.
UploadsTranscribe your own audio and video files.
WebhooksGet called when a job or batch finishes; verify the signature.
ErrorsEvery error code, what it means and what to do.
Rate limitsSubmits, jobs in progress and reads per plan; the 429 response.
Pricing and credits1 credit per caption transcript, 2 per minute of AI transcription. Plans and extra credits.
SourcesYouTube, TikTok, your files and direct links: accepted URLs and modes.
MCPFind and transcribe videos from Claude, Cursor, Windsurf or your own agent.
OpenAPI SpecificationThe OpenAPI 3.1 spec for codegen and typed clients.
Claude CodeOne command adds TranscriptDock to Claude Code.
Claude DesktopAdd TranscriptDock as an MCP server in Claude Desktop's configuration file.
CursorAdd TranscriptDock as an MCP server in Cursor.
WindsurfAdd TranscriptDock to Windsurf so Cascade can find and transcribe videos.
OpenClawConnect TranscriptDock to OpenClaw autonomous agents.
19 results

How it works#

  1. Submit a link with POST /v1/jobs. You get a job id back at once.
  2. Wait with GET /v1/jobs/{id}?wait=25: captions take seconds, AI transcription about a quarter of the video length.
  3. Export the transcript as txt, srt, vtt or json. Same link again is free.
1. Submit
curl -X POST https://api.transcriptdock.com/v1/jobs \
  -H "Authorization: Bearer td_live_YOUR_KEY" \
  -H "Idempotency-Key: my-first-job" \
  -H "Content-Type: application/json" \
  -d '{ "source": { "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }, "mode": "auto" }'
Get an API keyFull quickstart

Guides#

What you can transcribe#

SourceCaptionsAI transcription
YouTube video, Short or live replay1 credit2 credits per minute
TikTok video1 credit2 credits per minute
Your own file (mp3, mp4, wav, m4a, webm…)Not available2 credits per minute
Direct https link to a media fileNot available2 credits per minute

Captions are the video's existing subtitles, delivered in seconds. AI transcription listens to the audio and returns word timings; it is included with paid plans. Every account starts with 50 free credits. Limits: 2 hours and 250 MB per media.