YouTube Search Scraper — All Filters, Numeric Views & Length

Scrape YouTube search results for any keyword into JSON, CSV or Excel, using the same filters as YouTube's own filter menu, and get numbers you can sort and chart right away: viewCount as an integer, durationSeconds, and an approximate publish date.

No YouTube Data API key, no quota.

Choose this Actor when you need filtered keyword research at scale — for example "videos uploaded this week, 4–20 minutes long, with subtitles, sorted by views" — and want clean numeric columns instead of text like "1.2M views".

Not the right fit when you need channel search, playlists, comments or full video details (likes, tags, full description, transcript): this Actor returns search-result rows only.

Use cases

• YouTube SEO and keyword research — who ranks for a keyword, their views and video length.
• Trend tracking — daily runs sorted by upload date to catch new videos on a topic.
• Influencer discovery — channels publishing in a niche, with verified badges and view counts.
• Content gap research — popular topics with few recent long-form videos.
• Data and AI pipelines — feed fresh video URLs into transcript, summarization or sentiment tools.

Filters

Input	Values
sortBy	relevance, upload_date, view_count, rating
uploadDate	hour, today, week, month, year
duration	short (< 4 min), medium (4–20 min), long (> 20 min)
features	live, 4k, hd, hdr, subtitles, creativeCommons
includeShorts	Also return Shorts (ignored when a date, duration or feature filter is set)
country, language	Localize results, e.g. US / en, TW / zh-TW
maxResultsPerQuery	Default 50; YouTube usually serves up to about 500–600 per search

Input example

{
  "queries": ["n8n tutorial", "claude code"],
  "maxResultsPerQuery": 100,
  "sortBy": "upload_date",
  "uploadDate": "week",
  "duration": "medium",
  "features": ["subtitles"],
  "country": "US",
  "language": "en"
}

Output example (one video)

{
  "type": "video",
  "title": "n8n Tutorial – Zero to Hero Course",
  "url": "https://www.youtube.com/watch?v=UIf-SlmMays",
  "videoId": "UIf-SlmMays",
  "channelName": "freeCodeCamp.org",
  "channelId": "UC8butISFwT-Wl7EV0hUK0BQ",
  "channelUrl": "https://www.youtube.com/@freecodecamp",
  "channelVerified": true,
  "viewCount": 991118,
  "viewCountText": "991,118 views",
  "durationSeconds": 12908,
  "duration": "3:35:08",
  "publishedDateApprox": "2025-12-16",
  "publishedTimeText": "9 months ago",
  "isLive": false,
  "badges": ["4K", "CC"],
  "descriptionSnippet": "…",
  "thumbnailUrl": "https://i.ytimg.com/…",
  "query": "n8n tutorial",
  "rank": 1,
  "page": 1,
  "fetchedAt": "2026-09-16T15:48:34Z"
}

Pricing

$1.50 per 1,000 results.

Queries that fail are never charged. Platform usage is included. Example: 5,000 results = $7.50. Set a maximum cost per run for a hard cap.

FAQ

How many results per query? YouTube typically serves up to about 500–600 videos per search. Use filters or several related queries to go deeper.

Why is the publish date approximate? Search results only show relative times ("3 weeks ago"). The Actor converts them to a date — exact for recent videos, approximate for older ones.

Do I need a YouTube API key? No, and there is no daily quota.

Can I get Shorts? Yes — turn on includeShorts; Shorts rows have type: "short".

Which language should I use? Keep en if you rely on publishedDateApprox and viewCount: the relative-time and count text is parsed for English.

Is it legal? It collects publicly visible search results and no personal data beyond public channel names. You are responsible for using the data in line with applicable laws and YouTube's terms.

Need a feature? Open an issue on the Issues tab — include your run ID.