DocumentationAPI Reference

TranscriptHQ API

Extract word-for-word transcripts from YouTube, TikTok, Twitter, Twitch & more. AI-powered with noise reduction, 100+ language translation, and 95% accuracy.

Base URL:https://api.transcripthq.io
v1

Quick Start Guide

Get your first transcript in under 5 minutes

1

Get Your API Key

  1. Sign in or create an account
  2. Go to the API Keys page
  3. Click "Create API Key" and give it a name
  4. Copy your API key immediately - it won't be shown again

Security Note

Keep your API key secure. Never expose it in client-side code or public repositories.

2

Make Your First Request

Create a transcript job by sending a POST request:

curl -X POST https://api.transcripthq.io/v1/transcripts \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "service_type": "youtube",
    "videos": ["dQw4w9WgXcQ"]
  }'

Response:

{
  "job_id": "675f1a2b3c4d5e6f7a8b9c0d",
  "status": "processing",
  "videos_count": 1,
  "credits_charged": 4,
  "poll_url": "/v1/transcripts/675f1a2b3c4d5e6f7a8b9c0d"
}
3

Poll for Results

Jobs process asynchronously. Poll every 2-3 seconds until status is "completed":

curl https://api.transcripthq.io/v1/transcripts/675f1a2b3c4d5e6f7a8b9c0d \
  -H "X-API-Key: YOUR_API_KEY"

Completed Response:

{
  "job_id": "675f1a2b3c4d5e6f7a8b9c0d",
  "status": "completed",
  "summary": { "total": 1, "done": 1, "failed": 0 },
  "videos": [{
    "video_id": "dQw4w9WgXcQ",
    "status": "done",
    "title": "Rick Astley - Never Gonna Give You Up",
    "duration_seconds": 213.5,
    "transcript": "We're no strangers to love...",
    "segments": [
      { "text": "We're no strangers to love", "start": 0.5, "duration": 2.1 }
    ],
    "language": "en",
    "is_native": true,
    "is_generated": false
  }],
  "credits_used": 4
}

Pro Tips

  • Batch Processing: Submit multiple videos in a single request
  • Noise Reduction: Add "noise_reduction": true for cleaner audio
  • Translation: Add "target_language": "en" to translate
  • Word Timestamps: Pro users can enable "word_timestamps": true

Authentication

All API requests require an API key in the header:

X-API-Key: YOUR_API_KEY
Header Name:X-API-Key
Get your key:Dashboard → API Keys

Common Parameters (All Platforms)

These parameters work with all service_type values (YouTube, Twitter, Twitch, etc.):

service_type

"youtube" (default), "twitter", "twitch", "vimeo", "tiktok", "dailymotion", "bilibili"

videos*

Array of video IDs or URLs

max_videos

Limit videos from playlist/channel (default: 100)

word_timestamps

Enable word-level timestamps (Pro feature)

source_language

ISO 639-1 language hint for Whisper (e.g., "zh", "ta", "hi"). Auto-detects if omitted. Improves accuracy and speed for non-English.

target_language

Translate transcript to this language (e.g., "en", "es", "fr")

noise_reduction

Apply audio cleaning before transcription (default: false)

native_only

Skip Whisper fallback, only use native captions (default: false). Videos without captions will fail.

skip_metadata

Skip upfront metadata scan for faster job creation (default: false)

Rate Limits by Plan

PlanRate LimitConcurrent Jobs
Free30/min1
Starter100/min2
Pro300/min2
Business500/min5
Enterprise500/minUnlimited

Ready to get started?

Create your API key and start extracting transcripts in minutes. 3 free minutes included.