René's URL Explorer Experiment


Title: Error codes · TranscriptFetch docs

Open Graph Title: Error codes · TranscriptFetch docs

X Title: Error codes · TranscriptFetch docs

Description: HTTP status codes and canonical error codes for the TranscriptFetch API, plus per-video outcome values.

Open Graph Description: HTTP status codes and canonical error codes for the TranscriptFetch API, plus per-video outcome values.

X Description: HTTP status codes and canonical error codes for the TranscriptFetch API, plus per-video outcome values.

Keywords:

Opengraph URL: https://transcriptfetch.com/docs/errors

direct link

Domain: transcriptfetch.com

Hey, it has json ld scripts: 
{"@context":"https://schema.org","@type":"Organization","@id":"https://transcriptfetch.com/#organization","name":"TranscriptFetch","alternateName":"Transcript Fetch","url":"https://transcriptfetch.com","email":"support@transcriptfetch.com","logo":{"@type":"ImageObject","url":"https://transcriptfetch.com/apple-icon.png"},"contactPoint":{"@type":"ContactPoint","contactType":"customer support","email":"support@transcriptfetch.com"},"foundingDate":"2026","founder":{"@type":"Person","name":"Chandler Casey","sameAs":["https://www.linkedin.com/in/chandler-casey1/","https://x.com/solodevpreneur","https://indiepa.ge/chandlercasey"]},"description":"TranscriptFetch is a transcript retrieval service for YouTube, TikTok and Instagram: whole channels, playlists and searches, not just one-off links.","sameAs":["https://www.wikidata.org/wiki/Q141470122","https://cloudsecurityalliance.org/star/registry/transcriptfetch","https://github.com/TranscriptFetch","https://www.linkedin.com/company/transcript-fetch/","https://www.crunchbase.com/organization/transcriptfetch","https://www.npmjs.com/package/transcriptfetch","https://www.npmjs.com/package/n8n-nodes-transcriptfetch","https://pypi.org/project/transcriptfetch-sdk/","https://discord.gg/R4uBZNwRc","https://www.postman.com/transcriptfetch"],"knowsAbout":[{"@type":"Thing","name":"Closed captioning","sameAs":"https://en.wikipedia.org/wiki/Closed_captioning"},{"@type":"Thing","name":"Subtitles","sameAs":"https://en.wikipedia.org/wiki/Subtitles"},{"@type":"Thing","name":"Speech recognition","sameAs":"https://en.wikipedia.org/wiki/Speech_recognition"},{"@type":"Thing","name":"Web API","sameAs":"https://en.wikipedia.org/wiki/Web_API"},{"@type":"Thing","name":"YouTube","sameAs":"https://en.wikipedia.org/wiki/YouTube"},{"@type":"Thing","name":"Retrieval-augmented generation","sameAs":"https://en.wikipedia.org/wiki/Retrieval-augmented_generation"},{"@type":"Thing","name":"Large language model","sameAs":"https://en.wikipedia.org/wiki/Large_language_model"},{"@type":"Thing","name":"JSON","sameAs":"https://en.wikipedia.org/wiki/JSON"},{"@type":"Thing","name":"Web scraping","sameAs":"https://en.wikipedia.org/wiki/Web_scraping"},"YouTube transcripts","Video transcription","YouTube Data API","Model Context Protocol (MCP)","AI agents"]}
 
{"@context":"https://schema.org","@type":"WebSite","@id":"https://transcriptfetch.com/#website","name":"TranscriptFetch","url":"https://transcriptfetch.com/","publisher":{"@id":"https://transcriptfetch.com/#organization"}}
 
