API reference

unsupported_platform, HTTP 422

The input is not on a platform this endpoint serves - transcripts cover YouTube, TikTok, Instagram, podcasts and direct media files; channel and playlist listing are YouTube only. Also returned when a podcast link cannot be matched to a public RSS feed (Spotify-exclusive shows have none).

Example response

{
  "ok": false,
  "request_id": "req_...",
  "error": {
    "code": "unsupported_platform",
    "message": "The input is not on a platform this endpoint serves - transcripts cover YouTube, TikTok, Instagram, podcasts and direct media files; channel and playlist listing are YouTube only. Also returned when a podcast link cannot be matched to a public RSS feed (Spotify-exclusive shows have none)."
  }
}

Why it happens

The URL is not on a supported platform. Transcripts are available for YouTube, TikTok, Instagram, podcast episodes (Spotify, Apple Podcasts, RSS), 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.
The endpoint does not serve that platform. Channel and playlist listing are YouTube only.

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.

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.

Related errors

invalid_request , a supported platform sent in a malformed body fails here instead
upstream_unavailable , a supported platform that is merely down looks similar from the outside

Next →All error codes