Utilities · Guide

How to get a Utilities file transcript

TL;DR
To get a Utilities file transcript, sign up for a free Captapi key, then send one POST request to /v1/video/transcript with your input. You get clean JSON back in seconds for 1 credit/min per call — no OAuth, scraping or platform SDKs. Whisper transcription of an uploaded file — 1 credit/min; durationSeconds + creditsCharged in the response.

How to get a Utilities file transcript (step by step)

  1. 1

    Get a free API key

    Create a free Captapi account (100 credits, no card) and generate an API key from the dashboard.

  2. 2

    Call the Video File Transcript API

    Send an authenticated POST request to /v1/video/transcript with your input. No OAuth, no scraping setup.

  3. 3

    Read the JSON response

    Parse the clean JSON response. Pass cache=true for a free 24h cache hit; default is always fresh.

Code example

curl -X POST "https://api.captapi.com/v1/video/transcript" \
  -H "Authorization: Bearer capt_live_..." \
  -F "file=@video.mp4"
# or: -H "x-api-key: capt_live_..."

What the response looks like

{
  "success": true,
  "data": {
    "filename": "sample.mp4",
    "transcript": "Hey everyone, welcome back to the channel. Today we're breaking down structured data APIs.",
    "transcriptSegments": [
      {
        "text": "Hey everyone, welcome back to the channel.",
        "start": 0,
        "duration": 4.12,
        "end": 4.12,
        "timestamp": "00:00"
      },
      {
        "text": "Today we're breaking down structured data APIs.",
        "start": 4.12,
        "duration": 4.28,
        "end": 8.4,
        "timestamp": "00:04"
      }
    ],
    "wordCount": 14,
    "segments": 2,
    "language": "english",
    "durationSeconds": 8.4,
    "duration": 8.4,
    "creditsCharged": 1,
    "noSpeech": false
  }
}

Billing metadata (credits charged, cache hit/miss) is returned in the X-Captapi-Credits and X-Captapi-Cache response headers.

Request parameters

NameTypeRequiredDescription
filefile YesVideo or audio file (multipart form field — use -F file=@path, not a query string). Max 200MB / 60 minutes.
languagestringNoISO-639-1 Whisper language hint, e.g. "en" or "tr". Omit to auto-detect.
translatebooleanNoWhen true, translate speech to English (Whisper translations API). Default false.
timestampGranularitystringNosegment (default) or word — word-level timings when Whisper exposes them.

Frequently asked questions

What does the Video File Transcript API do?

The Video File Transcript API lets you extract the full, timestamped transcript from a public Utilities uploaded video or audio file using one POST request to /v1/video/transcript. It returns clean JSON — no OAuth or infrastructure setup required.

How many credits does the Video File Transcript API cost?

Billing is 1 credit per minute of audio (rounded up, minimum 1). Failed or empty results are never charged.

Do I need a Utilities API key or OAuth?

No. A single Captapi key works across every platform Captapi supports — YouTube, TikTok, Instagram, Facebook, Twitter/X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Spotify, Kwai, and more. We handle proxies, rate limits, retries, and authentication for you.

Is the Video File Transcript API suitable for production use?

Yes. It is a stable REST endpoint with predictable JSON. Upload via multipart form field file (POST) — see the cURL sample. Use durationSeconds / creditsCharged to verify per-minute billing.

Ready to get a Utilities file transcript?

Start free with 100 credits — no credit card required.

Get your free API key