🎥 YouTube Video Crawler

An Actor that helps you crawl video information from YouTube based on hashtags or keywords, using YouTube Data API v3.

✨ Features

• 🔍 Search videos by hashtags or keywords
• 🏷️ Filter results using specific keywords in title and description
• 📊 Collect detailed information about each video:
  • 📝 Title and description
  • 🖼️ Thumbnail images (multiple sizes)
  • 🆔 Video ID and URL
  • 📅 Published date
  • 👀 View count
  • 👍 Like count
  • 💬 Comment count
• ⚙️ Configurable search options:
  • Search in video titles
  • Search in video descriptions
  • Limit number of results per query

📥 Input

The Actor accepts the following input parameters:

{
    "queries": ["#trending", "funny cats"],     // Required: List of hashtags or keywords to search
    "keywords": ["cute", "amazing"],            // Optional: Keywords to filter results
    "maxResults": 50,                          // Optional: Maximum videos per query (default: 50)
    "searchInTitle": true,                     // Optional: Search keywords in titles (default: true)
    "searchInDescription": false               // Optional: Search keywords in descriptions (default: false)
}

📤 Output

Each video will be returned as a separate item with the following structure:

{
    "query": "#trending",                      // Original search query
    "video": {
        "title": "Video title",
        "description": "Video description",
        "defaultThumbnail": "High quality thumbnail URL",
        "videoId": "Video ID",
        "videoUrl": "https://www.youtube.com/watch?v=...",
        "publishedAt": "2024-01-01T00:00:00Z",
        "statistics": {
            "viewCount": 1234,
            "likeCount": 123,
            "commentCount": 12
        }
    },
    "matchedKeywords": ["cute", "amazing"]     // Keywords found in title/description
}

📝 Notes

• 🔑 YouTube API Key is required and must be set in environment variables
• ⚠️ YouTube API has quota limits:
  • Each search request costs 100 units
  • Getting video details costs 1 unit per video
• 🚫 Some videos may have restricted statistics
• ✅ The Actor handles errors gracefully and continues processing

💡 Usage Examples

1. Basic search with hashtags:

{
    "queries": ["#shorts", "#trending"],
    "maxResults": 10
}

2. Search with keyword filtering:

{
    "queries": ["funny cats", "cute puppies"],
    "keywords": ["adorable", "hilarious"],
    "maxResults": 20,
    "searchInTitle": true,
    "searchInDescription": true
}

3. Search in specific content:

{
    "queries": ["cooking recipes"],
    "keywords": ["easy", "quick"],
    "searchInTitle": true,
    "searchInDescription": false,
    "maxResults": 50
}

📊 Output Table

The results are displayed in a table with the following columns:

• 🔍 Search Query
• 📝 Title
• 🆔 Video ID
• 🔗 Video URL
• 🖼️ Thumbnail
• 📄 Description
• 📅 Published At
• 👀 Views
• 👍 Likes
• 💬 Comments
• 🏷️ Matched Keywords