Structured error code for programmatic filtering. Error items are never billed — charges only apply to successful transcripts. Input errors: AGE_RESTRICTED (requires sign-in / age verification), PRIVATE_OR_UNAVAILABLE (private, deleted, or region-blocked), LIVE_VIDEO (live streams have no static captions), LANGUAGE_NOT_FOUND (captions exist but not in the requested language). Budget errors: NO_CAPTIONS_AVAILABLE (video has zero caption tracks), AI_MINUTES_LIMIT_REACHED (maxAiMinutes budget exhausted), AI_FALLBACK_SKIPPED_TOO_LONG (video exceeds skipAiFallbackIfLongerThan), SPENDING_LIMIT_REACHED (Apify account spending limit hit). Infrastructure errors: BOT_DETECTION (YouTube challenged the request, retried via proxy), EXTRACTION_ERROR (generic yt-dlp failure), AI_TRANSCRIPTION_FAILED (Whisper model or audio download error), UNEXPECTED_ERROR (unhandled exception).
Example:LANGUAGE_NOT_FOUND
Options:NO_CAPTIONS_AVAILABLELANGUAGE_NOT_FOUNDAGE_RESTRICTEDPRIVATE_OR_UNAVAILABLELIVE_VIDEOBOT_DETECTIONAI_MINUTES_LIMIT_REACHEDAI_FALLBACK_SKIPPED_TOO_LONGSPENDING_LIMIT_REACHEDAI_TRANSCRIPTION_FAILEDEXTRACTION_ERRORUNEXPECTED_ERROR