API reference

unsupported_platform, HTTP 422

The URL has no captions and is not on a platform AI transcription supports (YouTube, TikTok, Instagram, X, Facebook, or a direct media file).

Example response

{
  "ok": false,
  "request_id": "req_...",
  "error": {
    "code": "unsupported_platform",
    "message": "The URL has no captions and is not on a platform AI transcription supports (YouTube, TikTok, Instagram, X, Facebook, or a direct media file)."
  }
}

Why it happens

  • The URL has no captions and is not on a platform AI transcription can serve. Audio transcription supports YouTube, TikTok, Instagram, X, Facebook, and direct media file URLs (mp4/mp3/wav/…).
  • The URL points at an ordinary web page that happens to embed a player, rather than at the video itself.

How to fix it

  • Send the video's own URL rather than the page it is embedded on.
  • For a direct file, make sure the URL ends in a media extension and is reachable without authentication.
  • To turn a page into text rather than a transcript, use POST /api/v1/web, which returns clean Markdown for any http(s) URL.
Retryable? No, not for this input. The same URL will always fail. Failed requests are never charged. Every error response carries a request_id, include it when contacting support.
Next →All error codes
unsupported_platform (HTTP 422) · TranscriptFetch API error