tiktok-transcript-apilisted
Install: claude install-skill TranscriptDock/tiktok-transcript-api
# TikTok transcripts with Transcript Dock
Every transcript is an asynchronous job: submit, wait, then read or export. Full reference: https://www.transcriptdock.com/docs/api-reference
## When to use
- A TikTok link (`tiktok.com/@user/video/...` or a `vm.tiktok.com/...` share link) and a request for its transcript, captions, subtitles, quotes or a summary.
- "Transcribe the latest videos from @someone."
Not for private videos (they fail), TikTok search (not available), translation (not offered) or speaker labels (not offered).
## Setup
- Base URL `https://www.transcriptdock.com`. Always `www`: the apex redirects and drops the `Authorization` header.
- Header `Authorization: Bearer $TRANSCRIPTDOCK_API_KEY` from the environment. Never print the key, put it in a URL or ask for it in chat. If it is missing, tell the user to create one at https://www.transcriptdock.com/dashboard.
- POST bodies are JSON with `Content-Type: application/json`.
## Step 1. Check the plan (free)
`GET /v1/capabilities` with the key shows `tiktok.captions_only`, `tiktok.auto` and `tiktok.transcribe` for this plan. `GET /v1/usage` shows `plan` and `credits_remaining`. The free plan has captions only.
## Step 2. Submit captions first
```bash
KEY_ID="$(uuidgen 2>/dev/null || date +%s%N)" # generate ONCE per intended job and remember it
curl -sS -X POST https://www.transcriptdock.com/v1/jobs \
-H "Authorization: Bearer $TRANSCRIPTDOCK_API_KEY" \
-H "Idempotency-Key: $KEY_ID" \
-H "Content-Typ