Transcrip API

Read your transcripts from external apps — scripts, Zapier, Obsidian, your own tools. Read-only, scoped to the folders you choose to share. Available on the Plus plan.

1. Get an API key

  1. In the app, open Account → API access and accept the sharing terms.
  2. Share one or more folders. Only shared folders are ever readable through the API.
  3. Create a key. The secret (tsk_…) is shown once — store it safely. Revoke it anytime.

Privacy note: sharing a folder uploads a readable copy of its transcripts for API delivery. Everything else stays in your zero-knowledge encrypted vault. Disabling API access deletes all keys and readable copies.

2. Authenticate

Send the key as a bearer token. Base URL: https://api.transcrip.app/ext/v1

curl https://api.transcrip.app/ext/v1/me \
  -H "Authorization: Bearer tsk_YOUR_KEY"

3. Endpoints

GET/me

Key info: name, prefix, and the folders this key can read.

GET/folders

Shared folders visible to this key: id, name.

GET/transcripts

List transcripts, newest first. Query params: folderId (filter to one folder), limit (1–100, default 25), cursor (from nextCursor in the previous page). Returns metadata only — id, title, folderId, durationSec, createdAtMs, updatedAtMs.

GET/transcripts/{id}

One transcript including its full text content.

Example: fetch everything

# list shared folders
curl https://api.transcrip.app/ext/v1/folders -H "Authorization: Bearer tsk_YOUR_KEY"

# page through transcripts of one folder
curl "https://api.transcrip.app/ext/v1/transcripts?folderId=FOLDER_ID&limit=50" \
  -H "Authorization: Bearer tsk_YOUR_KEY"

# read one transcript's text
curl https://api.transcrip.app/ext/v1/transcripts/TRANSCRIPT_ID \
  -H "Authorization: Bearer tsk_YOUR_KEY"

Limits & errors