🎥 YouTube Video Search Scraper

A powerful tool for searching and extracting YouTube videos with detailed metadata! This actor helps you gather comprehensive information about videos matching your search criteria, including titles, descriptions, channel details, and direct URLs.

✨ Key Features

• 🔍 Search YouTube videos with customizable parameters
• 📊 Get detailed video metadata including:
  • Video title, description, and thumbnails
  • Channel information and statistics
  • View counts and engagement metrics
  • Upload date and duration
• 🔗 Generate direct URLs for:
  • Videos
  • Channels
• 📈 Support for large result sets with automatic pagination
• 🌐 Language and region customization
• 📋 Clean and structured JSON output

💪 Why Choose This Actor?

• Comprehensive: Get all video details from search results
• Flexible: Support for multiple search parameters
• Efficient: Automatic pagination for large result sets
• Structured: Clean JSON output for easy integration
• Reliable: Stable and consistent data extraction
• User-Friendly: Simple input parameters

🎯 Perfect For

• 📊 Content Researchers
• 📈 Marketing Analysts
• 🎥 Video Content Creators
• 📱 Social Media Managers
• 🔍 Competitor Analysts
• 📋 Market Researchers

📈 Use Cases

1. Content Research: Find relevant videos for your topic
2. Competitor Analysis: Monitor competitor's video content
3. Content Discovery: Find trending videos in your niche
4. Market Research: Study video trends and patterns
5. SEO Research: Analyze video performance and engagement

📝 Input Requirements

The actor accepts the following input parameters:

• q (required): The search query string
• maxResults (optional): Maximum number of videos to extract (default: 30)
• hl (optional): Language code for results (default: 'en')
• gl (optional): Region code for results (default: 'US')
• cursor (optional): Pagination cursor for next page of results

📊 Output

The actor returns a structured JSON response containing:

• Video details including:
  • Basic information (title, description, thumbnails)
  • Channel information
  • Statistics (views, engagement)
  • URLs (video, channel)
  • Timestamps (scrape date)

Input Example

{
  "q": "artificial intelligence tutorial",
  "maxResults": 30,
  "hl": "en",
  "gl": "US"
}

Output Example

[
    {
      "type": "video",
      "video": {
        "author": {
          "avatar": [
            {
              "height": 68,
              "url": "https://yt3.ggpht.com/-emOj0f0OSKEx5JFJSJ0yIdE4DOBU3hew2RQDcW2rHAOGt-vt_UuziCfhDhtYVCAr_SCY-geLDI=s68-c-k-c0x00ffffff-no-rj",
              "width": 68
            }
          ],
          "badges": [],
          "canonicalBaseUrl": "/@universeunfold",
          "channelId": "UCnA_F8bRf9VA7wXO-ctBLOw",
          "title": "Universe Unfold"
        },
        "badges": [],
        "descriptionSnippet": "How does AI actually work? Is it just math and data, or is it something more? In this documentary, we explore how AI learns, ...",
        "isLiveNow": false,
        "lengthSeconds": 4254,
        "movingThumbnails": [
          {
            "height": 180,
            "url": "https://i.ytimg.com/an_webp/RtQmNp5FKsk/mqdefault_6s.webp?du=3000&sqp=CLTmkMEG&rs=AOn4CLDbNj6Nf9WBEWaRarUrnrWnRo-53Q",
            "width": 320
          }
        ],
        "publishedTimeText": "2 months ago",
        "stats": {
          "views": 133170
        },
        "thumbnails": [
          {
            "height": 202,
            "url": "https://i.ytimg.com/vi/RtQmNp5FKsk/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBXBsB2g1wFdRSF37Nc2hmg_HvVwA",
            "width": 360
          },
          {
            "height": 404,
            "url": "https://i.ytimg.com/vi/RtQmNp5FKsk/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLBMLLnQs7w2nnZvDqjlljHKeM2Nqg",
            "width": 720
          }
        ],
        "title": "You’re Not in Control—AI Already Runs the World. #sciencedocumentary",
        "videoId": "RtQmNp5FKsk"
      }
    },
    ...
]