Youtube Search Scraper

Search YouTube for videos, channels, playlists, and more with advanced filtering options.

Use Cases

• Content Discovery: Find videos by keywords
• Competitor Analysis: Research competing channels
• Trend Research: Identify trending topics
• Channel Discovery: Find relevant channels
• Playlist Curation: Discover playlist collections
• Market Research: Analyze content landscape

Input Parameters

Field	Type	Required	Description	Example	Default
type	string	Yes	Scraper type	search	-
searchQuery	string	Yes	Search keywords	cat videos	-
searchType	string	No	Type filter	video	video
sortBy	string	No	Sort order	relevance	relevance
duration	string	No	Duration filter	short	-
uploadDate	string	No	Upload date filter	week	-
features	string	No	Feature filters (comma-separated)	HD,subtitles	-
maxItem	number	No	Max results	50	100
resumeToken	string	No	Continue from previous search	-	-
geo	string	No	ISO 3166-2 country code	US	US
lang	string	No	Language code	en	en

Search Type Options

• video: Search for videos (default)
• channel: Search for channels
• playlist: Search for playlists
• movie: Search for movies
• show: Search for TV shows
• shorts: Search for YouTube Shorts

Sort Options

• relevance (default): Most relevant results
• rating: Highest rated content
• date: Most recent uploads
• views: Most viewed content

Duration Filters

• short: Videos under 4 minutes
• medium: Videos 4-20 minutes
• long: Videos over 20 minutes

Upload Date Filters

• hour: Last hour
• today: Last 24 hours
• week: Last 7 days
• month: Last 30 days
• year: Last 12 months

Feature Filters (comma-separated)

• HD: High definition videos
• subtitles: Videos with captions
• CCommons: Creative Commons licensed
• 3D: 3D videos
• Live: Live streams
• Purchased: Paid content
• 4K: 4K resolution
• 360: 360° videos
• Location: Videos with location
• HDR: HDR videos
• VR180: VR180 format

Example Input - Basic Search

{
  "type": "search",
  "searchQuery": "cat videos",
  "searchType": "video",
  "maxItem": 50
}

Example Input - Advanced Search

{
  "type": "search",
  "searchQuery": "machine learning tutorial",
  "searchType": "video",
  "sortBy": "views",
  "duration": "long",
  "uploadDate": "year",
  "features": "HD,subtitles",
  "maxItem": 100,
  "geo": "US",
  "lang": "en"
}

Output Schema

Video Result Object

{
  "type": "video",
  "videoId": "dQw4w9WgXcQ",
  "title": "Never Gonna Give You Up",
  "thumbnails": [...],
  "channel": {
    "id": "UCuAXFkgsw1L7xaCfnd5JJOw",
    "name": "Rick Astley",
    "thumbnails": [...]
  },
  "duration": "213",
  "viewCount": "1234567890",
  "publishedTimeText": "14 years ago",
  "badges": ["CC"]
}

Channel Result Object

{
  "type": "channel",
  "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
  "name": "Rick Astley",
  "handle": "@RickAstley",
  "thumbnails": [...],
  "subscriberCount": "5.2M subscribers",
  "videoCount": "234 videos",
  "description": "Official channel..."
}

Playlist Result Object

{
  "type": "playlist",
  "playlistId": "PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf",
  "title": "Machine Learning Course",
  "channel": {
    "id": "UCxxx...",
    "name": "Stanford University"
  },
  "videoCount": 42,
  "thumbnails": [...]
}

Notes

• Free tier limited to 100 results
• Results include mixed content types when using general search
• Pagination automatically continues until maxItem
• Some filters may limit result availability
• Shorts require specific search type for best results