Quickstart

Option A: the CLI

brew install ziqorg/tap/transcript
transcript login
transcript get "https://youtu.be/dQw4w9WgXcQ"

transcript login opens your browser once to link the CLI to your account; every transcript get after that uses the stored key. See CLI: Install for other installation options.

Option B: the REST API

Get your API key from Settings (or run transcript login, which mints the same key), then:

curl https://api.transcript.land/v1/transcript \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtu.be/dQw4w9WgXcQ", "format": "txt"}'

Handling an async (ASR) job

If the video has no captions, the response is 202 with a job_id instead of the transcript itself:

{ "job_id": "a1b2c3...", "status": "queued" }

Poll GET /v1/jobs/{job_id} every couple of seconds until status is done (or error):

curl https://api.transcript.land/v1/jobs/a1b2c3... \
  -H "Authorization: Bearer sk_live_..."

The CLI's transcript get does this polling for you automatically.

Next steps