Programmatic transcription API

One API for every platform

The Dokitscript API is the same engine that powers the web app, exposed as a simple HTTP interface. Send a public video URL or upload an audio/video file, poll for the result, and pull back the full transcript with timestamps and segments, ready to drop into your pipeline, CMS or data warehouse.

Bearer API keys

Every request is authenticated with a secret key passed in the Authorization header. Keys are tied to your account; usage is billed to your API token balance (pay as you go) or your Business plan (fair-use up to 2,000 min/month).

Where to generate a key: sign in, open your account, and use the API panel. Key creation is open on Starter, Pro and Business, and to any account holding API tokens. You can create up to 10 active keys and revoke any of them at any time. The secret is shown only once at creation: store it somewhere safe; if you lose it, revoke the key and create a new one.

Authorization: Bearer dks_live_4a7c92e1b8d3f0a6c5e2b9d7f1a3c8e0b4d6f9a2c7e1b5d3

Endpoints

Base URL: https://dokitscript.com. All endpoints return JSON. Transcription is asynchronous: create a job, poll its status, then fetch the finished transcript.

curl -X POST https://dokitscript.com/api/v1/transcribe \
  -H "Authorization: Bearer dks_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://www.tiktok.com/@user/video/1234567890", "language": "auto", "format": "timestamps" }'

{
  "jobId": "job_a1b2c3d4e5f6",
  "status": "pending",
  "links": {
    "self": "/api/v1/jobs/job_a1b2c3d4e5f6"
  }
}

curl -X POST https://dokitscript.com/api/v1/transcribe-file \
  -H "Authorization: Bearer dks_live_YOUR_KEY" \
  -F "[email protected]" \
  -F "language=en"

{
  "jobId": "job_a1b2c3d4e5f6",
  "status": "pending",
  "links": {
    "self": "/api/v1/jobs/job_a1b2c3d4e5f6"
  }
}

curl https://dokitscript.com/api/v1/jobs/job_a1b2c3d4e5f6 \
  -H "Authorization: Bearer dks_live_YOUR_KEY"

{
  "jobId": "job_a1b2c3d4e5f6",
  "status": "done",
  "progress": 100,
  "transcriptId": "6630f1a2b3c4d5e6f7a8b9c0",
  "links": {
    "transcript": "/api/v1/transcript/6630f1a2b3c4d5e6f7a8b9c0"
  }
}

curl "https://dokitscript.com/api/v1/transcript/6630f1a2b3c4d5e6f7a8b9c0?format=srt" \
  -H "Authorization: Bearer dks_live_YOUR_KEY"

{
  "id": "6630f1a2b3c4d5e6f7a8b9c0",
  "platform": "tiktok",
  "url": "https://www.tiktok.com/@user/video/1234567890",
  "language": "en",
  "duration": 47,
  "wordCount": 128,
  "fullText": "Here is the full transcript text...",
  "segments": [
    { "start": 0, "end": 3.2, "text": "Here is the..." }
  ],
  "speakers": [],
  "speakerText": null,
  "createdAt": "2026-06-13T10:24:00.000Z",
  "formatted": "1\n00:00:00,000 --> 00:00:03,200\nHere is the..."
}

Give your AI assistant the same tools

Beyond the REST endpoints above, Dokitscript runs a remote MCP server (Model Context Protocol). Point Claude Code, Claude Desktop, Cursor or VS Code at it and your assistant can transcribe a link and read your history on its own, with no glue code to write. It authenticates with the same Bearer key as the REST API, so nothing new to set up on your side.

https://dokitscript.com/mcp   // transport: Streamable HTTP (JSON-RPC over POST)
Authorization: Bearer <your API key>

Set up the MCP server →

API tokens: pay as you go

No subscription required. Buy a pack of API tokens and use the API until they run out: tokens never expire. 1 token = 15 minutes of transcription (any started 15-minute block counts as one token), so a 40-minute file uses 3 tokens. Tokens are what fund API and MCP calls on Starter and Pro: those plans open the door, but their subscription minutes stay on the web app. Already on Business? The API is included, fair-use up to 2,000 minutes a month, no tokens needed.

Rate limits and usage

The API reuses the same pipeline as the web app. Usage is billed either to your API tokens (1 token per started 15-minute block) or, on Business, counts as fair-use up to 2,000 minutes a month, just like the dashboard.