unavailable · 4002 · HTTP 422

Example response

{
  "ok": false,
  "request_id": "req_…",
  "error": {
    "code": "unavailable",
    "number": 4002,
    "message": "The video is unavailable (deleted, removed, terminated, or region-blocked).",
    "docs": "https://transcriptfetch.com/docs/errors/unavailable"
  }
}

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

Unavailable. The video is unavailable (deleted, removed, terminated, or region-blocked).

Shown to end users as: “This video is unavailable, it may be deleted, removed, or region-blocked.”

Why it happens

• Unavailable. The video is unavailable (deleted, removed, terminated, or region-blocked).

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.
• AI transcription would not help here: the content itself is not accessible to fetch.

Related errors

• unsupported_platform (3001), an input on a platform we do not serve at all