Getting started

Quickstart

Three steps from zero to your first transcript.

Create a key

Generate a tf_live_… key from the dashboard. Keys are shown once, store them somewhere safe.

Make a call

POST a video URL or ID to /transcripts/video with your key in the Authorization header.

Read the JSON

Get back a structured envelope with text, timestamped segments, and usage.

bash

Try in Postman

# Your first call, fetch a transcript
curl https://transcriptfetch.com/api/v1/transcripts/video \
  -H "Authorization: Bearer tf_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "video": "youtu.be/dQw4w9WgXcQ" }'

Once you're calling the API: the endpoint reference covers every route, the error reference explains each failure code and whether it retries, and status shows live uptime and response times. New endpoints and tools land in the changelog.

Next →Base URL & auth