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 }
    ]
  }],
  "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

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. 60 free minutes included.