YouTube

Get video transcript

HTTP 404 with error code transcript_not_available confirms that YouTube loaded the video but has no captions; other 404 responses are ambiguous upstream failures. HTTP 503 is a failed request, not an empty transcript: a 503 with upstream_status is an upstream service failure, while a 503 without it indicates network unavailability. Check the HTTP status and Content-Type before parsing an error body; gateways may return non-JSON errors. Failed requests do not consume Scrappa credits.

get/youtube/transcript

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/youtube/transcript
  • Auth: API key in header X-API-KEY

Query parameters

video_idstring

YouTube video ID (aliases: videoId, id)

videoIdstring

YouTube video ID (aliases: video_id, id)

idstring

YouTube video ID (aliases: video_id, videoId)

languagestring nullable

Transcript language code or name (alias: lang).

langstring nullable

Transcript language code or name (alias: language).

hlstring nullable

Language code for localized upstream video info lookups (e.g., en).

glstring nullable

Country code for localized upstream video info lookups (e.g., US).

Response

videoIdstring required
languagestring nullable required
languageNamestring nullable required
sourceLanguagestring nullable required
sourceLanguageNamestring nullable required
isAutoGeneratedboolean required
isTranslatedboolean required
textstring required

Changes

No recorded changes to this operation across all 4 revisions of this API.