Transcript Dock

TranscriptDock API

Single API for transcripts from YouTube, TikTok, Instagram, and your own media. This document is the single source of truth. JSON Schemas under specs/schemas/…

Media & content#video

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Single API for transcripts from YouTube, TikTok, Instagram, and your own media.
This document is the single source of truth. JSON Schemas under specs/schemas/
and TypeScript types in apps/web/src/lib/api/types.ts are generated from it by
pnpm contract:build. Runtime request validation uses those generated schemas,
so prose, examples, and enforcement always agree.

Endpoints 42

jobs

  • GETSupported platforms, modes, and limits/v1/capabilitiesWithout a credential this returns the public matrix, cached at the edge. With a key, a Supabase access token or a session cookie it returns the matrix for…
  • GETWorkspace job history (cursor pagination)/v1/jobs
  • POSTSubmit one source/v1/jobs
  • POSTQueue bounded YouTube timed text language discovery/v1/language-discoveries
  • GETRead a workspace scoped language discovery/v1/language-discoveries/:id
  • POSTQueue a video listing discovery/v1/video-discoveries
  • GETRead a workspace scoped video discovery/v1/video-discoveries/:id
  • GETJob status, stage, error, result reference, billing/v1/jobs/:id
  • POSTCancel before AssemblyAI submission starts/v1/jobs/:id/cancel
  • POSTNew job from a retryable terminal failure/v1/jobs/:id/retry
  • GETProcess liveness only (no extraction detail)/health

batches

  • POSTSubmit 1 to plan limit jobs atomically/v1/batches
  • GETBatch counters and child job ids/v1/batches/:id

transcripts

  • GETNormalized stored result/v1/transcripts/:id
  • DELETEHide immediately and schedule purge/v1/transcripts/:id
  • GETExport a stored result without paying again/v1/transcripts/:id/export?format=txt

uploads

  • POSTReserve an upload slot and get a signed URL/v1/uploads
  • POSTVerify a finished upload and mark it ready/v1/uploads/:id/complete

account

  • GETCaption allowance, wallet balance, and reservations/v1/usage
  • GETList API keys (hashes never returned)/app/keys
  • POSTCreate a scoped API key (owner session only)/app/keys
  • DELETERevoke an API key/app/keys/:id
  • POSTStart a Stripe Checkout (subscription or credits)/app/billing/checkoutReturns the hosted Stripe Checkout url. Stripe returns the browser to the page the purchase started from with ?checkout=done or ?checkout=cancelled:…
  • GETPrice a credit purchase without starting a checkout/app/billing/quote?units=1000
  • POSTOpen the Stripe Customer Portal/app/billing/portalPlan and interval changes, cancel at period end, payment method and invoice history. The body is optional; flow opens one step directly.
  • POSTRecord why a subscriber is cancelling/app/billing/cancel-feedbackThe web and mobile apps ask a short survey before they open the Stripe Customer Portal (flow cancel) or the App Store or Google Play subscription settings.…
  • GETRead the signed in user's onboarding state/app/onboardingpending until the user answers or skips the welcome questions (shown once, on the web or in the mobile app, whichever comes first).
  • POSTSave the welcome answers, or skip them/app/onboardingcomplete saves the answers (every question is optional; a later complete replaces earlier answers). skip records that the user chose not to answer and never…
  • GETRead profile and workspace preferences/app/profile
  • PATCHUpdate display name or retention window/app/profile
  • DELETEDelete the account (type DELETE to confirm)/app/account
  • GETRecent customer webhook delivery attempts (redacted)/app/webhooks/deliveries
  • POSTRedeliver an exhausted customer webhook event/app/webhooks/:event/redeliver
  • GETOperator status (workspace owner only)/app/ops/status
  • GETOAuth and email link callback (PKCE code exchange)/auth/callback
  • POSTSign out and clear the session cookie/auth/signout

webhooks

  • GETList workspace endpoints (secrets never returned)/v1/webhook-endpoints
  • POSTRegister an HTTPS endpoint (owner session in MVP)/v1/webhook-endpoints
  • DELETEDisable an endpoint/v1/webhook-endpoints/:id

callbacks

  • POSTAssemblyAI transcript completion callback/callbacks/assemblyai?attempt=string
  • POSTRevenueCat webhook for App Store and Google Play subscriptions/callbacks/revenuecatThe Authorization header must equal REVENUECAT_WEBHOOK_AUTH (compared in constant time). app_user_id is the Supabase user id the mobile app logs in with; the…
  • POSTStripe event webhook (signature verified, replay safe)/callbacks/stripeStripe-Signature is verified over the raw body with STRIPE_WEBHOOK_SECRET and a 300 second tolerance. Every event is deduped by its event id; events left open…

API details

Base URL
https://www.transcriptdock.com
http://localhost:3000
Authentication
A bearer token in the Authorization header
An API key in the sb-access-token cookie
Operations
42 operations on 36 pathsPOST 19GET 18DELETE 4PATCH 1
Main resources
account 18jobs 11callbacks 3transcripts 3webhooks 3batches 2uploads 2
Response formats
application/json text/plain text/vtt
Description format
OpenAPI 3.1.0, API version 1.0.0

How to test the TranscriptDock API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the TranscriptDock API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Supported platforms, modes, and limits” (GET /v1/capabilities), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the TranscriptDock API?

Single API for transcripts from YouTube, TikTok, Instagram, and your own media. This document is the single source of truth. JSON Schemas under specs/schemas/… It is listed under Media & content and has 42 endpoints.

Who publishes the TranscriptDock API?

It is listed from Transcript Dock's public API description (an OpenAPI document), not published by Transcript Dock on Swastik Codes. Anyone who controls transcriptdock.com can claim the profile by adding a DNS TXT record.

What is the base URL of the TranscriptDock API?

Its description lists 2 base URLs: https://www.transcriptdock.com, http://localhost:3000. The first is the usual one; the others are typically sandbox or regional servers.

How do I authenticate with the TranscriptDock API?

It accepts 2 methods: A bearer token in the Authorization header; an API key in the sb-access-token cookie.

How many endpoints does the TranscriptDock API have?

42 operations on 36 paths (19 POST, 18 GET, 4 DELETE, 1 PATCH). The largest groups are account, jobs, callbacks, transcripts.

Is forking the TranscriptDock API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.