🎥 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:

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

📤 Output

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

1{
2    "query": "#trending",                      // Original search query
3    "video": {
4        "title": "Video title",
5        "description": "Video description",
6        "defaultThumbnail": "High quality thumbnail URL",
7        "videoId": "Video ID",
8        "videoUrl": "https://www.youtube.com/watch?v=...",
9        "publishedAt": "2024-01-01T00:00:00Z",
10        "statistics": {
11            "viewCount": 1234,
12            "likeCount": 123,
13            "commentCount": 12
14        }
15    },
16    "matchedKeywords": ["cute", "amazing"]     // Keywords found in title/description
17}

📝 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:

1{
2    "queries": ["#shorts", "#trending"],
3    "maxResults": 10
4}

2. Search with keyword filtering:

1{
2    "queries": ["funny cats", "cute puppies"],
3    "keywords": ["adorable", "hilarious"],
4    "maxResults": 20,
5    "searchInTitle": true,
6    "searchInDescription": true
7}

3. Search in specific content:

1{
2    "queries": ["cooking recipes"],
3    "keywords": ["easy", "quick"],
4    "searchInTitle": true,
5    "searchInDescription": false,
6    "maxResults": 50
7}

📊 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