{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Docs","item":"https://transcriptfetch.com/docs"},{"@type":"ListItem","position":2,"name":"Error codes & outcomes","item":"https://transcriptfetch.com/docs/errors"}]}
application-nameTranscriptFetch
google-adsense-accountca-pub-9390105787953726
mobile-web-app-capableyes
apple-mobile-web-app-titleTranscriptFetch
apple-mobile-web-app-status-bar-styledefault
og:site_nameTranscriptFetch
og:imagehttps://transcriptfetch.com/opengraph-image
og:image:typeimage/png
og:image:width1200
og:image:height630
og:image:altThe transcript API for social media video | TranscriptFetch
og:typewebsite
twitter:cardsummary_large_image
twitter:imagehttps://transcriptfetch.com/opengraph-image
twitter:image:altThe transcript API for social media video | TranscriptFetch
twitter:image:typeimage/png
twitter:image:width1200
twitter:image:height630

Links:

Skip to contenthttps://transcriptfetch.com/docs/errors#docs-main
TranscriptFetchhttps://transcriptfetch.com/
GitHubhttps://github.com/TranscriptFetch
Log inhttps://transcriptfetch.com/app
Help centerhttps://transcriptfetch.com/help
Feedbackhttps://transcriptfetch.com/feedback
Start herehttps://transcriptfetch.com/docs
Quickstarthttps://transcriptfetch.com/docs
Endpointshttps://transcriptfetch.com/docs/endpoints
Request builderhttps://transcriptfetch.com/docs/request-builder
Response formathttps://transcriptfetch.com/docs/output
Error codes & outcomeshttps://transcriptfetch.com/docs/errors
Referencehttps://transcriptfetch.com/docs/endpoints
YouTubehttps://transcriptfetch.com/docs/youtube/transcript#platform-index
POSTTranscripthttps://transcriptfetch.com/docs/youtube/transcript
POSTSearchhttps://transcriptfetch.com/docs/youtube/search
POSTChannel Videoshttps://transcriptfetch.com/docs/youtube/channel-videos
POSTPlaylisthttps://transcriptfetch.com/docs/youtube/playlist
POSTShortshttps://transcriptfetch.com/docs/youtube/shorts
POSTChannel Monitorhttps://transcriptfetch.com/docs/youtube/monitors
TikTokhttps://transcriptfetch.com/docs/tiktok/transcript#platform-index
POSTTranscripthttps://transcriptfetch.com/docs/tiktok/transcript
POSTSearchhttps://transcriptfetch.com/docs/tiktok/search
POSTProfile Videoshttps://transcriptfetch.com/docs/tiktok/profile-videos
POSTProfile Monitorhttps://transcriptfetch.com/docs/tiktok/monitors
Instagramhttps://transcriptfetch.com/docs/instagram/transcript#platform-index
POSTTranscripthttps://transcriptfetch.com/docs/instagram/transcript
POSTSearchhttps://transcriptfetch.com/docs/instagram/search
POSTProfile Reelshttps://transcriptfetch.com/docs/instagram/profile-reels
POSTProfile Monitorhttps://transcriptfetch.com/docs/instagram/monitors
Cross-platformhttps://transcriptfetch.com/docs/endpoints#by-platform
POSTBatch Transcripthttps://transcriptfetch.com/docs/batch
Jobshttps://transcriptfetch.com/docs/jobs/status#platform-index
GETJob Statushttps://transcriptfetch.com/docs/jobs/status
Accounthttps://transcriptfetch.com/docs/account/usage#platform-index
GETCredit Balancehttps://transcriptfetch.com/docs/account/usage
GETHealth Checkhttps://transcriptfetch.com/docs/account/health
Guideshttps://transcriptfetch.com/docs/transcription
AI Fallback Transcriptionhttps://transcriptfetch.com/docs/transcription
Paginationhttps://transcriptfetch.com/docs/pagination
Retries & idempotencyhttps://transcriptfetch.com/docs/pagination#sec-idempotent-retries
Monitors & webhookshttps://transcriptfetch.com/docs/monitors
Channel jobshttps://transcriptfetch.com/docs/channel-jobs
SDKs & integrationshttps://transcriptfetch.com/docs/python
Pythonhttps://transcriptfetch.com/docs/python
Nodehttps://transcriptfetch.com/docs/node
LangChainhttps://transcriptfetch.com/docs/langchain
LlamaIndexhttps://transcriptfetch.com/docs/llamaindex
MCP serverhttps://transcriptfetch.com/docs/mcp
n8nhttps://transcriptfetch.com/docs/n8n
OpenAIhttps://transcriptfetch.com/docs/openai
Limits & billinghttps://transcriptfetch.com/docs/rate-limits
Rate limitshttps://transcriptfetch.com/docs/rate-limits
Billing & creditshttps://transcriptfetch.com/docs/billing
Start herehttps://transcriptfetch.com/docs
invalid_requestThe body failed validation.1001400https://transcriptfetch.com/docs/errors/invalid_request
invalid_cursorThe pagination cursor is malformed or expired.1002400https://transcriptfetch.com/docs/errors/invalid_cursor
unauthorizedMissing or invalid API key.1101401https://transcriptfetch.com/docs/errors/unauthorized
idempotency_conflictIdempotency-Key reused with a different body, or a request with that key is still in flight.1201409https://transcriptfetch.com/docs/errors/idempotency_conflict
not_foundNo such resource: an unknown job or monitor id (or one that belongs to someone else), or a channel or playlist that does not exist or is not public.1301404https://transcriptfetch.com/docs/errors/not_found
insufficient_creditsNot enough credits for the request.2001402Retryhttps://transcriptfetch.com/docs/errors/insufficient_credits
batch_too_largeThe batch exceeds your plan's per-request cap.2002400https://transcriptfetch.com/docs/errors/batch_too_large
monitor_limit_reachedThe account already has as many monitors as its plan allows.2003400https://transcriptfetch.com/docs/errors/monitor_limit_reached
job_limit_reachedThe account already runs as many channel jobs as its plan allows.2004409Retryhttps://transcriptfetch.com/docs/errors/job_limit_reached
rate_limitedYour account or key has reached a request or work-capacity limit.2101429Retryhttps://transcriptfetch.com/docs/errors/rate_limited
unsupported_platformThe input is not on a platform we serve.3001422https://transcriptfetch.com/docs/errors/unsupported_platform
endpoint_platform_mismatchThe platform is supported, but not by this endpoint: playlist listing covers YouTube and TikTok only, so an Instagram profile URL sent to /transcripts/playlist lands here.3002422https://transcriptfetch.com/docs/errors/endpoint_platform_mismatch
audio_ineligibleAudio transcription cannot run on this input, so mode: "audio" (or ai_fallback) has nothing to work on.3004422https://transcriptfetch.com/docs/errors/audio_ineligible
invalid_inputThe input is not something we can transcribe: it is not a YouTube, TikTok or Instagram video (a profile, playlist or LIVE room link, an unsupported site), nor a direct media file URL.3005422https://transcriptfetch.com/docs/errors/invalid_input
audio_too_longThe media is longer than the AI-transcription length limit, so no audio was downloaded and nothing was charged.3006422https://transcriptfetch.com/docs/errors/audio_too_long
drm_protectedThe source is DRM-protected and cannot be downloaded.3007422https://transcriptfetch.com/docs/errors/drm_protected
privateThe video is private.4001422https://transcriptfetch.com/docs/errors/private
unavailableThe video is unavailable (deleted, removed, terminated, or region-blocked), or the share link no longer points to a video (a TikTok short link that redirects to the home page).4002422https://transcriptfetch.com/docs/errors/unavailable
members_onlyThe video is members-only / requires a channel membership.4003422https://transcriptfetch.com/docs/errors/members_only
age_restrictedThe video is age-restricted and not accessible without sign-in.4004422https://transcriptfetch.com/docs/errors/age_restricted
region_blockedThe video is geo-restricted for the fetch region.4005422https://transcriptfetch.com/docs/errors/region_blocked
not_publicInstagram returned no media for this post to a logged-out viewer: it is private, removed, or restricted to logged-in users.4006422https://transcriptfetch.com/docs/errors/not_public
live_streamThe video is a live stream: broadcasting now, scheduled, or ended without a published recording.4101422https://transcriptfetch.com/docs/errors/live_stream
was_liveThe video was a live broadcast and has no caption track.4102422https://transcriptfetch.com/docs/errors/was_live
no_captionsNo caption track (manual or auto-generated) is available.4103422https://transcriptfetch.com/docs/errors/no_captions
captions_disabledNo captions are available: the uploader disabled them, or YouTube has not generated them yet for a new upload.4104422https://transcriptfetch.com/docs/errors/captions_disabled
no_speechNo detectable speech (e.g. music/ambient); nothing to transcribe.4105422https://transcriptfetch.com/docs/errors/no_speech
no_audio_streamThe downloaded media carried no audio stream, so it could not be transcribed.4106422https://transcriptfetch.com/docs/errors/no_audio_stream
no_videoThe post has no video to transcribe: an Instagram photo post or photo carousel, a TikTok photo post (slideshow), or a page with no playable media.4107422https://transcriptfetch.com/docs/errors/no_video
upstream_errorThe upstream fetch failed with a server-side error.5001503Retryhttps://transcriptfetch.com/docs/errors/upstream_error
timeoutUpstream fetch timed out.5002503Retryhttps://transcriptfetch.com/docs/errors/timeout
connectionCould not connect to the upstream service.5003503Retryhttps://transcriptfetch.com/docs/errors/connection
proxy_unavailableThe upstream egress proxy refused the tunnel (billing, credentials, or exhausted quota).5004503Waithttps://transcriptfetch.com/docs/errors/proxy_unavailable
parse_errorUpstream returned a response that couldn't be parsed.5005503Retryhttps://transcriptfetch.com/docs/errors/parse_error
upstream_unavailableThe transcript service could not be reached.5101502Retryhttps://transcriptfetch.com/docs/errors/upstream_unavailable
internal_errorUnexpected server error.9001500Retryhttps://transcriptfetch.com/docs/errors/internal_error
unknownThe fetch failed for an unspecified reason.9002503Retryhttps://transcriptfetch.com/docs/errors/unknown
Full reference →https://transcriptfetch.com/docs/errors/no_captions
Response formathttps://transcriptfetch.com/docs/output
AI Fallback Transcriptionhttps://transcriptfetch.com/docs/transcription

Viewport: width=device-width, initial-scale=1

URLs of crawlers that visited me.