YouTube Video Scraper · 5 datasets per URL
Pricing
from $0.06 / youtube video report
One video URL in, five joined datasets out: video metadata, channel profile, comments, transcript and the YouTube search results for the video's own title. One flat row per video, joined on video_id and channel_id. Switch off any section you do not need. One delivered row is one billed row.
Video ID
video_id
Required
Canonical 11-character YouTube video ID. Join key for every section of the row.
Video URL
video_url
Required
Canonical watch URL built from the video ID.
Status
status
Required
ok = every requested section delivered data; partial = at least one requested section had no data (see partial_reasons); not_found = the video does not exist.
Fetched at
fetched_at
Required
ISO timestamp of when the row was produced. A cache hit keeps the original timestamp.
Title
title
Optional
Video title. Also the query used for the YouTube search section.
Description
description
Optional
Video description as published, with HTML entities and markup decoded to plain text.
Views
views
Optional
View count of the video as an integer.
Likes
likes
Optional
Like count of the video as an integer. Large counts are rounded at the source (1.1M becomes 1100000).
Published
published_date
Optional
Publish date normalised to ISO YYYY-MM-DD, for example "2018-07-11", so it sorts and parses like channel_joined_date and fetched_at. The source alternates between "Jul 11, 2018" and "11 Jul 2018" for the same video; a label we cannot parse is passed through unchanged rather than guessed.
Duration (s)
duration_seconds
Optional
Video length in whole seconds.
Keywords
keywords
Optional
Keyword tags published with the video. Empty array when the video carries none.
Thumbnail
thumbnail
Optional
URL of the highest-resolution thumbnail published for the video.
Chapters
chapters
Optional
Chapter list as published in the structured chapter field. Frequently an empty array even for chaptered videos - the readable list is in key_moments.
Key moments
key_moments
Optional
Timeline markers of the video: {start, title}, with start as an mm:ss or h:mm:ss timestamp.
Channel ID
channel_id
Optional
Canonical UC... channel ID. Second join key of the row.
Channel handle
channel_handle
Optional
Channel handle in @name form.
Channel title
channel_title
Optional
Public display name of the channel.
Subscribers
channel_subscribers
Optional
Subscriber count of the channel as an integer.
Channel views
channel_views
Optional
Lifetime view count of the channel as an integer.
Channel videos
channel_videos_count
Optional
Number of videos published by the channel, as listed on the channel page.
Channel joined
channel_joined_date
Optional
Date the channel was created, as an ISO date.
Channel description
channel_description
Optional
About text of the channel, decoded to plain text.
Comments
comments
Optional
Top-level comments: {comment_id, author, text, likes, replies, published_date}. author is the commenter handle; published_date is the relative label shown on YouTube.
Transcript segments
transcript
Optional
Timestamped segments: {text, start, end, duration, lang} in seconds, with end = start + duration.
Transcript text
transcript_text
Optional
Full transcript as one plain-text string: entities decoded, markup and zero-width characters removed, repeated (start, text) pairs dropped.
Transcript language
transcript_language
Optional
Language of the transcript actually returned, never an echo of the requested language.
Segments
transcript_segment_count
Optional
Number of transcript segments after normalisation.
Words
transcript_word_count
Optional
Number of words in the normalised transcript text.
Search query
search_query
Optional
Query sent to YouTube search: the title of the video itself.
Search results
search_results
Optional
YouTube search results for that query: {position, video_id, title, url, channel_name, channel_handle, views, published_date, duration}.
Self rank
search_self_rank
Optional
Position of this video among the returned search results, matching the position field of that result. Null when the video is not on the returned page.
Sections included
sections_included
Required
Sections that delivered data for this row: video, channel, comments, transcript, search.
Sections skipped
sections_skipped
Required
Sections switched off in the input, plus requested sections that returned no data. Their fields are null, never an empty array.
Partial reasons
partial_reasons
Required
Why a row is partial: video_not_found, video_unavailable, channel_unavailable, comments_unavailable, transcript_unavailable, search_unavailable, fallback_budget_exceeded, channel_mismatch (the upstream channel id did not match the video owner, so channel stats were withheld rather than reported for the wrong channel). Empty on an ok row.
Source per section
source
Required
Which path answered each section: primary, fallback when the backup path answered, or null when the section produced no response at all.
Comments total
comments_total
Optional
Exact number of comments on the video. Null when the comments section is switched off.