members_only (4003, HTTP 422) · TranscriptFetch API error

The video is members-only / requires a channel membership.

Number4003

HTTP status422Unprocessable Entity

Familycontent4xxx · the media has no transcript to give

Example response

JSON

{
  "ok": false,
  "request_id": "req_…",
  "error": {
    "code": "members_only",
    "number": 4003,
    "message": "The video is members-only / requires a channel membership.",
    "docs": "https://transcriptfetch.com/docs/errors/members_only",
    "retry_with": {
      "mode": "auto"
    }
  }
}

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

What it means

Members only. The video is members-only / requires a channel membership.

Shown to end users as: “This video is members-only and can't be transcribed.”

Why it happens

Members only. The video is members-only / requires a channel membership.

What to do

Permanent for this input: the same request will fail the same way, so do not retry unchanged. Failed requests are never charged.
The content likely contains speech even though no caption track can be served, so AI Fallback Transcription may still produce a transcript. When it can, the response carries error.retry_with: { "mode": "auto" }; send that and it bills from 1 credit (1 credit per started 5 minutes of audio) on delivery, never on failure.

Retryable? No, this is permanent for this input. Every error response carries a request_id; include it when contacting support.