unsupported_platform · 3001 · HTTP 422

{
  "ok": false,
  "request_id": "req_…",
  "error": {
    "code": "unsupported_platform",
    "number": 3001,
    "message": "The input is not on a platform we serve. Transcripts cover YouTube, TikTok, Instagram and direct media files.",
    "docs": "https://transcriptfetch.com/docs/errors/unsupported_platform"
  }
}

Every failure carries error.code, error.number, error.message and error.docs, plus at most one of retry_with (the request change that would succeed), details (structured specifics) or issues (validation problems). Family: 3xxx · this input cannot be served.

The input is not on a platform we serve. Transcripts cover YouTube, TikTok, Instagram and direct media files.

• The URL is not on a supported platform. Transcripts are available for YouTube, TikTok, Instagram, 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.
• X/Twitter and Facebook links, which were retired, and Spotify or Apple Podcasts links: podcasts left the product on 2026-09-10.

• 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.

• endpoint_platform_mismatch (3002), a supported platform sent to an endpoint that does not serve it
• invalid_input (3005), a supported platform whose id or URL does not parse