YouTube Search Scraper 🔍

Search YouTube by keyword with every filter the platform offers — and get back videos, Shorts and live streams enriched with exact publish dates, likes, comments, durations and channel stats. Clean structured JSON, ready for analysis.

✨ What you get

One record per result:

Field	Description
videoId / url / title / thumbnail	The result itself
type	video, short or stream
description / hashtags	Full description + extracted hashtags
publishedAt / publishedTimeText	Exact ISO timestamp + YouTube's "3 days ago"
views / likes / commentsCount	Engagement as real numbers
duration / durationSeconds	00:22:51 and 1371
isLive / streamType	live, ended, upcoming or null
category / badges / isFamilySafe / commentsTurnedOff	Content flags
channelName / channelId / channelUrl / channelHandle / channelAvatar / channelSubscribers	Full channel info
position / searchTerm / searchUrl / scrapedAt	Provenance

⚙️ Options

• Search terms — any number of keywords; each gets its own result quota.
• Per-type limits — separate maximums for videos, Shorts and live streams.
• Filters — exactly like youtube.com's filter panel: sorting order (Relevance / Rating / Upload date / View count), date filter (last hour → this year), type (video / channel / playlist / movie), length (under 4 / 4–20 / over 20 minutes) and feature toggles (HD, Subtitles/CC, Creative Commons, 3D, Live, Purchased, 4K, 360°, Location, HDR, VR180).
• Localization — country and language codes for region-specific results.

🚀 Example

Input:

{
    "searchTerms": ["world cup 2026"],
    "maxVideosPerTerm": 5,
    "maxShortsPerTerm": 5,
    "maxStreamsPerTerm": 5,
    "addFilters": true,
    "sortingOrder": "viewCount",
    "dateFilter": "week"
}

One record from the output:

{
    "videoId": "J5UtYIOm4Xg",
    "type": "video",
    "title": "2026 FIFA World Cup Group Stage Preview: Predictions + Picks to Advance 🏆",
    "url": "https://www.youtube.com/watch?v=J5UtYIOm4Xg",
    "publishedAt": "2026-06-09T17:20:56.000Z",
    "publishedTimeText": "21 hours ago",
    "views": 19763,
    "likes": 239,
    "duration": "00:22:51",
    "durationSeconds": 1371,
    "channelName": "CBS Sports",
    "channelHandle": "@CBSSports",
    "channelSubscribers": 1200000,
    "position": 1,
    "searchTerm": "world cup 2026",
    "scrapedAt": "2026-06-10T02:45:04.000Z"
}

💡 Use cases

• Market research — map who ranks for the keywords in your niche.
• Trend monitoring — track fresh uploads on any topic with date filters.
• SEO for video — analyze titles, lengths and engagement of top-ranking content.
• Live coverage — find active streams for any event, as it happens.

💳 Pricing

You pay per result scraped — no subscriptions, no hidden compute costs.

❓ FAQ

Why did I get 0 streams? Streams are only returned while something is actually live for your query — 0 is a correct answer, not an error.

Are the dates exact? Yes — every result is enriched to the exact second of publication, not just "3 weeks ago".

Do filters combine? Yes, exactly like on youtube.com — e.g. "this week" + "under 4 minutes" + 4K all at once.