Submit video transcription jobs and retrieve timed transcripts with your own Transcript Dock API key.
Community node with n8n directory verification still pending. The automated checks use local fixtures; they do not establish successful production transcription or complete editor validation.
Create a key at https://www.transcriptdock.com/dashboard/developer and save it in an n8n Transcript Dock API credential. The credential test only lists one job. It does not submit work or spend transcription credits. Keep keys out of workflow JSON, screenshots and source control.
- Submit Job queues a URL and returns the actual job status and ID. It does not wait for a transcript.
- Get Job checks status. Only
succeededhas a usableresult_id. Handlefailedandcancelledseparately. - Get Transcript retrieves text and timed segments using a successful job's
result_id. - Get Capabilities checks the platforms and modes available to your account.
Captions Only is the default and costs 1 credit for YouTube or TikTok captions. Auto allows AI fallback. Transcribe requests AI directly. AI transcription requires a paid Transcript Dock plan. Check the pricing page for current transcription and source charges. Instagram Reels use AI transcription on paid plans in beta. The maximum credits field caps the request's spend; its default of 1 deliberately cannot pay for one AI minute. Increase it explicitly before choosing AI.
Set an idempotency key of 8 to 128 printable ASCII characters for each logical submission. Keep that key and the input unchanged on retries. A key derived only from a video URL will reuse the existing submission even on a later workflow run. A key derived from an execution ID is new on a new execution. For recovery across executions, use a persistent business event ID instead. Do not enable automatic retries with a changing key.
Start with a Manual Trigger and a video URL. Add Submit Job in Captions Only mode. Set a stable idempotency key such as video-event-12345678. Save the returned job ID. Use a Wait node followed by Get Job and an IF or Switch node:
succeeded: fetch Get Transcript withresult_id.failedorcancelled: stop and inspect the error. Do not treat it as an empty transcript.queued,processingorawaiting_provider: wait and poll again, with a bounded number of attempts and a deadline.
Requests use the fixed production origin and refuse redirects. API validation and HTTP errors propagate through n8n. This node does not automatically retry a failed job or upload files. You can use n8n's HTTP Request node for the rest of the public API.
Use Node 24 and npm. From this directory:
npm ci --ignore-scripts
npm run build
npm run lint
npm test
npm pack --dry-runStart a local n8n instance with npm run dev for editor testing. Follow the official n8n development instructions. Use a real account key only in n8n's credential store. Any live test that submits a job needs a separate credit budget authorization.
Publish only from the dedicated public TranscriptDock source repository using GitHub Actions with npm provenance. Configure npm's trusted publisher for that repository and workflow before running the release. Do not copy personal account credentials into this package. Submit to the n8n Creator Portal only after the package is published and editor testing is complete.
Support: transcriptdock@volods.com