YouTube Transcript Scraper & API - Transcripts + Comments
Pricing
from $2.00 / 1,000 transcripts
YouTube transcript API and scraper: get transcripts, captions and subtitles in the language you choose from videos, channels, playlists or search, plus top comments. Timestamped segments, text or markdown chunks for AI, RAG, n8n and MCP. No-caption videos are free. $0.80 per 1,000 transcripts.
videoId
Optional
11-character YouTube video ID, e.g. dQw4w9WgXcQ.
videoUrl
Optional
Watch URL of the video (https://www.youtube.com/watch?v=), also for Shorts and youtu.be inputs.
status
Optional
ok = transcript delivered (the only status charged as a transcript). no_captions = the video has no usable caption track. language_not_available = captions exist but none in your languages and the fallback is "none". unavailable = private, deleted, members-only, age-restricted, not available in the proxy's country, or live without replay. error = YouTube refused access (bot check, not retried) or every retry after a rate limit or network error failed.
errorCode
Optional
Machine-readable reason when status is not "ok"; null on "ok" rows. no_captions: NO_CAPTIONS, AUTO_CAPTIONS_EXCLUDED, EMPTY_CAPTION_TRACK. language_not_available: LANGUAGE_NOT_AVAILABLE. unavailable: VIDEO_UNAVAILABLE (private, deleted), LOGIN_REQUIRED (age-restricted, members-only), LIVE_STREAM, GEO_RESTRICTED. error: BLOCKED, RATE_LIMITED, CAPTIONS_NEED_PO_TOKEN, TIMEOUT, NETWORK_ERROR, HTTP_ERROR, UNKNOWN_ERROR.
errorMessage
Optional
Human-readable reason that goes with errorCode (YouTube's own text for unavailable videos). Null on "ok" rows.
title
Optional
Video title.
channelName
Optional
Channel name.
channelId
Optional
Channel ID (UC...).
channelHandle
Optional
Channel @handle, when YouTube returns it.
channelUrl
Optional
Channel URL.
publishedAt
Optional
Publish time. ISO 8601 with time zone when YouTube gives it (e.g. 2009-10-24T23:57:33-07:00), otherwise the date only (YYYY-MM-DD), or null.
durationSeconds
Optional
Video length in seconds.
viewCount
Optional
View count at scrape time.
likeCount
Optional
Like count at scrape time, when YouTube shows it.
description
Optional
Full video description.
keywords
Optional
Tags the uploader set on the video.
category
Optional
YouTube category, e.g. Music, Education. Null when YouTube does not return it.
isLive
Optional
True for live streams and past live streams.
thumbnailUrl
Optional
URL of the largest thumbnail.
language
Optional
Language code of the delivered transcript track as YouTube names it, e.g. en, de-DE, pt-BR. Null when there is no transcript.
languageName
Optional
Name of the delivered track, e.g. "English" or "Korean (auto-generated)".
transcriptType
Optional
manual = captions uploaded by the creator; auto_generated = YouTube's speech recognition. Null when there is no transcript.
transcriptAvailable
Optional
True exactly when this row carries a transcript (status "ok").
languageMatch
Optional
How the track was chosen: preferred-manual / preferred-auto = matched one of your languages (human-made / automatic), original = the video's spoken language (told by YouTube's automatic captions; fallback), any = first available track (fallback; also used by the spoken-language option when YouTube cannot tell the spoken language, so the first human-made track is used).
availableLanguages
Optional
Every caption track the video has.
transcriptText
Optional
Whole transcript as plain text (formats "text" and "both"; otherwise null). One paragraph, or one "[mm:ss] line" per caption with "Timestamps in plain text".
segments
Optional
Timestamped caption lines in time order (formats "segments" and "both"; otherwise null).
segmentCount
Optional
Number of caption lines in the transcript (in every format). Null when there is no transcript.
chunks
Optional
Markdown chunks for AI / RAG (format "markdown"; otherwise null). Each chunk holds whole caption lines and has a deep link to its start.
wordCount
Optional
Number of words in the transcript. Null when there is no transcript.
commentCount
Optional
Total comment count YouTube shows for the video (not the number delivered). Null when comments were not requested.
commentsDisabled
Optional
True when the video has comments turned off. Null when comments were not requested.
commentsError
Optional
Set when comment fetching failed or stopped early (the transcript on the row is complete and the comments delivered are charged). Null otherwise.
source
Optional
Which input found this video.
collectedAt
Optional
When this row was collected (ISO 8601, UTC).
comments
Optional
Top-level comments (only with "Include comments"; otherwise null). Replies are not included.