ActaScribe AI
Start trial
Developers / API

Everything ActaScribe can do, you can do too.

Build transcription, structured summaries, TalkBase RAG, and live Stage Mode sessions into your own products. Included on every paid tier — no separate API plan to negotiate.

Get an API keyRead the docs
Quick start

POST a URL. Get a structured transcript back.

One endpoint. Audio, YouTube, or a Stage Mode session ID. Same response shape every time.

TypeScript SDK
import { ActaScribe } from "@actascribe/sdk";

const client = new ActaScribe({
  apiKey: process.env.ACTASCRIBE_API_KEY,
});

const transcript = await client.transcripts.create({
  source: { type: "youtube", url: "https://youtube.com/watch?v=..." },
  template: "lecture",
  retain: "30d",
});

console.log(transcript.summary);
console.log(transcript.actionItems);
cURL
curl -X POST https://api.actascribe.ai/v1/transcripts \
  -H "Authorization: Bearer $ACTASCRIBE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": {
      "type": "youtube",
      "url": "https://youtube.com/watch?v=dQw4w9WgXcQ"
    },
    "template": "lecture",
    "retain": "30d"
  }'
What's in the API

The whole product, as endpoints.

Every surface that exists in the ActaScribe app is also a REST endpoint. No private APIs.

Transcripts
POST /v1/transcripts

Create a transcript from audio, a YouTube URL, or a Stage Mode session. GET / DELETE supported for full CRUD.

Templates
POST /v1/templates

Define a custom 8-section template, override system templates, or list the ones your workspace already has.

TalkBase corpora
POST /v1/talkbase/corpora

Create a TalkBase corpus. Add sources, query the corpus, manage embeddings, set retention.

Stage Mode sessions
POST /v1/stage/sessions

Spin up a Stage Mode session programmatically. Get the public URL, the WebSocket handle, and a CSV of audience Q&A.

Webhooks
POST /v1/webhooks

Subscribe to events: transcript.completed, corpus.updated, stage.session.ended. HMAC-signed deliveries.

SDKs

Typed clients for the languages you ship in.

First-class TypeScript and Python clients. More on the way.

npm
@actascribe/sdk
$ npm install @actascribe/sdk
PyPI
actascribe
$ pip install actascribe

Both SDKs publish around general availability — installation copy shown here is the future-state target. The REST API is live today.

Webhooks

Predictable, signed, retryable.

What grown-up webhook infrastructure should look like in 2026.

HMAC-signed

Every delivery is signed with your workspace secret. Verify the X-ActaScribe-Signature header before processing.

RFC 7807 errors

Standard problem+json error envelopes for every failure. Type, title, detail, instance — same shape across every endpoint.

Idempotency keys

Pass an Idempotency-Key header on every POST. Retries are safe; duplicates return the original response.

Rate limits

Quotas you can see in the headers.

100 requests/min for standard endpoints. 10 requests/min for heavy endpoints (transcript creation, Stage Mode session spin-up). Every response includes X-RateLimit-Remaining and X-RateLimit-Reset so you can pace your client without guessing.

Standard endpoints100 req/min
Heavy endpoints10 req/min
X-RateLimit-Remainingheader
X-RateLimit-Resetheader

ActaScribe,
as an API.

Included on every paid tier. No separate API plan to negotiate.

Get an API keyRead the docs