Skip to main content
Every endpoint is a POST to https://api.transcriptmagic.com with {"url": "..."} in the body. Auth, path style, and the body field are identical across platforms — but the response shape differs by platform, because each upstream source emits different metadata. The per-endpoint pages below document the exact shape you can expect from each.

​
Base URL

https://api.transcriptmagic.com

​
Endpoints

PlatformPathGuide
YouTubePOST /api/youtube/transcriptYouTube →
TikTokPOST /api/tiktok/transcriptTikTok →
InstagramPOST /api/instagram/transcriptInstagram →
FacebookPOST /api/facebook/transcriptFacebook →

​
Request

All endpoints accept the same body and headers. Headers 
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Body 
{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}

​
Response

All endpoints return 200 OK on success and always include a credits field with your remaining balance. Beyond that, the shape varies:
Platformtranscript typePer-line timingVideo URLs included
YouTubearray of segment objectsyes (startMs, endMs, startTimeText)no
TikTokstring (newline-joined)noyes (when available, in videoUrls)
Instagramarray of {text} objects (under transcripts, plural)nono
Facebookstring (newline-joined)noyes (when available, in videoUrls)
See the response schema page for the full per-platform field reference, or jump into a per-endpoint page for a real example payload.

​
Errors

All endpoints share the same error vocabulary — see errors for the full table. The most common ones:
  • 400 — bad URL in the body, missing url, or invalid JSON
  • 401 — missing or invalid API key
  • 403 — out of credits (error: "no_credits")
  • 404 — upstream says the video is missing, private, or has no captions
  • 429 — over the rate limit
  • 502 — upstream platform HTTP error (retry with backoff)