YouTube Scraper - Videos, Channels & Transcripts
Pricing
from $1.50 / 1,000 results
Search YouTube videos, list channel videos, and collect public channel details, comments, replies, and available transcripts. Pay per delivered row plus a start fee.
Row type
rowType
Required
Type of row: video, channel, or comment. Replies use the comment type.
Entity ID
id
Required
Stable ID for the billed row.
Comment ID
commentId
Optional
YouTube comment identifier for comment rows.
Parent comment ID
parentCommentId
Optional
Parent comment for reply rows.
Root comment ID
rootCommentId
Optional
Top-level comment for a comment thread.
Is reply
isReply
Optional
Whether a comment row is a reply.
Comment text
text
Optional
Public comment text.
Reply count
replyCount
Optional
Reply count exposed by YouTube.
Replies emitted
repliesCount
Optional
Reply rows delivered in this run for this top-level comment; null when replies stream as separate rows because the count is unknown when the parent is emitted; 0 when there are no replies or replies are disabled.
Parent video title
videoTitle
Optional
Parent video title copied onto comment rows.
Parent video URL
videoUrl
Optional
Parent video URL copied onto comment rows.
Parent video ID
parentVideoId
Optional
Seed video for related-video rows.
Parent video title
parentVideoTitle
Optional
Seed video title for related-video rows.
Parent video URL
parentVideoUrl
Optional
Seed video URL for related-video rows.
Video ID
videoId
Optional
YouTube 11-character video identifier.
Title
title
Optional
Video title.
Video URL
url
Optional
Canonical YouTube watch URL.
Channel name
channelName
Optional
Name of the YouTube channel.
Channel ID
channelId
Optional
YouTube channel identifier when available.
Channel URL
channelUrl
Optional
Public channel URL when available.
View count
viewCount
Optional
Parsed numeric view count when available.
Duration
duration
Optional
Raw duration label such as 12:34.
Duration seconds
durationSeconds
Optional
Duration converted to seconds when available.
Published text
publishedText
Optional
Raw relative publish label such as 2 years ago.
Published at
publishedAt
Optional
ISO publish timestamp/date when available or approximated from relative text (see publishedAtApproximate).
Published at is approximate
publishedAtApproximate
Optional
True when publishedAt was derived from a relative label like '2 years ago' (day-precision estimate, T00:00:00Z), not a real timestamp.
Description
description
Optional
Video description or search snippet.
Thumbnail URL
thumbnailUrl
Optional
Video thumbnail URL.
Category
category
Optional
YouTube video category when detail enrichment returns it.
Is live
isLive
Optional
Whether YouTube marks the video as live content.
Is short
isShort
Optional
Whether the row is treated as a YouTube Short.
Keywords
keywords
Optional
Video keywords when available; at most 50 entries are retained.
Available countries
availableCountries
Optional
Countries where YouTube says the video is available; at most 50 entries are retained.
Market gl
gl
Optional
Market country code used for this scrape.
Language hl
hl
Optional
Interface language code used for this scrape.
Estimated comment count
commentCountEstimated
Optional
YouTube header estimate when available.
Comments fetched
commentsFetched
Optional
Total comment + reply rows fetched for this video.
Trending topic
trendingTopic
Optional
Topic hub that produced this row when includeTrending is on (gaming, sports, news, …).
Source
source
Required
Input or collection category that produced the row, such as search, channel, detail, or comments.
Detail source
detailSource
Optional
Metadata source label when available.
Scraped at
scrapedAt
Required
UTC timestamp when the row was scraped.
Record version
recordVersion
Optional
Dataset record schema version emitted by the Actor.
Enrichment level
enrichmentLevel
Optional
Enrichment level applied to the row, such as base, detail, or transcript.
Transcript segments
transcript
Optional
Available caption segments with text, start time, and duration in seconds. At most 50 segments are retained; transcriptSegmentCount records the count before this limit.
Transcript language
transcriptLanguage
Optional
Language code for the transcript that was actually returned.
Transcript text
transcriptText
Optional
Joined caption text, initially limited to 100,000 characters. The row-size limit can shorten it further.
Like count
likeCount
Optional
Like count exposed by YouTube for the video or comment.
Like status
likeStatus
Optional
Like button state when present.
View count (exact)
viewCountExact
Optional
Numeric video view count when exposed by YouTube.
Comment count (best effort)
commentCountExact
Optional
Video comment count when exposed by YouTube. This field may be absent even when comments exist.
Comment count
commentCount
Optional
Refreshed video comment count when includeUpdatedMetadata returns it. Kept separately from commentCountExact and commentCountEstimated.
Subscriber count
subscriberCount
Optional
Channel subscriber count parsed to integer.
Subscriber count text
subscriberCountText
Optional
Raw subscriber count label e.g. 4.54M subscribers.
Chapters
chapters
Optional
Video chapters [{title,startMs,thumbnailUrl}].
Heatmap
heatmap
Optional
Retention heatmap markers [{startMs,durationMs,intensity}].
Topics
topics
Optional
Topic labels associated with the video, when available.
Description (rich)
descriptionRich
Optional
Expanded video description with links and timestamps when available.
Structured description
structuredDescription
Optional
Whether YouTube provided a structured description for the video.
Cards
cards
Optional
In-video info cards [{teaser,startMs}].
End screen
endscreen
Optional
End-screen recommendations [{videoId,title}].
Transcript search index
transcriptSearchIndex
Optional
Searchable transcript panel data.
Formats
formats
Optional
Available video and audio format information, such as quality, dimensions, bitrate, and media references. A format entry does not guarantee a usable download URL.
Format availability reason
formatsGate
Optional
Reason format information was unavailable, such as login_required or unplayable, when reported by YouTube.
Playability status
playabilityStatus
Optional
YouTube playback status and reason when the video could not be played.
Storyboards
storyboards
Optional
Available thumbnail-grid information for previewing positions in a video.
Playback tracking
playbackTracking
Optional
Playback tracking metadata supplied by YouTube when available.
Player config
playerConfig
Optional
Playback configuration supplied by YouTube when available.
Updated metadata
updatedMetadata
Optional
Refreshed video metrics when includeUpdatedMetadata is enabled. Available counts also update the row's existing values.
Comments diagnostics
commentsDiagnostics
Optional
Comment collection information when present, including counts, sorting, truncation, and errors.
Row truncated fields
rowTruncatedFields
Optional
Field names trimmed or dropped to keep the row under the size cap.
Row oversize reduced
rowOversizeReduced
Optional
True when a row exceeded 250,000 bytes and was reduced to smaller fields.
Channel handle
handle
Optional
@handle on channel rows (includeChannelAbout).
Canonical URL
canonicalUrl
Optional
Canonical channel URL on channel rows.
Vanity channel URL
vanityChannelUrl
Optional
Vanity /custom URL on channel rows.
Joined date
joinedDate
Optional
Channel join date in ISO form when about-page parsing yields it.
Joined date text
joinedDateText
Optional
Raw 'Joined Mon D, YYYY' label from the about panel.
Joined text
joinedText
Optional
Alias of joinedDateText kept for backwards compatibility.
Channel country
country
Optional
Country label from the channel about panel.
Channel links
links
Optional
Outbound links on the channel about panel [{title, url}].
Channel total views
totalViews
Optional
Channel-level lifetime views parsed from the about panel.
Channel video count
videoCount
Optional
Channel video count parsed from the about panel.
Channel video count text
videoCountText
Optional
Raw video count label such as '1,007 videos'.
Channel view count text
viewCountText
Optional
Raw total views label on channel rows.
Resolved channel ID
resolvedChannelId
Optional
Channel ID resolved via includeResolveHandle.
Resolved canonical URL
resolvedCanonicalUrl
Optional
Canonical channel URL resolved via includeResolveHandle.
Resolved handle
resolvedHandle
Optional
@handle resolved via includeResolveHandle.
Comment entity key
entityKey
Optional
YouTube identifier associated with the comment, when available.
Pinned text
pinnedText
Optional
Pinned-comment badge label when present.
Keywords count
keywordsCount
Optional
Number of keywords entries before the list is limited to 50 entries.
Available countries count
availableCountriesCount
Optional
Number of availableCountries entries before the list is limited to 50 entries.
Chapters count
chaptersCount
Optional
Number of chapters entries before the list is limited to 50 entries.
Heatmap count
heatmapCount
Optional
Number of heatmap entries before the list is limited to 50 entries.
Topics count
topicsCount
Optional
Number of topics entries before the list is limited to 50 entries.
Cards count
cardsCount
Optional
Number of cards entries before the list is limited to 50 entries.
Endscreen count
endscreenCount
Optional
Number of endscreen entries before the list is limited to 50 entries.
Transcript search index count
transcriptSearchIndexCount
Optional
Number of transcriptSearchIndex entries before the list is limited to 50 entries.
Formats count
formatsCount
Optional
Number of formats entries before the list is limited to 50 entries.
Storyboards count
storyboardsCount
Optional
Number of storyboards entries before the list is limited to 50 entries.
Transcript segment count
transcriptSegmentCount
Optional
Number of transcript entries before the list is limited to 50 entries.
Links count
linksCount
Optional
Number of links entries before the list is limited to 50 entries.
Comments
comments
Optional
Nested comments retained for compatibility with older output. Current runs write comments and replies as separate rows.