YouTube Scraper - Most Comprehensive
Pricing
from $0.04 / 1,000 contents
🔥 ~$0.05/1K contents 🔥 Get public YouTube videos, channels, playlists, podcasts, courses, Posts, clips, comments, captions, and live chat.
Record type
type
Required
Record ID
recordId
Required
Stable identity used to remove duplicate records within a run.
Source
source
Required
Input target or search query that produced this record.
Collection time
scrapedAt
Required
UTC time when the Actor prepared this record.
Schema version
schemaVersion
Required
Partial result
partial
Optional
True when the source was only partly collected.
Partial result reason
partialReason
Optional
Reason code when the source was only partly collected.
Video ID
videoId
Optional
YouTube URL
url
Optional
Title
title
Optional
Detail level
detailLevel
Optional
Identifies a discovery result or a full video, channel, or collection record.
Channel ID
channelId
Optional
Playlist ID
playlistId
Optional
Playlist position
position
Optional
Position of this entry in its playlist.
Comment ID
commentId
Optional
Parent comment ID
parentCommentId
Optional
Null for a top-level comment. Replies identify their parent comment.
Text
text
Optional
Comment, post, or chat text. Description alias for video and playlist-entry rows. Missing source text is null.
Output language
language
Optional
Caption text
fullText
Optional
Complete caption text. Null when a large caption moves to transcriptKey.
Caption segments
segments
Optional
Timed caption segments. Null when a large caption moves to transcriptKey.
Transcript file
transcriptUrl
Optional
URL of a large transcript in the key-value store. Local runs can return null.
Transcript storage key
transcriptKey
Optional
Key of a large transcript in the run's key-value store.
Video content type
contentType
Optional
Video content type from a discovery result, direct URL, or stream status. Shorts and streams still have record type video.
Description
description
Optional
Channel name
name
Optional
Video channel name
channelName
Optional
Channel URL
channelUrl
Optional
Channel username
channelUsername
Optional
Exact video channel subscriber count
numberOfSubscribers
Optional
Exact channel subscriber count
subscriberCount
Optional
Subscriber count as displayed
subscriberCountText
Optional
Exact channel video count
videoCount
Optional
Video count as displayed
videoCountText
Optional
Exact view count
viewCount
Optional
View count as displayed
viewCountText
Optional
Exact like count
likeCount
Optional
Like count as displayed
likeCountText
Optional
Exact comment count
commentCount
Optional
Comment count as displayed
commentCountText
Optional
Comments disabled
commentsDisabled
Optional
Comments disabled alias
commentsTurnedOff
Optional
Publication date
publishedAt
Optional
Exact source date when available. List rows can omit this field.
Publication date alias
date
Optional
Publication time as displayed
publishedTimeText
Optional
Duration in seconds
durationSeconds
Optional
Duration
duration
Optional
Duration as hours:minutes:seconds.
Category
category
Optional
Thumbnail URL
thumbnailUrl
Optional
Stream status
streamType
Optional
Scheduled start time
scheduledStartTime
Optional
Live now
isLive
Optional
Live content
isLiveContent
Optional
Upcoming video
isUpcoming
Optional
Members only
isMembersOnly
Optional
YouTube playability status
playabilityStatus
Optional
Public playback available
playbackAvailable
Optional
Published location
location
Optional
Chapters
chapters
Optional
Source chapter markers. Times use milliseconds. The final end time can be null.
Music credits
musicTracks
Optional
Credits shown by YouTube. Missing credit fields can be null.
Description destinations
descriptionLinks
Optional
Detail and caption errors
enrichmentErrors
Optional
Safe error codes for optional work that failed. The base row can still be saved.
Requested native caption language
requestedLanguage
Optional
Original caption language
sourceLanguage
Optional
Language of the original YouTube caption track.
Automatic YouTube captions
isAutoGenerated
Optional
True for a YouTube automatic caption track.
Translated native captions
isTranslated
Optional
Subtitle format
format
Optional
Formatted subtitle text
formattedText
Optional
Null when a large caption moves to key-value storage.
Subtitle file key
subtitleKey
Optional
Subtitle file URL
subtitleUrl
Optional
Cloud URL for the formatted file. Null in local storage.
SRT file URL
srtUrl
Optional
Present for this saved subtitle format. Null in local storage.
VTT file URL
vttUrl
Optional
Present for this saved subtitle format. Null in local storage.
XML file URL
xmlUrl
Optional
Present for this saved subtitle format. Null in local storage.
TXT file URL
txtUrl
Optional
Present for this saved subtitle format. Null in local storage.
Attached captions
subtitles
Optional
Caption objects attached to a video or playlist entry. These are not separate dataset rows.
Video ID alias
id
Optional
Input source alias
input
Optional
Input YouTube URL
fromYTUrl
Optional
The input URL, or null when the input was an ID or search term.
Playlist position alias
order
Optional
Position for a playlist entry; otherwise null.
Video like count alias
likes
Optional
Channel video count
channelTotalVideos
Optional
Channel description
channelDescription
Optional
Channel country
channelLocation
Optional
Channel joined date
channelJoinedDate
Optional
Source date or display text. This is not guaranteed to be an ISO date.
Channel view count
channelTotalViews
Optional
Channel banner URL
channelBannerUrl
Optional
Channel avatar URL
channelAvatarUrl
Optional
Collaborators
collaborators
Optional
Null when YouTube exposes no collaborator dialog. Otherwise the source collaborator entries.
Verified channel
isChannelVerified
Optional
True when explicit source evidence is present; otherwise null.
Paid content
isPaidContent
Optional
True when explicit source evidence is present; otherwise null.
Age restriction
isAgeRestricted
Optional
True when explicit source evidence is present; otherwise null. Separate from isFamilySafe.
Monetization status
isMonetized
Optional
No reliable public signal is used. This field remains null.
Localized source title
translatedTitle
Optional
Localized title supplied by YouTube. Can match the original. Does not request translation.
Localized source description
translatedText
Optional
Localized description supplied by YouTube. Can match the original. Does not request translation.
Available caption tracks
availableLanguages
Optional
Available translation languages
translationLanguages
Optional
Video channel
channel
Optional
Caption segment count
count
Optional
Number of segments in this native caption result.
Thumbnails
thumbnails
Optional
Images supplied by YouTube. Dimensions can be null.
Estimated search result count
estimatedResultCount
Optional
Query estimate reported by YouTube before local result filters. This is not the saved row count.
Replay heat map
heatMap
Optional
Replay data supplied by YouTube, or null when absent.
Storyboard images
storyboards
Optional
Source storyboard levels and sprite URLs. URLs can expire.
End-screen elements
endscreen
Optional
Elements shown at the end of the video, when YouTube supplies them.
Playlist update text
lastUpdatedText
Optional
Playlist metadata
playlist
Optional
Playlist metadata attached to an entry. Collected totals describe this source collection, not the whole playlist.
Collection type
collectionType
Optional
Preview video IDs
previewVideoIds
Optional
Video IDs explicitly included in the collection card.
Collection source channel ID
sourceChannelId
Optional
Collection source channel name
sourceChannelName
Optional
Description excerpt
descriptionSnippet
Optional
Channel handle
handle
Optional
Channel handle URL
vanityUrl
Optional
Channel image
avatarUrl
Optional
Verified channel
isVerified
Optional
True when source badge data explicitly identifies verification; otherwise null.
Available channel tabs
tabs
Optional
Only tabs returned by YouTube are listed.
Links
links
Optional
Channel destination links or explicit rich-text command links. Fields depend on record type.
Videos tab URL
videosUrl
Optional
Shorts tab URL
shortsUrl
Optional
Streams tab URL
streamsUrl
Optional
Playlists tab URL
playlistsUrl
Optional
Podcasts tab URL
podcastsUrl
Optional
Courses tab URL
coursesUrl
Optional
Post ID
postId
Optional
Sponsor badge image
sponsorBadgeUrl
Optional
Sponsor badge label
sponsorBadgeText
Optional
Creator image
creatorAvatarUrl
Optional
Accessible like count
likeCountAccessibilityText
Optional
Accessible comment count
commentCountAccessibilityText
Optional
Exact reply count
replyCount
Optional
Reply count display
replyCountText
Optional
Short reply count display
replyCountDisplayText
Optional
Source reply level
replyLevel
Optional
Creator heart
isHeartedByCreator
Optional
Joined to the comment toolbar state by its source key. Unknown state is null.
Artist flag
isArtist
Optional
Explicit source boolean.
Edited label
isEdited
Optional
Identifies an edited marker in the English source publication display; it is not an edit timestamp.
Pinned comment
isPinned
Optional
Creator comment
isCreator
Optional
Post text runs
textRuns
Optional
Post images
images
Optional
Keeps the source gallery order.
Attached post video
video
Optional
Source post attachment types
attachmentTypes
Optional
Comment style ranges
styleRuns
Optional
Comment attachments
attachments
Optional
Chat message ID
messageId
Optional
Source message ID. Null when the event has no message ID.
Chat event type
eventType
Optional
Normalized type for known events. Other events use their source renderer or action name.
Source chat event type
sourceEventType
Optional
Original YouTube renderer name for a renderer event, or action name for another event. Kept when fields are selected.
Source chat event
rawEvent
Optional
Original leaf YouTube action object. Replay wrappers are excluded; replayOffsetMs stores the replay offset. Included by default, or when selected in fields.
Deleted chat item
isDeleted
Optional
Updated chat item
isUpdated
Optional
Chat replay
isReplay
Optional
Replay offset milliseconds
replayOffsetMs
Optional
Chat UTC timestamp
timestamp
Optional
Source timestamp microseconds
timestampUsec
Optional
Chat timestamp display
timestampText
Optional
Paid chat amount
amountText
Optional
Keeps the source amount and currency display.
Membership message
membershipText
Optional
Paid sticker image
stickerUrl
Optional
Source badges
badges
Optional
Post poll
poll
Optional
Anonymous responses can omit choice results. Percentages are not inferred.
Post quiz
quiz
Optional
Correct answers and explanations are returned only when explicitly supplied.
Playback formats
formats
Optional
Playback format metadata without media URLs or signature data.
Audio tracks
audioTracks
Optional
Explicit source audio tracks. Missing languages and flags are null.
allowRatings
allowRatings
Optional
isCrawlable
isCrawlable
Optional
isPrivate
isPrivate
Optional
isTvfilmVideo
isTvfilmVideo
Optional
isEmbeddable
isEmbeddable
Optional
isLowLatencyLiveStream
isLowLatencyLiveStream
Optional
isPostLiveDvr
isPostLiveDvr
Optional
uploadDate
uploadDate
Optional
latencyClass
latencyClass
Optional
Concurrent viewers
concurrentViewers
Optional
Explicit concurrent viewers, when the source provides them.
Source attribution links
sourceLinks
Optional
Explicit source attribution endpoints.
Recommendation source video
sourceVideoId
Optional
Recommendation rank
recommendationRank
Optional
One-based position in this source video’s returned recommendations.
Clip ID
clipId
Optional
Source video URL
sourceVideoUrl
Optional
Clip start milliseconds
startMs
Optional
Clip end milliseconds
endMs
Optional
Clip duration milliseconds
durationMs
Optional
Clip creator
creatorName
Optional
Clip creator channel
creatorChannelId
Optional
Clip creator URL
creatorUrl
Optional
Clip creation display
createdText
Optional
isFamilySafe
isFamilySafe
Optional
isUnlisted
isUnlisted
Optional
isShortsEligible
isShortsEligible
Optional
Available country codes
availableCountries
Optional
joinedAt
joinedAt
Optional
joinedDateText
joinedDateText
Optional
country
country
Optional
keywordsText
keywordsText
Optional
rssUrl
rssUrl
Optional
Comment count alias
commentsCount
Optional