endpoint_platform_mismatch (3002, HTTP 422) · TranscriptFetch API error

Example response

{
  "ok": false,
  "request_id": "req_…",
  "error": {
    "code": "endpoint_platform_mismatch",
    "number": 3002,
    "message": "The platform is supported, but not by this endpoint: channel and playlist listing are YouTube only. error.details names the endpoint to use.",
    "docs": "https://transcriptfetch.com/docs/errors/endpoint_platform_mismatch",
    "retry_with": {
      "endpoint": "/api/v2/transcripts/video"
    }
  }
}

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.

What it means

The platform is supported, but not by this endpoint: channel and playlist listing are YouTube only. error.details names the endpoint to use.

Why it happens

A TikTok or Instagram URL was sent to `/transcripts/channel` or `/transcripts/playlist`. Listing is YouTube only; those platforms have no public enumeration.

What to do

Send that video to POST /api/v2/transcripts/video instead; `error.retry_with.endpoint` names it.
Use the channel and playlist endpoints for YouTube inputs only.

Retryable? Only on the endpoint named in `retry_with`. Every error response carries a request_id; include it when contacting support.

Related errors

unsupported_platform (3001), a platform no endpoint serves at all

Next →All error codes