Quickstart

This guide gets you from zero to your first transcript in under two minutes. You'll grab an API key, submit a URL, and receive a full transcript — no SDK required.

API access requires a Plus or Pro plan. Free accounts can use the WiseScribe web app but cannot make API requests. Upgrade your plan →

Get your API key

Sign in to wisescribe.ai, go to Settings → API Keys, and create a new key. Your key starts with wsc_ and is shown only once — copy it somewhere safe.

Submit your first URL

Pass any supported URL in the request body. Supported platforms: YouTube, TikTok, Instagram, Facebook, X (Twitter), Vimeo, Spotify, and Apple Podcasts.

POST
/api/v1/transcribe
curl https://wisescribe.ai/api/v1/transcribe \
  -H "Authorization: Bearer wsc_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"}'

Understand the response

For most YouTube, Vimeo, Spotify, and podcast URLs the API responds synchronously with a 200:

Synchronous response (200)

{
  "ok": true,
  "data": {
    "title": "Never Gonna Give You Up",
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "duration": "3:32",
    "durationSeconds": 212,
    "transcript": "We're no strangers to love...",
    "tier": "youtube"
  }
}

For platforms that require background processing (TikTok, Instagram, Facebook, X), you'll receive a 202 with a job ID:

Async response (202)

{
  "ok": true,
  "queued": true,
  "jobId": "a9f3c812-1234-5678-abcd-ef0123456789",
  "pollUrl": "/api/v1/job/a9f3c812-1234-5678-abcd-ef0123456789"
}

Poll until status is "done":

GET
/api/v1/job/:jobId
curl https://wisescribe.ai/api/v1/job/a9f3c812-1234-5678-abcd-ef0123456789 \
  -H "Authorization: Bearer wsc_YOUR_KEY"

What's next?

Was this page helpful?