YouTube Search Scraper
Pricing
Pay per usage
Fast YouTube search scraper. Pass any query (or list) and extract every matching video with full metadata. Filters: upload date, duration, sort, type, features (HD/4K/CC/Live). Optional channel scoping. Direct InnerTube API, no browser. PPE pricing.
Result type
type
Required
video, channel, playlist, or warning (emitted when a query legitimately returned zero results).
Search query
query
Required
Free-text query that produced this row.
Rank within query
resultRank
Required
1-based rank within the search results for this query (post-filter).
Video ID
videoId
Optional
11-character YouTube video ID. Present for type=video.
Video URL
url
Optional
Canonical https://www.youtube.com/watch?v=... URL.
Title
title
Optional
Title of the video, channel, or playlist.
Title accessibility label
titleAccessibility
Optional
Accessibility label, often combining title and duration.
Description snippet
description
Optional
Short description preview as shown on the search results page (about 150 characters). Full description requires a follow-up player API call.
Channel display name
channelTitle
Optional
Display name of the uploader's channel.
Channel ID
channelId
Optional
Canonical UC... channel ID of the uploader (or the channel itself for type=channel).
Channel handle
channelHandle
Optional
Canonical @handle of the uploader's channel.
Channel URL
channelUrl
Optional
Full URL of the uploader's channel.
Channel verified
channelIsVerified
Optional
True if the uploader's channel carries a verified badge.
Collaborator channel IDs
collaboratorChannelIds
Optional
For collab videos with two or more uploaders, the full list of collaborator UC... channel IDs. channelId points at the first/primary collaborator; this array carries the rest.
Channel badges
channelBadges
Optional
All channel-level badges (Verified, Artist, etc.) as plain strings.
Channel avatar
channelAvatar
Optional
Channel avatar image at multiple sizes.
Exact view count
viewCount
Optional
Exact integer view count. May be null for live streams and premieres.
View count text
viewCountText
Optional
Raw exact view count text as rendered, for example "6,806,504 views".
Short view count text
shortViewCountText
Optional
Abbreviated view count, for example "6.8M views".
Published (relative)
publishedTimeText
Optional
Relative timestamp as YouTube renders it, for example "2 years ago".
Published (approx ISO date)
publishedDateApprox
Optional
Best-effort absolute date computed from the relative timestamp and the run time. Day-level precision at best.
Duration text
lengthText
Optional
Duration as shown, for example "13:51". Absent for live streams.
Duration (seconds)
lengthSeconds
Optional
Duration in seconds. Absent for live streams.
Live now
isLive
Optional
True if the video is currently streaming live.
Video badges
badges
Optional
Video-level badges (4K, CC, LIVE NOW, New, etc.) as plain strings.
Thumbnails
thumbnails
Optional
Multiple resolutions of the static thumbnail.
Animated thumbnails
richThumbnails
Optional
Hover-preview animation frames or webm URLs.
Playlist ID
playlistId
Optional
Playlist ID. Present only for type=playlist rows.
Video count
videoCount
Optional
Number of videos in a playlist or channel.
Video count text
videoCountText
Optional
Raw text form of videoCount.
Subscriber count (approx)
subscriberCount
Optional
Best-effort integer subscriber count derived from abbreviated text, for type=channel rows.
Subscriber count text
subscriberCountText
Optional
Raw abbreviated subscriber count, for example "21M subscribers".
Verified (channel rows)
isVerified
Optional
Verified badge present on a type=channel row.
