API Docs

Download video (direct URL)

Resolve a fresh direct media download URL (and thumbnail when available) for the same supported platforms as transcription—without creating a transcription. Resolution uses the same strategies as the transcribe pipeline (yt-dlp with proxy fallbacks where configured, then platform-specific fallbacks). Send your GetTranscribe API key in the x-api-key header (same as the other REST endpoints).

POSThttps://api.gettranscribe.ai/download-video

Headers

Content-Type: application/json

x-api-key: YOUR_API_KEY

Body Parameters

urlrequired

string

Public post URL for: YouTube (watch, shorts, youtu.be), Instagram (p, reel, reels, tv), TikTok, Facebook (watch, reel, videos), X/Twitter (status), Pinterest (pin), Google Drive file link, or a direct .mp4/.mov (etc.) file URL.

Example Request

curl -X POST https://api.gettranscribe.ai/download-video \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "url": "https://www.instagram.com/p/DWy1RmFAGjF/"
  }'

Example Response

{
  "id": 501,
  "url": "https://www.instagram.com/p/DWy1RmFAGjF/",
  "platform": "instagram",
  "user_id": 1,
  "download_url": "https://instagram.fxyz1-1.fna.fbcdn.net/...long-signed-url...",
  "thumbnail": "https://scontent.cdninstagram.com/...",
  "created_at": "2026-04-11T18:00:00.000Z",
  "updated_at": "2026-04-11T18:00:00.000Z",
  "deleted_at": null
}

Use the same permanent x-api-key header as for POST /transcriptions. Wallet balance must be at least 0.01; a small debit is recorded after success. download_url and thumbnail are direct, time-limited URLs from the source platform (e.g. Instagram fbcdn, YouTube googlevideo, TikTok CDN)—they expire; call again for a fresh link. YouTube often resolves to a best HTTPS audio stream URL first (same priority as transcription downloads), not always a muxed video file. No S3 copy is created; the row is an audit log of the resolved URLs.