API reference
members_only · 4003 · HTTP 422
The video is members-only / requires a channel membership.
Example response
{ "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": "audio" } } }
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: 4xxx · the media has no transcript to give.
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 transcription of the audio may still produce a transcript. When it can, the response carries `error.retry_with: { "mode": "audio" }`; send that and it bills from 1 credit (2 credits per minute 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.Related errors
- audio_ineligible (3004), an audio retry on an input transcription cannot serve
- insufficient_credits (2001), an audio retry the balance cannot cover